4条规则让AI写代码更像资深工程师:andrej-karpathy-skills 上手指南
【免费下载链接】andrej-karpathy-skillsA single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.项目地址: https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills
AI 写代码时擅自乱改、100 行能干的活写了 300 行?andrej-karpathy-skills 把 Andrej Karpathy 对 LLM(大语言模型)编码毛病的观察,整理成一个规则文件。它是用 Claude Code 等 AI 编程工具日常写码的人值得一读的行为规范,装完立省来回返工。
30秒速览
- 它是什么:andrej-karpathy-skills 本质是一个
CLAUDE.md文件,给 AI 编程助手的四条行为规则,零依赖 - 适合谁:用 Claude Code、Cursor 等工具写代码的开发者,以及想统一团队 AI 编码风格的负责人
- 核心收益:少乱假设、少过度设计、diff(代码差异)更干净
- 上手成本:复制一个文件,2 分钟生效
装上之后变了什么:4 个核心价值
让 AI 先说"我不确定",再动手写码
默认情况下,LLM 会悄悄选一种解释然后闷头执行。这个规则文件要求它先把假设摆出来、把多种解释列给你、遇到不懂的直接停住提问。
以"让搜索更快"为例:没有规则时,AI 可能直接堆上缓存、索引、异步处理,200 行代码。有规则后,它会列出响应时间、并发能力、体感速度三个方向,标出各自的预估工作量,再问你哪个才是要解决的。
200 行 vs 50 行:内置"资深工程师评审"
每条规则都带一个可检查的判断标准,比如"如果你写了 200 行而 50 行就够,重写",比如问自己"资深工程师会说这过度设计吗?"
仓库里EXAMPLES.md有一组对照:计算一个折扣金额,一边用策略模式加抽象基类写了 30 多行,另一边一个三行函数搞定。后者不是偷懒,是拒绝在需要之前加复杂度。
diff 要"干净":只改必须改的行
这条原则要求 AI 只碰任务必需的代码,只清理自己造成的遗留问题。
修一个"空邮箱导致崩溃"的 bug:没规则时,AI 会顺手加用户名校验、改注释措辞、补类型标注;有规则后,只改与 bug 直接相关的两行。看到无关的死代码怎么办?提一嘴,但不删。
给成功标准,别下指令
Karpathy 的关键观察是:LLM 特别擅长"循环直到达成目标"。所以规则要求把"修一下 bug"转写成"写一个能复现它的测试,然后让它通过"。
多步任务必须拆成步骤 → verify: 检查项的短计划,前一步验证不通过就不进下一步。模糊需求就这样变成了 AI 能自己循环核对的清单。
动手试试:2 分钟让规则跑起来
最直接的用法是克隆仓库,看一眼真正被注入 AI 上下文的文件:
git clone https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills cat andrej-karpathy-skills/CLAUDE.md你会看到 4 个章节、不到 60 行规则。如果你在用 Claude Code,也可以装成插件让所有项目共享:
/plugin install andrej-karpathy-skills@karpathy-skills装完后随便丢一个需求模糊的任务,比如"加个导出用户数据的功能"。第一屏你应该看到的是 3~4 个澄清问题(范围、格式、字段、数据量),而不是第一行代码。
从踩坑到修复:新手最容易栽的 3 个坑
AI 在小事上也开始"连环提问"现象:改个错别字,它也要先跟你确认需求。 原因:规则本身明确偏向"谨慎优于速度"。 正解:文件里写了 trivial tasks 可自行判断——简单改动直接加一句"直接改,不用问"。
CLAUDE.md 贴进去,行为却没变现象:文件放好了,AI 还是整段格式化别人的代码。 原因:项目原有指令和规则冲突,或上下文太长把规则挤淡了。 正解:用追加(append)而不是覆盖合并进现有CLAUDE.md,项目专属规则单独放一节。
在 Cursor 里用,CLAUDE.md 完全没生效现象:文件复制过去了,Cursor 依旧按默认习惯来。 原因:Cursor 默认不读CLAUDE.md。 正解:把仓库自带的.cursor/rules/karpathy-guidelines.mdc拷进你项目的.cursor/rules/,它已设置alwaysApply: true,打开即生效。
下一步
这个项目的本质就一句话:别告诉 AI 做什么,告诉它"怎样算做到了",然后看着它自己循环到验证通过。
读完CLAUDE.md只需 5 分钟,接着翻EXAMPLES.md,里面 8 组"AI 常犯 vs 正确做法"的真实对照,可以直接当你评审 AI 产出代码时的检查清单。
【免费下载链接】andrej-karpathy-skillsA single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.项目地址: https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考