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 个信号确认生效 🚀
主路径(只对单个项目生效):
- 克隆仓库:
git clone https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills- 把仓库根目录的
CLAUDE.md复制到你项目的根目录。 - 项目已有
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),仅供参考