让 AI 写代码不再自由发挥andrej-karpathy-skills 完整使用与扩展指南【免费下载链接】andrej-karpathy-skillsA single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathys observations on LLM coding pitfalls.项目地址: https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills你有没有遇到过这种情况让 AI 助手给订单接口加个校验它交回来的却是一个 300 行的抽象层顺手还把你另一个文件里的引号风格改了。andrej-karpathy-skills 就是为治这个毛病而生的——它把 Andrej Karpathy 总结的 LLM 编码陷阱压缩成一个 CLAUDE.md 行为准则文件用 4 条原则管住 AI 的自由发挥让 diff 里只剩你真正要的东西。AI 为什么爱把 50 行的事写成 200 行这个项目直接对应 Karpathy 观察到的三类典型问题每条你可能都见过默默假设你说导出用户数据AI 默认导出全部用户、默认文件放根目录、默认包含敏感字段全程不问你。过度设计一个计算折扣的函数它给你建了策略模式 抽象基类 配置类30 行能写完的事写了 60 行。顺手乱改任务是修一个空邮箱崩溃的 bugdiff 里却混进了注释改写、新增 docstring、没人要的 username 长度校验。这三类问题的共同点是代码本身不算错但每次合并你都要花额外时间甄别哪些改动是任务要的、哪些是它自己加的。4 条核心原则是怎么管住 AI 的准则全文就放在 CLAUDE.md 里四个原则各管一块Think Before Coding先想后写——不确定就问多种理解就摆出来让你选。比如让搜索变快这句话合规的做法是先反问你要的是响应时间从 500ms 降到 100ms还是扛住更高并发还是前端体感更快三种做法和工作量完全不同。Simplicity First简单优先——只写解决问题所需的最少代码不加没被要求的灵活性和可配置性不为不可能发生的场景写错误处理。它内置了一个自检标准如果资深工程师会嫌这段代码过度复杂就重写它。Surgical Changes外科手术式修改——只动必须动的行匹配现有代码风格即使你觉得自己的写法更好。修 bug 时注意到无关的死代码提一嘴但别删。Goal-Driven Execution目标驱动执行——把加个校验翻译成先为非法输入写测试再让测试通过。强验收标准让 AI 能独立循环直到验证通过弱标准让它能用就行只会让它不停回来问你。想看每条原则对应的真实正反代码对照比如策略模式算折扣 vs 一个函数仓库里的 EXAMPLES.md 给了 8 组例子每组都是AI 常犯的错 → 正确做法的结构读一遍比抽象讲原则管用。30 秒把它装进你的工作流有两条路按你的使用习惯选装在 Claude Code 里推荐规则在你所有项目里生效在项目目录打开 Claude Code 后执行/plugin marketplace add forrestchang/andrej-karpathy-skills /plugin install andrej-karpathy-skillskarpathy-skills只装在某个项目里克隆仓库后把根目录的 CLAUDE.md 拷到你项目根目录即可已有 CLAUDE.md 的话把内容合并进去git clone https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills第二种方式的本质就是往你的指令文件里加几段文字所以任何只认根指令文件的 AI 工具都能用。怎么判断规则真的起效了装完不用猜看 diff 就行。规则生效时你会看到这几件事代码评审里无关改动明显变少——diff 只出现你要求的那几行返工变少——代码第一次就是简单的不需要你打回去重写提问发生在动手之前——AI 先确认范围和假设而不是出错之后解释PR 干净——没有夹带的顺便重构和顺便优化拿你最近一次让 AI 改代码的任务再跑一遍对比一下 diff 行数通常一两次就能看出差别。把自己的规则写进 CLAUDE.md这份准则设计上就是和你自己的项目规则合并使用的。在 CLAUDE.md 里追加一个项目专属小节把团队硬约束写成可执行的条款例如一律使用 TypeScript strict 模式所有 API 端点必须有测试错误处理沿用src/utils/errors.ts里的现有模式写条款时照抄 4 条原则的句式就行一句加粗的原则口号 几条具体的做/不做清单。条款要能被 AI 直接执行写干净点的代码这种话它没法照做。如果你用 Cursor 而不是 Claude Code仓库已内置一份带alwaysApply: true的项目规则打开目录就自动生效想在自己的其他项目用把.cursor/rules/karpathy-guidelines.mdc复制过去即可。一个要留心的取舍它偏谨慎不偏快这套准则明显偏向稳妥而非速度——每次改动前确认假设、每次改完对照验收标准。对非平凡的改动这个换值但对改一个错别字、补一行显而易见的逻辑全套流程就是拖慢节奏。规则本身也写明了琐碎任务自己裁量。用一阵子你会自然形成手感哪些任务值得让它先想后写哪些直接放它跑。下一步行动清单选一种方式把准则装好Claude Code 装插件其他项目直接拷 CLAUDE.md挑一个你正在做的任务比如修某个接口让 AI 跑一遍盯着 diff 看是否只有任务内的改动把团队的 2~3 条硬约束按原则口号 做/不做清单的句式追加到 CLAUDE.md过两周回看 PR无关改动和返工次数如果降下来了规则就留得住哪条原则总被你自己忽略就把那条改得更具体【免费下载链接】andrej-karpathy-skillsA single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathys observations on LLM coding pitfalls.项目地址: https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
