一个仓库，一个文件，22 万星。它什么代码都没有。
先说个反差。我平时翻 GitHub trending，星数高的基本都是新框架、新模型、新工具。这个仓库进去一看，里头只有一个 CLAUDE.md，65 行。
226,934 星，22,659 个 fork。
二十多万人觉得这么一段文字值得存下来。而它就干一件事：给 AI 定规矩。
它是从三条抱怨来的
Karpathy 前阵子发了条帖子，吐槽 AI 写代码的三个毛病。我看完在工位上点了点头。
头一个，它会替你做出个错的假设，然后一路照着往下跑。中间不回头核一下。你说加个缓存，它顺手把数据库连接池也重构了。
第二个，它特别爱把事搞复杂。堆抽象、加配置项、写一堆根本没人用的扩展点，一千行能写完的东西，非要写得更长再附送个插件体系。死代码也不清。
第三个，它会改动那些它其实没看懂的代码和注释。捎带的。
这三条你要是天天用 AI 写代码，估计都有体感。跟模型聪不聪明关系不大，是它的默认倾向跟工程规范拧着来。
四条规矩
有人把这三条抱怨整理成了四条规矩，就是那个仓库。我做了张图，四条的骨架和原文金句都塞进去了：
一条条说。
01 Think Before Coding：先想清楚，再动手
它要求 AI 动手之前把假设明说出来。有歧义就摆给你选，有更简单的路子就主动讲，听不懂就停下来问，别自己编一个解释接着干。
这条看着最软，其实最硬。因为「停下来问」对模型来说是反直觉的动作，它的训练目标是「继续往下生成」，不是「停住」。
02 Simplicity First：简单第一
没要求的功能不加。只用一次的地方不做抽象。没人提的配置项不写。不可能发生的错误不加 try。
还有句原话我觉得挺狠：「如果你写了 200 行，而它本来 50 行就能解决，那就重写。」 判准他也给好了——问自己一句，一个资深工程师看到这段，会不会说过度设计。
03 Surgical Changes：动刀要小
这条专治顺手优化。别改旁边的代码，别调注释格式，别重构没坏的东西，风格不合你口味也跟着原样来。碰见无关的死代码，提一句，别自己删。
判断标准就一句：每一行改动都得能直接对上你这次的需求。对不上，就是你在夹带私货。
04 Goal-Driven Execution：给验收标准，别给步骤
这条反而是他自己的一个观察，不是抱怨。LLM 特别擅长朝一个明确目标反复试到成功。
所以别说「加个校验」，说「给非法输入写测试，然后让它们全过」。别说「修这个 bug」，说「写个能复现它的测试，然后让它变绿」。
标准越硬，它能独立转的圈数越多。标准越虚，比如「让它能跑就行」，你就得全程陪着聊。
怎么用
两种方式，都省事。
想当 Claude Code 插件用的：
/plugin marketplace add forrestchang/andrej-karpathy-skills
/plugin install andrej-karpathy-skills@karpathy-skills
或者干脆把文件拽到项目根目录：
https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md
打开这个地址，把内容存成 CLAUDE.md 丢到项目根目录。Claude Code 每次开会话会自动读。
提醒一句，README 里给的地址是 forrestchang 那个仓库，但实际仓库挂在 multica-ai 名下，早期转移过。两边内容一致，哪个都能用。真拿不到就把仓库拉下来手动拷。
别整份照搬
原作者在文件开头自己就写了，这份指南偏向保守，牺牲速度换稳妥，琐碎任务自己判断。
这话实诚。你让它改个变量名，还要求它先声明假设、评估更简单的方案、等你确认，那是给自己找麻烦。我的用法是规矩留着，把它当「默认档」，碰上小活儿手动松开。
三个冷静提醒
在看它之前，这三件事你得知道。
冷静一：22 万星不等于 22 万人在用
这仓库已经半年没动了。2026 年 1 月建的，最后一次 push 是 4 月 20 号，到现在停更半年多。license 字段都是空的。一个 65 行的文本文件能攒到二十多万星，大家 star 的是「说得对」，不是「我要用」。
冷静二：规矩是死的，模型是活的
CLAUDE.md 里写「不要过度设计」，它该过度设计的时候还是照旧。文本约束的强度有限，上下文一长、它开始顺着感觉走，那几行字就拦不住了。真正管用的还是第 4 条——给硬验收标准，让它自己撞墙。文字提醒是辅助，测试才是绳子。
冷静三：这套规矩偏保守，赶进度的时候会烦
通篇都在说别做多余的事。维护老项目、改别人代码、做线上修复，这玩意是宝贝。但你要是从零起个新项目、就想让它多写点脚手架多铺点结构，这套规矩会让你每分钟都在被反问一句：这个真的需要吗？
写在最后
我这两年最大的感受，AI 写代码的能力早就够用，麻烦全在它不听话上。而「不听话」跟态度无关，是它的默认倾向跟工程规范天然不咬合。
所以值钱的东西，慢慢从「更好的模型」挪到了「更好的约束」。这 65 行拿 22 万星，说明大家都摸到那个点上了。
规矩没一条是新的，都是老工程师挂在嘴边的话。新的地方在于，终于有人把它们写成了 AI 能读的格式。
我把这份文件塞进自己四个项目的根目录试了一周，效果回头单独写。反正它才 65 行，删掉也不心疼。
项目地址：https://github.com/multica-ai/andrej-karpathy-skills
发表于 1 小时前
|
查看: 6|
回复: 0
/1 
