让 AI 编程助手守规矩:andrej-karpathy-skills 的 CLAUDE.md 规则接入指南
让 AI 编程助手守规矩:andrej-karpathy-skills 的 CLAUDE.md 规则接入指南【免费下载链接】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-skillsandrej-karpathy-skills 是一份给 AI 编程助手的行为规范:它把 Andrej Karpathy 观察到的 LLM 写代码常见问题提炼成四条规则,全部写进一个CLAUDE.md文件,Claude Code 启动时会自动读取并遵守。如果你的 AI 总爱替你做假设、动不动堆过度设计的代码、修个小 bug 顺手重构半个文件,靠这一个文件就能让它的行为变得可预测,不用改任何一行业务代码。先自查:用 AI 干活时你碰没碰过这 3 种情况你的需求没加规范时的常见表现加了规范后的表现把搜索变快一点直接加上缓存、数据库索引、异步处理,不告诉你它优化的是哪种快先列出响应时间、并发量、感知速度三种可能,问你最在意哪个再动手把用户偏好存进数据库写出一套带缓存、校验器、通知开关的管理器类只写一个几行的保存函数,等真需要缓存或校验时再加修复空邮箱让校验函数崩溃的 bug修 bug 的同时重写注释、补上没人要的用户名校验、改动引号风格只改空值处理相关的行,旁边发现的死代码只提醒不删上面任何一条让你觉得眼熟,后面的内容就值得花两分钟看完。这个规则文件是怎么让 Claude Code 变规矩的Claude Code 有一个内置机制:会话启动时读取项目根目录的CLAUDE.md,把里面的内容当作必须遵守的行为规则。andrej-karpathy-skills 就是把这个机制用足——整个仓库的核心就是这一个规则文件,外加给 Cursor 用的对应配置。规则内容来源于 Karpathy 对 LLM 编码毛病的观察:模型经常替你做错误假设却不去核实、爱把抽象膨胀到一百行能解决的事写成一千行、还会顺手改动与任务无关的代码。这个文件把这些毛病逐条写成了明确的约束,落在四个行为面上。不替你做选择题,不懂就问动手前必须把假设说出来;需求有两种以上理解时,摊开给你选,禁止悄悄挑一个解释就往下写;如果存在更简单的做法,它会直接告诉你,而不是默认走复杂路线。先写最小实现,复杂度留给以后不写需求之外的功能,不为一行代码建抽象,不添加没被要求的灵活性和可配置性。文件里内置了一条自检标准:如果 200 行能写成 50 行,就重写。只改能交代清楚行,只清理自己弄出的垃圾每一行改动都要能追溯回你的原始请求:不改进旁边的注释和格式,不重构没坏的东西。看到无关的死代码可以提一嘴,但不许删;只清理由你自己的改动产生的孤儿导入和变量。把修好它改写成通过一个可验证的目标修这个 bug会被转写成先写一个能复现 bug 的测试,再让它通过;多步任务要拆成带验证点的计划。明确的成功标准能让 AI 独立循环迭代,而不是每隔一步就来找你确认。如何把规则接入你的项目 ⏱️只对单个项目生效:复制一个文件克隆仓库,把根目录的CLAUDE.md复制到你项目的根目录:git clone https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills如果项目里已经有CLAUDE.md,不要覆盖,把规则内容追加成一个新的章节,原有项目规则原样保留。对所有项目生效:装一个插件在 Claude Code 里执行两行命令,插件装好后规则跨项目可用:/plugin marketplace add forrestchang/andrej-karpathy-skills /plugin install andrej-karpathy-skillskarpathy-skills用 Cursor 的话Cursor 默认不读CLAUDE.md,需要把仓库里的 .cursor/rules/karpathy-guidelines.mdc 复制到你项目的.cursor/rules/目录下,再按需和已有规则合并。如何判断规则是否真的生效 ✅不用逐条背诵文件内容,用几天就能从行为变化上看出差别:动手前先提问:需求有歧义时它在写码前反问,而不是做完之后才暴露理解偏差diff 变得可解释:每一行改动都能对回你的请求,没有夹带的格式调整第一版代码就接近终稿:不再因为过度设计需要你来第二轮返工死代码只报不删:发现无关代码时它只提醒,不替你动如果这些都观察不到,先检查两件事:文件是否真的放在了项目根目录,以及当前会话启动时是否加载了它。什么时候别硬用文件自己写明了取舍:这套规则偏向谨慎而不是速度。一行修复别走全流程:改拼写、改一个明显错误的常量,走陈述假设、确认歧义的完整流程是小题大做。它的目标是降低非琐碎工作中的昂贵错误,不是拖慢简单任务。它是通用规范,不是项目规则:TypeScript 严格模式所有接口必须有测试这类项目约定,仍要你自己写进同一个CLAUDE.md,两者可以共存。它改变的是可预期性,不是模型本身:模型没有变聪明,只是行为更稳定,别把效果归因到别处。下一步:用一个需求验证它挑一个手头最小的项目,把CLAUDE.md拷到根目录,然后扔一个有歧义的需求,比如给这份数据加个批量导入功能,看它是先反问范围、格式、错误策略,还是直接开写。那个反问出现,接入就算成功了。想看更细的对比,可以打开仓库里的 EXAMPLES.md,里面给每条规则都配了行为前后的具体示例。【免费下载链接】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），仅供参考