整个东西就是一个文件
在一片庞大的技能框架和插件市场的潮流里,这个仓库是极简的对照,而这就是它全部的吸引力:它是一个 CLAUDE.md 文件。没有安装脚本、没有插件、没有市场。它提炼出四条意在改进编程智能体工作方式的行为护栏,源自 Andrej Karpathy 关于「LLM 编码在哪里出错」的公开观察。你把文件放进去,智能体就把它当常驻指令来读。
先做一个澄清,因为这名字会引人误会:这是 multica-ai 对 Karpathy 公开发布的观察的一份社区提炼,不是一个由 Karpathy 本人撰写或背书的项目。价值在那份策划,把一个广为人知的、对智能体行为的批评变成具体规则,而非任何官方背书。
它瞄准的坑
README 直接引了 Karpathy 帖子里的失败模式:模型做出错误假设并顺着跑、不核对,不浮现不一致或取舍,该反驳时不反驳,把代码和 API 搞复杂、让抽象臃肿,有时改动或删除它没充分理解的代码。任何见过一个能干的智能体自信地造错东西的人,都会认出这一切。
四条原则
文件用四条规则回应那些坑,每条对应一个失败模式:
- Think Before Coding(先想再写):明确陈述假设,在有歧义时呈现多种解释、而非悄悄挑一个,有更简单的办法时反驳,困惑时停下来问。
- Simplicity First(简单优先):解决问题的最少代码,不做投机性的东西,对抗过度工程的倾向。
- Surgical Changes(外科式改动):别碰或删除与任务正交的代码。
- Goal-Driven Execution(目标驱动执行):从测试优先、可验证的成功标准出发。
这些是护栏、不是能力。它们不加工具;它们约束行为。这是和一个技能合集的有意义区别:这个文件唯一的力量是模型愿意遵从常驻指令,所以它的效果是真实但柔性的,在那些好好理会 CLAUDE.md 的模型上更强。
怎么用
没什么可搭。你把 CLAUDE.md 复制进你的项目根、或并进一个已有的、或放到你的智能体加载全局指令的地方。从那以后智能体的上下文里就有了这四条原则。因为它是无依赖的纯 Markdown,适配它就是编辑文本,把它和你自己的项目约定合并是预期的工作流。唯一要拿捏的是优先级:如果你已经维护一个 CLAUDE.md,决定这些原则是领先还是跟随你已有的规则,因为智能体读整个文件、靠后的指令能软化靠前的。想让它们定调,就把这四条原则放在靠近顶部。并按模型校准你的预期:因为这个文件只靠说服起作用,一个紧跟常驻指令的模型会明显慢下来、多问问题,而一个倾向于往前冲的模型会少理会它,这和每一个仅靠指令的干预共享的、同样的依模型而异。
两个值得说的注意事项
- 没有声明许可。 仓库不带许可,默认意味着保留一切权利。对一个你复制进自己项目的单一文本文件,这在实践上风险很低,但如果你再分发它,缺乏声明的授予就要紧了。
- 它也是宣传语境。 README 指向维护者自己的 Multica 平台(用于运行和管理编程智能体)。这不削减文件的有用性,但值得知道这个仓库兼作一个引流口。
andrej-karpathy-skills 与更重的选项对比
| andrej-karpathy-skills | superpowers | mattpocock/skills | |
|---|---|---|---|
| Stars | 172,501 | 222,999 | 123,769 |
| 形态 | 一个 CLAUDE.md 文件 | 方法论框架 | 一套技能 |
| 加什么 | 行为护栏 | 一整套流程 | 具体能力 |
| 配置 | 复制一个文件 | 按 harness 安装 | npx 安装器 |
计数取自 GitHub,截至 2026 年 6 月。superpowers 强加一整套方法论;mattpocock/skills 是一套可适配的、能用的技能。这个文件是尽可能轻的干预:无安装、无工具,只是你智能体上下文里的四条规则。如果你想要那个把智能体从常见错误上轻推开来的最小东西,就是它;如果你想要被强制的流程或真实能力,其它的走得更远。
相关
要塑造智能体行为的最大化版本,见 superpowers;要可组合的单项技能,见 mattpocock/skills。想看还有什么在往上爬,见 LLM 工具、每日速报和周报。
FAQ
这是 Andrej Karpathy 做的吗? 不是。它是 multica-ai 对他公开发布的、关于 LLM 编码坑的观察的一份社区提炼,不是由他撰写或背书。
仓库里到底有什么? 一个 CLAUDE.md,带四条原则:先想再写、简单优先、外科式改动、目标驱动执行。
怎么用? 把文件复制进你的项目或你的全局智能体指令、并按需编辑。没什么可安装的。
它加新能力吗? 不。它是行为护栏、不是工具,所以它的效果取决于模型遵从那些常驻指令。