andrej-karpathy-skills:一个 CLAUDE.md 管住 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 助手总爱自作主张,100 行能写完的活它硬写 1000 行,修个 bug 还顺手重排半个文件。andrej-karpathy-skills 用一个 CLAUDE.md 行为规范文件治它。机制很轻:Claude Code 每次开会话都会读项目根目录的 CLAUDE.md,把它当行为标准。把 Karpathy 总结的 4 条写码毛病写进去,助手就得照办。
拆开看:一个文件,4 条硬规则 📜
它借的是宿主工具自带的机制:Claude Code 启动即读 CLAUDE.md,这个仓库就是把条款写全。4 条规则:
- 先想再写:假设要明说,有多个理解就摆出来让你选,不许偷偷定一个。
- 简洁优先:只写最少的代码,200 行能压到 50 行就必须重写。
- 精准修改:只动任务相关的行,死代码只报告不删,注释格式不碰。
- 目标驱动:"修 bug"改写成"先写复现它的测试,再让它通过"。
两句话的需求,两种结局 ⚖️
"加个导出用户数据的功能"——
没有它:默认导出全部用户、JSON 格式、存当前目录,直接开写。 有了它:先反问全量还是子集?什么格式?包含哪些字段?答完才动手。
"写个算折扣的函数"——
没有它:抽象基类加策略模式加配置对象,30 多行架子才算一个数。 有了它:一个几行的普通函数,真出现多种折扣类型的需求时再加复杂度。
仓库里的 EXAMPLES.md 给每条规则都配了正反例。
3 步装进项目 🚀
- 克隆仓库,把根目录的 CLAUDE.md 拷到你项目根目录:
git clone https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills cp andrej-karpathy-skills/CLAUDE.md 你项目根目录/- 项目已有 CLAUDE.md 的别覆盖,把 4 条原则追加成新章节,原规则保留。
- 开个新会话,从这次对话起规则生效。
备选路径:在 Claude Code 里装插件,所有项目生效,只需 2 行:
/plugin marketplace add forrestchang/andrej-karpathy-skills /plugin install andrej-karpathy-skills@karpathy-skills确认它在工作:4 个可观察的信号 🔍
- 提问提前了:有歧义的需求,它在动手前就反问。
- diff 变干净:每行改动都能对回你的原话,没有夹带的格式调整。
- 代码一次成型:简单需求不再附带"资深感"的抽象层。
- 不主动重构:发现无关死代码只提醒,不顺手删。
一个信号都没出现?先确认文件真在项目根目录,再确认是装完后新开的会话。
它故意偏慢,这类任务别套
文件自己写了取舍:规则偏"谨慎",不偏"速度"。改拼写、明显的一行修改,走完整流程是小题大做。
两条提醒:
- 它是通用规范,不是项目规则。"严格模式""接口要有测试"这类话,还得你自己写进同一个文件,两者可以共存。
- 你用 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),仅供参考