核心信息
Andrej Karpathy Skills 是一个单一的
CLAUDE.md文件（133k Stars），将 Andrej Karpathy 关于 LLM 编码陷阱的观察提炼为四条行为准则，用于约束 Claude Code 等 AI 编码代理的行为。
- 作者：multica-ai（@jiayuan_jy）
- Stars：133k
- Forks：13.6k
- 许可证：MIT
- 技术栈：纯 Markdown 配置，零依赖
灵感来源
来自 Andrej Karpathy 的 X 帖子，指出 LLM 编码的三大问题：
- 错误假设：模型在未验证的情况下替用户做假设
- 过度复杂：模型倾向于过度复杂化代码和 API，臃肿抽象
- 连带修改：模型作为副作用修改/删除不理解的内容
四大核心原则
1. Think Before Coding（先思考再编码）
针对”错误假设”和”隐藏的困惑”。
- 显式阐述假设
- 呈现多种解释
- 在必要时提出异议
- 困惑时停下来询问
2. Simplicity First（简洁优先）
针对”过度复杂化”和”臃肿抽象”。
- 不做超出需求的功能
- 不为一次性代码建抽象
- 不做未要求的”灵活配置”
- 不为不可能场景做错误处理
- “如果 200 行能写成 50 行，就重写”
- 评判标准：资深工程师是否会认为过于复杂？
3. Surgical Changes（精确修改）
针对”连带修改无关代码”。
- 编辑时只动必须动的部分
- 不”改进”相邻代码或注释
- 不重构未损坏的部分
- 匹配现有风格
- 只有改动产生了孤立的导入/变量/函数时，才清理自己的遗留物
4. Goal-Driven Execution（目标驱动执行）
源自 Karpathy 的核心洞察：“LLMs are exceptionally good at looping until they meet specific goals”。
- 将命令式任务转化为可验证的目标
- 例如”为无效输入写测试，然后让测试通过”而非”添加验证”
- 多步骤任务应列出计划并附带验证检查
安装方式
# Claude Code 插件市场
/plugin marketplace add forrestchang/andrej-karpathy-skills
/plugin install andrej-karpathy-skills@karpathy-skills
# 或直接下载 CLAUDE.md
curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md支持 Claude Code 和 Cursor。
设计取舍
指南偏向”谨慎优先于速度”。简单任务（如修 typo、一行改动）可酌情减少严格度。目标是减少非平凡工作的高成本错误，而非拖慢简单任务。
关联连接
- Karpathy_Skills — Karpathy Skills 项目实体
- Agent_Skills — 同为编码行为指南（Karpathy 更侧重行为约束，Agent Skills 提供工程流程）
- Superpowers — 同为编码方法论（Karpathy 更简洁聚焦，Superpowers 提供完整工作流）
- Agentic_Systems — 智能体系统