Karpathy 式编码准则
Model: qwen-max | ¥0.15/call
AI编程编码规范Agent行为
基于 Andrej Karpathy 对 LLM 编码缺点观察提炼的四条编码准则:先思考后编码、极简优先、外科手术式改动、目标驱动执行。适用于 Claude Code、Codex、Cursor 等 AI 编程工具的项目级行为规范,减少无效假设与过度抽象。
Calls: 2
Skill Documentation
摘要
本 skill 提供基于 Andrej Karpathy 对 LLM 编码缺点观察提炼的四条编码准则:先思考后编码、极简优先、外科手术式改动、目标驱动执行。适合 Claude Code、Codex、Cursor、Gemini CLI 等 AI 编程工具的项目级行为规范,能显著减少无效假设、过度抽象和无关改动。
四条准则
1. 先思考后编码
- 明确陈述假设,不确定就提问而不是猜测
- 存在歧义时给出多种解释,不默默选定一种
- 有更简单方案时主动提出;感到困惑时停下来说明
2. 极简优先
- 只实现被要求的特性,不做投机性功能
- 不为单次使用代码引入抽象
- 不做未要求的"灵活性"和"可配置性"
- 200 行能写成 50 行就重写
3. 外科手术式改动
- 只触碰必须改的地方,不"顺手改进"相邻代码
- 不重构没坏的东西;匹配已有代码风格
- 发现无关死代码只提及,不删除
- 只清理自己改动产生的孤儿代码
4. 目标驱动执行
- 把命令式任务转为可验证目标:"写测试让失败通过"代替"修 bug"
- 多步任务先列计划:步骤 + 验证点
- 强成功标准让模型独立循环,弱标准需要反复澄清
安装方式
- Claude Code 插件: /plugin marketplace add forrestchang/andrej-karpathy-skills
- 单项目: curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md
- Cursor: 使用仓库内 .cursor/rules/karpathy-guidelines.mdc
适用判断
这些准则偏向谨慎而非速度;简单任务(改错别字、一行修复)不必全程严格,重点在降低非平凡工作上的昂贵失误。
常见问题
这套准则适合什么场景?
适合任何使用 AI 编程助手做真实项目的团队,尤其是出现过"模型自作主张假设、过度抽象、顺手改无关代码"等问题的场景。
为什么说极简优先很重要?
LLM 倾向过度复杂化代码和 API、膨胀抽象,把 100 行能解决的问题写成 1000 行。极简准则直接对抗这一倾向,产出更易维护。
如何判断准则在生效?
看 diff 中是否只出现被要求的变化、重写次数减少、澄清问题出现在实现之前、PR 干净无顺手重构。
FAQ
这套准则适合什么场景?
适合任何使用 AI 编程助手做真实项目的团队,尤其是出现过"模型自作主张假设、过度抽象、顺手改无关代码"等问题的场景。
为什么说极简优先很重要?
LLM 倾向过度复杂化代码和 API、膨胀抽象,把 100 行能解决的问题写成 1000 行。极简准则直接对抗这一倾向,产出更易维护。
如何判断准则在生效?
看 diff 中是否只出现被要求的变化、重写次数减少、澄清问题出现在实现之前、PR 干净无顺手重构。