一份 CLAUDE.md四条行为准则让 AI 编程助手先确认再动手【免费下载链接】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 不再擅自假设、不再堆砌代码、不再顺手乱改无关代码。日常使用 AI 编程工具的人都能用装完之后的收益很具体你下次看 diff记录代码改动前后的差异时应该只找到你要的变更。Karpathy 注意到的三种跑偏行为Karpathy 对大模型写代码的总结可以概括成三点模型会替你做出错误假设然后闷头往下跑、从不核对它喜欢把代码和接口过度复杂化100 行能写完的事能撑到一千行它还会改动甚至删除自己没真正理解的代码和注释哪怕这些改动跟任务毫无关系。对应的场景你大概率也撞上过默默选一种解释就开干。你说把数据导出到文件它直接把整张用户表生成了 CSV不问你范围、不问你字段、不问你文件放哪。抽象越堆越高。你只需要一个算折扣的函数它给出策略基类、配置对象、校验层用的时候要先写 30 行初始化。顺手重构。你让它给函数加日志它把单引号全换成双引号、给签名补类型标注顺手重写了整个函数体。问题不在模型不够聪明而在它缺少分寸感。这个项目补的就是这层分寸先问清楚再动手先写最短的版本只碰该碰的行。四条准则逐条拆解1. Think Before Coding管住默默假设具体要求动手前把假设明确说出来拿不准就问存在多种理解时并排列出不悄悄选一条有简单的做法就直说该反驳时就反驳有看不懂的地方就停下说清卡在哪生效的标志澄清问题发生在代码出现之前而不是返工之后。2. Simplicity First管住代码膨胀只写被要求的功能不加没被要求的灵活性和可配置性一次性代码不做抽象不可能出现的场景不做容错200 行能压到 50 行就重写自查标准资深工程师会不会说这太复杂了生效的标志第一版代码就是可以直接用的规模你很少需要说能不能简单点。3. Surgical Changes管住顺手改无关代码不改进相邻行的注释、格式和风格匹配现有风格不重构没坏的东西发现无关死代码只报告不删除只清理你自己改动弄出来的孤儿变量和导入生效的标志diff 里每一行都能追溯到本次请求说不清来路的行没有出现的资格。4. Goal-Driven Execution管住修一下没有终点把模糊指令翻译成可验证目标加校验→先写非法输入测试再让它通过多步任务按步骤 → 验证方式推进给它明确的成功标准它能自己循环到通过标准模糊就得靠你不断追问生效的标志它主动给出计划每一步都带着验证方式。两条安装路径再合并你自己的项目规则路径 AClaude Code 插件一次装好最省事装一次在你所有项目里通用。在 Claude Code 的终端里依次输入/plugin marketplace add forrestchang/andrej-karpathy-skills /plugin install andrej-karpathy-skillskarpathy-skills路径 B把 CLAUDE.md 放进项目根目录想按项目控制、或用其他工具clone 仓库后复制文件git clone https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills cp andrej-karpathy-skills/CLAUDE.md 你的项目根目录/CLAUDE.md项目里已有 CLAUDE.md 时别覆盖用追加cat andrej-karpathy-skills/CLAUDE.md CLAUDE.md把自己的项目规则合并进同一文件这份文件本来就设计为与你自己的指令合并在文末加一节即可## 项目特定规则 - 前端使用 React TypeScript - 涉及 API 的改动必须附带测试用 Cursor 的话把仓库里的.cursor/rules/karpathy-guidelines.mdc拷到目标项目的.cursor/rules/目录即可生效说明见 CURSOR.md其他只认根目录指令文件的工具直接放 CLAUDE.md 就行。装上之后同一个 bug 的样子拿一个小任务举例订单金额出现负数时合计算错了。装前 AI 的常见做法修复合计的同时加上两行日志、把浮点四舍五入换成Decimal、给函数签名补上类型标注还顺手给支付失败加了重试。真正的修复就藏在一片变更里看代码的人得自己把它找出来。装后 diff 的样子def total(prices): - return sum(prices) if any(p 0 for p in prices): raise ValueError(price must be non-negative) return sum(prices)三行新增每一行都对应负数金额这件事。边界、取舍与常见疑问改个错别字也要走全套流程吗不用。文件里写明琐碎任务凭判断处理。规则针对的是非琐碎工作目标是在这类工作上减少昂贵的失误而不是拖慢简单任务。只有 Claude Code 才能用吗不是。准则本质是一份 Markdown 行为约定任何支持根目录指令文件的工具都能放。仓库还带了 Cursor 规则文件和 SKILL.md 形式的技能定义按工具各取所需。会不会变啰嗦、变慢动手前它确实多想多问前期节奏体感会慢一点。换来的是返工变少少一些重写一遍的要求也少一些看代码时这行为啥改的疑问。文件原文把取舍写得很直白——谨慎优先于速度。现在就做的三步通读一遍 CLAUDE.md整套准则就浓缩在这一个文件里想看反模式和正确做法的更多对照再翻 EXAMPLES.md装到你改动最频繁的那个项目里盯住下一个 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），仅供参考