两条命令装好AI编程准则,AI先立规矩再写码
【免费下载链接】andrej-karpathy-skillsA single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.项目地址: https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills
一句要导出,为什么改坏三个文件
你让AI改代码,越改越乱:要个导出按钮,它交活了,还顺手"优化"了隔壁三个文件,重命名了两个你叫不出名字的函数。别笑,我上周就中招。解药是一个小仓库 andrej-karpathy-skills,就一个文件,给AI立一套动手前必须遵守的规矩,装好之后 Claude Code 的改动明显收敛,diff 干净多了。
给AI发一份工位守则
说实话,这个项目只干一件事:把编码准则写进配置文件,挂在AI开工前。就像收实习生,你不先教他写码,先发一份工位守则——只碰交代的事、卡住了开口问、没坏的别自己动。
AI 每次开工先读到这份守则,第一反应就从"我发挥一下"变成"哪些事我不该做"。全部条文浓缩在 CLAUDE.md 一个文件里,另有一份行为模式封装在 skills/karpathy-guidelines/SKILL.md,插件装上后全项目生效。你不用背任何东西,把守则挂上去就行。
🔍 动手前先问三件事
你肯定也遇到过:AI 默默从你的话里挑了一种理解,然后信心满满跑完全程,交活时你才发现它理解岔了。
你:"加个用户数据导出。" AI:"搞定,全量用户,CSV,47个字段。" 你:"我要的是筛选后的用户,Excel格式。" AI:"哦,那我重做。"
对症的规矩写在这套 AI 编程准则里:动手前先回答三个问题——我默认了什么、这需求还有没有别的解释、做完拿什么算数。有歧义就摊开给你看,有困惑就停下来问,有更快的路子就提出来,而不是闷头做复杂版。模糊指令也要当场翻译:加验证,变成先写无效输入的测试再让它通过;修 bug,变成先写一个能复现它的测试再修。验收标准一定,AI 就能自己循环验证直到通过,不用每步回头问你。装完最直观的变化是:澄清问题从犯事之后,挪到了动手之前。
少改就是多改
另一类坑是手痒。上次我只要一个三行就够的折扣计算,AI 交回来一个带抽象基类的策略模式,三十多行;还有一次它改主文件,顺手把隔壁文件的注释"统一"了一遍,没人叫它动。准则给的解法很直白:只写今天需要的代码,一次性函数不配抽象,没被要求的"可配置"不做,没坏的东西不碰,看见不相干的死代码,提一句就行,别删。
判断标准记一句就够:diff 里每一行都得能追溯到你那句请求,追不上就不该存在。文件里还藏了个更狠的检验——如果资深工程师瞄一眼就说这太绕,那就重写。有了这条,AI 的第一版代码从"展示点设计"回到"把事办了",你翻一眼就想回滚的概率低很多。
🔧 两条命令装好AI编程准则
装起来最轻。想让行为约束全项目生效,在 Claude Code 里敲两条:
/plugin marketplace add forrestchang/andrej-karpathy-skills /plugin install andrej-karpathy-skills@karpathy-skills只想给一个项目用,就克隆仓库 https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills ,把 CLAUDE.md 拷到项目根目录即可;已有 CLAUDE.md 的项目直接追加,顺手补两三条团队自己的规矩:
## 团队规则 - 使用 TypeScript 严格模式 - 所有 API 端点必须有测试这套准则本来就是设计来和项目自己的指令合并的,不冲突,追加一节就完事。
谁该装,什么时候见效
日常写 CRUD 页面、小项目,靠 AI 助手扛掉大半代码的开发者,基本就是它的目标人群。不用研究原理,装上就能感觉到变化:
| 表现 | 装之前 | 装之后 |
|---|---|---|
| diff | 夹带大量无关行 | 只有你要的改动 |
| 澄清 | 搞砸后才问 | 动手前就问 |
| 返工 | 过度设计再重写 | 一次到位 |
它不让你写得更快,但让你少写一半没用的行。
【免费下载链接】andrej-karpathy-skillsA single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.项目地址: https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考