65行Markdown,6万颗星:一个CLAUDE.md凭什么霸榜GitHub第一
周打开GitHub Trending,第一眼以为自己眼花了。
排在第一的仓库,没有代码,没有框架,没有轮子。只有一个文件——CLAUDE.md。
一周时间,6万5千颗星。5700个fork。连续三天霸榜。点进去一看,全文大概就65行。
GitHub链接:github.com/forrestchang/andrej-karpathy-skills
这到底是个什么东西
简单说,它是一个给Claude Code(Anthropic出的AI编程工具)用的配置文件。你把它放到项目根目录下,AI在帮你写代码的时候就会读取这些规则,然后按照这些规则来干活。
听起来平平无奇对吧?GitHub上类似的配置文件多了去了。但这个东西不一样——它的内容, distilled(蒸馏)自Andrej Karpathy。
如果你对AI圈有点了解,应该知道这个名字。OpenAI联合创始人,前特斯拉AI总监,现在自己单干了。这人在编程和AI领域的发言,基本等于行业风向标。
今年年初,Karpathy在社交平台上发了一篇长文,讲自己怎么用AI agent写代码。他说自己现在的工作模式是80%交给Agent,20%自己修补。从去年12月开始,他几乎没手写过一行代码。
但他说AI编程有个很大的问题:模型太"积极"了。你让它加个功能,它能给你整出一堆你没要的东西。重构、抽象、边界情况处理——全给你安排上。结果就是代码越来越乱,最后你还得花更多时间去收拾。
然后有个叫Jiayuan Zhang的开发者(Multica项目创始人)看到了这篇长文,用工具把Karpathy的观点转成了初始草案,再用AI自我审查精简了一下,最后搞出了这个65行的CLAUDE.md。
65行,四条原则
这65行核心就四句话:
第一条:写代码前先想。
AI有个毛病——遇到不确定的地方,它不问你,它直接猜。猜对了还好,猜错了就埋雷。这条规则要求AI在有歧义的时候必须先停下来,给你几个选项让你选,而不是自己拍脑袋决定。
说实话,就这一条,就能省掉大把debug时间。
第二条:简单优先。
你没要的功能,别写。多余的抽象层,别加。极端情况的处理,除非你明确要求,否则跳过。
这听起来像是废话,但用过AI编程的人都知道,这太重要了。你让AI写个登录功能,它能给你搞出一套完整的权限管理系统,附带三种认证方式、两个中间件、一个配置文件——而你只想要个用户名密码验证。
第三条:只做让你做的事。
这条和第二条有点像,但更具体。它要求AI只修改你明确要求改的部分,保持原有代码风格,改完之后把自己产生的废弃代码清理干净。不能顺便帮你重构,不能顺便帮你格式化。
有个开发者在评论区说,他之前让AI改一个bug,结果AI把他整个文件的缩进风格都改了,git diff看了几百行,实际改动的就三行。气死。
第四条:用目标驱动,不要用步骤驱动。
这是我觉得最有价值的一条。
AI很擅长做一件事:反复试错,直到达成目标。但它不擅长理解模糊的指令。所以这条规则的核心是——别告诉AI"怎么做",告诉它"做成什么样算成功"。
比如,不要说"给这个函数加验证",而要说"写测试用例覆盖无效输入,然后让测试通过"。
前者AI可能理解偏,后者它直接跑测试,过了就完事。
为什么这么火
说实话,一开始我觉得6万颗星有点夸张。但用了一周之后,我理解了。
现在AI编程工具的瓶颈,早就不是模型本身了。GPT-4、Claude Sonnet这些模型的代码能力已经足够好。真正的问题在于,你怎么让它稳定地输出好代码,而不是有时候神有时候鬼。
有个开发者说得好:"现在的瓶颈不在模型,而在模型周围的脚手架。"
这个CLAUDE.md就是脚手架。它把资深工程师的隐性经验——那些你平时code review时会说的话、那些你心里知道但没写下来的规矩——变成了机器能读懂的指令。
你不需要每次都跟AI重复"别加多余的东西""先问清楚再动手"。你把它写进CLAUDE.md,它每次都记得。
但也没那么神
不过话说回来,这东西也不是万能药。
首先,它解决的是行为问题,不是能力问题。如果你的需求本身就很模糊,AI还是搞不定。它只是让AI在模糊的时候先问你,而不是让它变聪明。
其次,它不能帮你做架构决策。用哪个框架、怎么设计数据库、微服务怎么拆分——这些还是需要你自己想清楚。CLAUDE.md只管"怎么写",不管"写什么"。
还有,Karpathy自己也说过一个担忧:如果大家都这么依赖AI写代码,人类自己手写代码的能力会不会退化?他说他预测2026年是"Slopacolypse"(垃圾内容大爆发),低质量AI生成内容会泛滥成灾。这个CLAUDE.md某种程度上是在对抗这种趋势——它让AI生成的代码更可控,但它改变不了"越来越多人不自己写代码"这个大方向。
