一个 CLAUDE.md 管住 Claude Codeandrej-karpathy-skills 的4条行为准则实战指南【免费下载链接】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凌晨一点你让 Claude Code 修一个空指针异常它倒是改了但 diff 里顺手优化了旁边三个函数的注释、引号风格和错误处理。这种体验的根源是 Andrej Karpathy 对 LLM 编码陷阱的观察而 andrej-karpathy-skills 把它落成了解决方案一个 CLAUDE.md 指令文件用 4 条行为准则约束编码助手的行为边界不引入框架、不改模型。这4个改坏代码的症状你大概率都中过问题不在模型写不出代码而在它管不住自己的不确定性。默默做假设。你说加个导出数据功能它默认全量导出、默认文件格式、默认字段清单不问一句就写完了。过度工程。一个折扣计算函数它套上策略模式、抽象类、枚举和配置对象200 行代码干了 50 行的活。附带损伤。让你修 Bug它把不相关的注释改进了、格式重排了还加了一堆没人要的类型标注。无验证即交付。说修好了但没有测试证明对错只能靠你肉眼检查。andrej-karpathy-skills 就是对着这四个症状写的一页行为守则把怎么做事教给助手而不只是做什么。两分钟启用 andrej-karpathy-skills插件或 CLAUDE.md 二选一最短路径只有两条按生效范围选。方式一装成 Claude Code 插件所有项目全局生效。在 Claude Code 里依次输入/plugin marketplace add forrestchang/andrej-karpathy-skills /plugin install andrej-karpathy-skillskarpathy-skills装完即生效之后每个会话自动带上这套准则。方式二只给当前项目用。克隆仓库后把 CLAUDE.md 的内容放进你项目根目录已有同名文件就追加到末尾git clone https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skillsClaude Code 启动时会自动读取根目录的 CLAUDE.md无需其他配置。如果你用 Cursor仓库里已附带一份规则文件.cursor/rules/karpathy-guidelines.mdc拷到目标项目的同路径下即可具体说明见仓库的 CURSOR.md想作为可复用技能分发的话skills/karpathy-guidelines/SKILL.md是独立版本。CLAUDE.md 的4条行为准则逐条拆解这个文件没有任何代码和配置全部内容就是 4 条约束每条对准一个症状。先说假设再动手。为什么重要返工最多的工作都源于模型悄悄选了错误的需求解释并一路狂奔。准则要求写码前把假设写出来不确定就问存在多种解释时并排列出不许默默挑一个。例子你说让搜索变快它会先反问是响应时间、吞吐量还是感知速度并给出各自的预估工作量而不是默默上缓存加异步。只写最小必要的代码。为什么重要过度抽象不是错是时机错——在需求还没出现前就加复杂度。准则设了硬清单不加工没要求的功能、不为单次使用的代码建抽象、不加没被要求的灵活性写了 200 行能压到 50 行的重写。检验标准一句话资深工程师会说太复杂吗只改必须改的只清理自己弄出来的乱子。为什么重要顺手改进让 diff 无法审阅也让回滚失去意义。规则是不改进相邻代码、匹配现有风格哪怕你自己写法不同、发现无关死代码只提及不删除。检验标准每一行改动都能直接追溯到你的请求。给成功标准而不是步骤。为什么重要Karpathy 的原话是LLM 很擅长循环直到达成目标——你告诉它做什么它会飘告诉它达成标准是什么它会自己跑到终点。所以加校验要翻译成为无效输入写测试再让它通过多步骤任务必须先列出步骤 → 验证的简要计划。弱标准让它能跑会逼得你全程当人肉测试员。实战一次 Bug 修复里4条准则如何接力假设你的评分功能有个 Bug出现同分选手时榜单顺序每次都变。启用准则后你说修一下分数排序。没有 CLAUDE.md 时它会直接重写排序函数可能顺带重构半条数据链路现在它换了个节奏。第一步它先复述症状并确认预期行为准则一同分顺序不稳定期望稳定有序。第二步把任务翻译成可验证目标准则四先写一个测试用同分选手作为输入断言多次排序结果一致——先确认测试失败、复现出 Bug再动手改。第三步改动时只给排序键加了一个同分时的姓名 tie-breaker准则三没动注释、没动引号、没引入比较器工具类因为它判断稳定排序足够准则二。最后跑一遍既有测试确认无回归。整个交付是一个小提交一个复现测试加几行排序逻辑diff 一眼读完。谨慎优先的代价3种场景别硬套这套准则明确偏向谨慎而非速度所以它也有适用边界。琐碎任务直接跳过全套流程。改错别字、加一行明显该加的代码走完整的提问-验证流程只会让你觉得它变慢了。文件开头就声明了这个权衡非琐碎任务才值得完整严谨。别指望它替你审架构。准则约束的是行为不替代能力涉及架构级的取舍最终拍板还得是人。合并而不是替换。它设计上就是给现有 CLAUDE.md 追加用的你可以自己加一节项目规则比如所有 API 端点必须有测试但别指望这一页纸修掉模型所有的毛病。判断它是否生效也有信号diff 里无关变更变少、澄清问题出现在实现之前而不是犯错之后、代码第一次就是简单的。andrej-karpathy-skills 的全部价值就是花两分钟教会助手先问、少做、改准、验证四个习惯把代价高昂的返工变成便宜的一句澄清。下一步建议把它放进你最近最被它坑的项目盯一周的 diff你会直观看到差别。【免费下载链接】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），仅供参考