Appearance
CLAUDE.md霸榜GitHub第一：蒸馏自Karpathy的AI编程紧箍咒
一个毫无代码的文本文件，连续三天GitHub Trending日榜第一，61.6k星。4条规矩蒸馏自Karpathy，让乱写Bug的大模型瞬间老实。
四条原则
原则一：编码前先思考
| 规定 | 说明 |
|---|---|
| 不确定必须问 | 不能猜 |
| 多种理解列选项 | 让用户选，不替用户做决定 |
| 有更简方案主动说 | 该推回来就推回来 |
痛点：你让AI"加个验证功能"，它不问验证什么、严不严格，自己猜一个最复杂的方案，写了一大堆不需要的代码。
原则二：简约至上
| 规定 | 说明 |
|---|---|
| 不写不需要的代码 | 能简就简 |
| 不构建过度架构 | 拒绝企业级过度设计 |
| 先确认再动手 | 别忍不住就开写 |
痛点：你要一个简单功能，它写一整套企业级架构，附登录认证、安全校验、流量控制。
原则三：没让你改的地方别碰
| 规定 | 说明 |
|---|---|
| 最小改动原则 | 只改该改的 |
| 不重构无关代码 | 别顺手优化 |
| 不改变代码风格 | 保持原有风格 |
痛点：你让它改一个按钮颜色，它把整个组件重构了。
原则四：给目标别给步骤
| 规定 | 说明 |
|---|---|
| 描述目标 | 告诉AI要什么结果 |
| 不指定步骤 | 让AI自己决定实现路径 |
| 审查结果 | 看结果不看过程 |
痛点：你一步一步指挥AI做事，反而限制了它更好的实现方案。
起源
- 今年1月26日，Karpathy在X发长帖吐槽AI编程Agent各种毛病
- 华人开发者Jiayuan Zhang当天动手，用Claude Code把帖子转化成skills文件
- 约800行描述→Claude自审→砍成约70行干净指令
- 产物就是CLAUDE.md（也有Cursor版）
社区反馈
| 开发者 | 评价 |
|---|---|
| Kraggich | "一个Markdown文件冲上趋势榜第一，说明瓶颈不在模型，在模型周围的脚手架" |
| Surajdotdot7 | "模型选错分支跑了40分钟碰壁，提前澄清只需30秒" |
项目地址
https://github.com/forrestchang/andrej-karpathy-skills
总结
一句话总结：4条原则（先思考、简约、别碰、给目标）管住AI编程最常见的4个毛病——放进项目根目录，Agent自动读取遵守。
