Claude Code 插件系统
Claude Code 插件系统是一个扩展 Claude Code 功能的机制,允许开发者通过插件来增强 AI 编程助手的行为和能力。该系统支持从市场安装预制插件,也支持项目级别的自定义配置。
核心概念
插件 (Plugin)
插件是包含特定技能或行为指导的代码包,可以改进 Claude Code 在特定场景下的表现。插件通常包含编程最佳实践、代码风格指南或特定领域的专业知识。^[inbox(剪藏进来的)__SMARTclip__forrestchang-andrej-karpathy-skills- A single CLAUDE.md file to improve Claude C__e35e9215.md]
技能 (Skills)
技能是插件中的具体功能单元,定义了 Claude Code 应该遵循的特定行为模式或编程原则。例如,Karpathy 技能包含四个核心原则来改善 LLM 编程行为。^[inbox(剪藏进来的)__SMARTclip__forrestchang-andrej-karpathy-skills- A single CLAUDE.md file to improve Claude C__e35e9215.md]
安装方式
方式一:插件市场安装(推荐)
首先添加插件市场:
/plugin marketplace add forrestchang/andrej-karpathy-skills
然后安装具体插件:
/plugin install andrej-karpathy-skills@karpathy-skills
这种方式将插件安装为 Claude Code 插件,使技能在所有项目中可用。^[inbox(剪藏进来的)__SMARTclip__forrestchang-andrej-karpathy-skills- A single CLAUDE.md file to improve Claude C__e35e9215.md]
方式二:项目级 CLAUDE.md 文件
新项目中创建:
curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md
现有项目中追加:
echo "" >> CLAUDE.md
curl https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.md
典型插件示例:Karpathy 技能
解决的问题
基于 Andrej Karpathy 对 LLM 编程缺陷的观察,该插件解决以下问题:
- 模型会做出错误假设并继续执行,不检查、不澄清、不呈现权衡
- 倾向于过度复杂化代码和 API,膨胀抽象层,不清理死代码
- 有时会更改或删除它们不充分理解的注释和代码^[inbox(剪藏进来的)__SMARTclip__forrestchang-andrej-karpathy-skills- A single CLAUDE.md file to improve Claude C__e35e9215.md]
四大核心原则
| 原则 | 解决问题 |
|---|---|
| 编码前思考 | 错误假设、隐藏困惑、缺失权衡 |
| 简洁优先 | 过度复杂化、膨胀抽象 |
| 精准修改 | 正交编辑、触碰不应修改的代码 |
| 目标驱动执行 | 通过测试优先、可验证成功标准实现杠杆效应 |
实施细节
编码前思考:明确陈述假设,呈现多种解释,在合适时推回,困惑时停止并寻求澄清。^[inbox(剪藏进来的)__SMARTclip__forrestchang-andrej-karpathy-skills- A single CLAUDE.md file to improve Claude C__e35e9215.md]
简洁优先:解决问题的最少代码,不添加未请求的功能、抽象或错误处理。测试标准:资深工程师是否会认为这过于复杂?^[inbox(剪藏进来的)__SMARTclip__forrestchang-andrej-karpathy-skills- A single CLAUDE.md file to improve Claude C__e35e9215.md]
精准修改:只触碰必须修改的部分,匹配现有风格,每个更改行都应直接追溯到用户请求。^[inbox(剪藏进来的)__SMARTclip__forrestchang-andrej-karpathy-skills- A single CLAUDE.md file to improve Claude C__e35e9215.md]
目标驱动执行:将命令式任务转换为可验证目标,定义成功标准并循环直到验证通过。^[inbox(剪藏进来的)__SMARTclip__forrestchang-andrej-karpathy-skills- A single CLAUDE.md file to improve Claude C__e35e9215.md]
自定义配置
插件系统支持与项目特定指令合并。可以在现有 CLAUDE.md 中添加项目特定规则:
## 项目特定指南
- 使用 TypeScript 严格模式
- 所有 API 端点必须有测试
- 遵循 `src/utils/errors.ts` 中现有的错误处理模式
效果验证
插件正常工作的标志包括:
- diff 中不必要的更改减少
- 因过度复杂化导致的重写减少
- 实现前出现澄清问题
- 干净、最小化的 PR^[inbox(剪藏进来的)__SMARTclip__forrestchang-andrej-karpathy-skills- A single CLAUDE.md file to improve Claude C__e35e9215.md]
权衡考虑
这些指南偏向于谨慎而非速度。对于简单任务(拼写错误修复、明显的单行更改),应使用判断力,不是每个更改都需要完整的严格性。目标是减少非平凡工作中的代价高昂错误,而不是拖慢简单任务。^[inbox(剪藏进来的)__SMARTclip__forrestchang-andrej-karpathy-skills- A single CLAUDE.md file to improve Claude C__e35e9215.md]
来源
- inbox(剪藏进来的)__SMARTclip__forrestchang-andrej-karpathy-skills- A single CLAUDE.md file to improve Claude C__e35e9215.md