multica-ai/andrej-karpathy-skills

开发工具

一份给编程 Agent 的 CLAUDE.md 规则集,要求它先确认假设、控制改动范围、围绕可验证目标工作。

223,705
22,402
创建于 9 个月前

如果你用的编程 Agent 经常自行补充需求、把一个小修复扩成大重构,或顺手改了你没提的文件,这个仓库值得先花几分钟读完再决定用不用。它更像一份提示词规范而非工具:一个 Markdown 文件里的四条行为原则,来自 Andrej Karpathy 对 LLM 编程习惯的批评。

解决什么问题

你让它加一个校验或修一个 bug。它悄悄猜了一个模糊需求,加了一层抽象,顺手改了旁边的注释,交回来的 diff 比任务本身大得多。你审查这份 diff 的时间超过了自己动手改,下一次对话又重复同样的问题。这个项目试图改变中间那一步:不再让 Agent 自行选定一种理解,而是要求它明确列出假设、给出多种解释、对不必要的复杂度提出异议,并把工作绑定到测试上。预期结果是 diff 更小、更贴近需求,审查起来更快。

有什么不同

机制完全是指令层面的,这既是它的吸引力也是它的软肋。四条原则直接对应观察到的失败模式:“先想再写”针对不说明假设、不呈现取舍的问题,“简单优先”针对过度设计,“外科手术式修改”限制改动范围,“目标驱动执行”把“修好这个 bug”这类命令转成验证循环。README 明确说明了偏向:宁可慢一点,也优先求稳,并建议在改错别字、一行代码这类琐碎任务上自行判断,不必完整套用 项目说明。原则本身源自 Karpathy 关于模型不愿暴露困惑、不主动呈现取舍的帖子 Karpathy 的观察。文件是纯 Markdown、没有依赖,几分钟就能读完,可以只摘取你需要的部分——README 也说明了如何与项目自有规则合并 定制说明。代价是遵守程度完全取决于模型和运行环境是否执行这些指令;没有任何机制强制约束,任务一大,Agent 仍可能忽略它们。Cursor 用户还有一条已提交规则的路径,并有单独说明 Cursor 指南。

谁值得试

适合:每天在既有代码库上用 Claude Code、总在清理顺手乱改和多余抽象的开发者,尤其是能写出项目自有规则并合并进去的人。不适合:期待 linter、钩子或强制策略在 Agent 不守规矩时让构建失败的人;主要让 Agent 从零搭大框架的人也要考虑,偏谨慎的指令集可能和这类工作节奏冲突。想让其他编辑器也应用同一套规则的团队可以走 Cursor 规则路径,但要有维护两份副本的准备。

使用条件与边界

上手成本很低:可以从插件市场安装 Claude Code 插件,也可以把单个 CLAUDE.md 复制或追加到项目里 安装说明。Cursor 方面,仓库自带一份规则文件并附有设置指南 Cursor 设置。安装本身不费事,长期要做的,是防止通用原则被项目特定指令淹没,并接受这套规则会刻意放慢非琐碎改动。仓库元数据没有声明许可证,README 却写了 MIT,把这段文字放进公司管理的仓库前值得先弄清这处不一致。README 也没有说明除“diff 更小、PR 更干净”这类观察之外,如何衡量规则是否真的生效。评估时应把四条原则当作审查清单,而不是效果保证。

HotRepo 点评

HotRepo 只有一条记录:截至 2026-10-25 的一周,该项目以 +2,981 stars 位列全语言周榜第 13 名 项目信号。这个单日快照说明当时有关注度,但没有日榜历史,无法判断热度能否持续。文件足够短,可以直接评估:读一遍 CLAUDE.md,先确认四条原则是否与团队现有的 Agent 指令冲突,再决定是否大范围采用。

本文由 AI 根据项目 README 生成,更新于 2026年10月25日,以项目官方文档为准。