andrej-karpathy-skills:1 个 CLAUDE.md 文件,4 条原则治住 AI 编程助手
2026/9/18 16:57:27 网站建设 项目流程

andrej-karpathy-skills:1 个 CLAUDE.md 文件,4 条原则治住 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 助手说"加个导出用户数据的功能",没加约束时它连问都不问:全量用户、JSON 格式、存当前目录,直接写出来。andrej-karpathy-skills把 Andrej Karpathy(知名 AI 工程师)观察到的 LLM 写代码陷阱,提炼成 4 条行为规则,全部写进一个CLAUDE.md文件——这正是 Claude Code 启动时会自动读取的行为规范。整个项目就这一个核心文件,拷进项目根目录,30 秒生效。

核心机制:一个 CLAUDE.md 如何约束 AI 行为 🔍

Claude Code 有个内置机制:每次会话启动时读取项目根目录的CLAUDE.md,把它当行为准则执行。这个项目提供的就是这份文件(另附 Cursor 的对应规则),把 4 条工程师常识写成了强制条款:

  • 先想再写:动手前把假设明确说出来;需求有歧义时列出多种解释让你挑,禁止默默选一个继续做。
  • 简洁优先:只写解决问题所需的最少代码;200 行能压到 50 行,就重写。
  • 精准修改:只动和任务有关的行,不改注释、不顺手调格式、不删预先存在的死代码。
  • 目标驱动执行:把"修这个 bug"改写成"先写一个能复现 bug 的测试,再让它通过",循环验证到达成。

两组场景对比,价值秒懂。

"加个导出用户数据的功能":无约束时,它默默导出全部用户、默认 JSON、保存位置自己定;有约束时,它先反问导出范围、输出格式、包含哪些字段、数据量多大,你答完才动手。

"写个计算折扣的函数":无约束时,常见交付是抽象基类加策略模式加配置对象,30 行起步的搭配套路;有约束时,交付一个 3 行函数——等真出现"多种折扣类型"的需求,再加复杂度。

想看 8 组完整的真实代码对照,可以翻 EXAMPLES.md。

最快配置方法:30 秒放文件,4 个信号确认生效 🚀

主路径(只对单个项目生效):

  1. 克隆仓库:
git clone https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills
  1. 把仓库根目录的CLAUDE.md复制到你项目的根目录。
  2. 项目已有CLAUDE.md时,追加而非覆盖:把 4 条原则补成新章节,原有项目规则保留。

备选路径(对所有项目生效):在 Claude Code 里装插件,两行命令,跨项目通用:

/plugin marketplace add forrestchang/andrej-karpathy-skills /plugin install andrej-karpathy-skills@karpathy-skills

装完不用读文件,用几天盯这 4 个信号:

  • 提问提前了:需求有歧义时它动手前先反问,理解偏差不再做完才暴露。
  • diff 能看进去了:每行改动都追溯到你的原始要求,没有夹带的格式调整和"顺手改进"。
  • 代码一次成型:简单需求不再附带"看起来很资深"的抽象层,重写次数明显变少。
  • 不主动重构了:发现无关死代码只提醒、不删除,只清理自己改动产生的孤儿代码。

如果几个信号都没出现,先查两件事:文件是否真的在项目根目录、会话启动时有没有加载它。

适用边界:这两类情况可以跳过这套规范 ⚠️

文件自己写明了取舍:这套规范偏向谨慎,牺牲速度。改拼写错误、明显的一行修复,走完整的"陈述假设、确认歧义"流程是小题大做——它的价值是降低非琐碎工作的昂贵错误,不是拖慢简单任务。

另外两条提醒:

  • 通用规范 ≠ 项目规则:它只约束"AI 怎么干活",不约束"你的项目怎么干活"。"TypeScript 严格模式""所有 API 必须有测试"这类条款仍需你自己写进同一个CLAUDE.md,两者可共存。
  • 客户端有差异:你用 Cursor 的话,它默认不读CLAUDE.md,需要把仓库.cursor/rules/下的规则文件拷进自己项目才生效,步骤见 CURSOR.md。

它没教 AI 任何新知识,只是在每个动作入口装了红绿灯:先停,想清楚,再开工。最低成本试法:把CLAUDE.md拷进你手上最小的项目,扔一句"把搜索功能变快",看它是直接堆缓存和索引,还是先问你要的是响应时间、并发量还是感知速度——肯问的那次,就值了。

【免费下载链接】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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询