3 步上手 andrej-karpathy-skills: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 加一个"导出用户数据"功能,它没问你要哪些字段、什么格式就开写,还顺手重排了半个文件的缩进。andrej-karpathy-skills 就是冲着这类问题来的:一个给 AI 编程定规矩的开源指南项目,核心做法是往项目里放一份 CLAUDE.md,让 Claude Code 这类 LLM 编程工具不再替你偷偷做决定。
它是什么
项目把 Andrej Karpathy 对大模型写代码的观察,压缩成了一份 LLM 编程指南。Karpathy 发现模型有几类典型毛病:替你做错误假设且一路跑到底不回头核实;把百行能搞定的逻辑写成上千行;修 bug 时"误伤"任务之外的代码和注释。andrej-karpathy-skills 用一份CLAUDE.md写下四条行为准则来对症,核心思想一句话:别只下达指令,把假设显式化、把成功标准定清楚,AI 才有边界、有验收条件。
文件开头还写明了一笔取舍:准则偏向谨慎而非速度,改错别字这种小事不必全套上。
安装步骤
两种装法任选其一:Claude Code 用户推荐插件,其他工具用 CLAUDE.md。
方式一:Claude Code 插件。在 Claude Code 里依次执行两条命令,就能完成 andrej-karpathy-skills 安装:
/plugin marketplace add forrestchang/andrej-karpathy-skills /plugin install andrej-karpathy-skills@karpathy-skills装完准则以技能形式全局生效,所有项目共用一份,不用每个仓库单独配置。
方式二:放进项目根目录。先克隆仓库:
git clone https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills把仓库里的 CLAUDE.md 复制到你的项目根目录,Claude Code 会自动读取它;已有 CLAUDE.md 就把内容追加进去。用 Cursor 的话,仓库里的 CURSOR.md 有配套规则的安装说明。
四条原则怎么消化
按"写代码之前、之中、交付之前"三个阶段记,比背编号好用。
- 编码前——先思考再动手:把假设列出来,拿不准就问;需求有多种理解时把选项都摆出来,不偷偷挑一个。例:"让搜索变快"是降延迟、提并发还是改交互?先问清楚。
- 编码中——简单优先加精准修改:用能解决当前问题的最少代码,不为"以防万一"加缓存和配置项;改现有代码只动任务相关的行,风格照旧,发现无关死代码只提一嘴不删。例:三行算完的折扣别配抽象类,修空指针就只改那几行。
- 交付前——目标驱动:把模糊指令改写成可验证的成功标准,循环做到验证通过。例:"修复 bug"改成"先写一个能复现 bug 的失败测试,再让它变绿"。
条文全文在项目根目录的 CLAUDE.md,更多正反案例在 EXAMPLES.md。
一个完整实践:折扣计算
需求:写个函数算折扣。AI 的常见翻车:上来就是抽象基类、百分比策略类、固定金额策略类、配置对象加计算器入口,三十多行五个类,调用前还得先读文档。
按"简单优先",交付物应该是这个:
def discount(amount, percent): # percent 取 0 到 100 return amount * percent / 100抽象本身没错,错在时机。等"固定金额满减"这种真实需求出现,再抽接口不迟——案例文件里对这类"过度工程 vs 极简实现"的对比写得很细,值得翻一遍。
怎么判断它生效了
用上后盯四个信号,都变好才算数:
- 改动清单干净:diff 里只有你要的变更,没有搭车重排格式或"润色"注释
- 一次成型:代码第一次就简单,不用交付后再砍一轮
- 提问前置:澄清问题在动手前就提出来,而不是写歪了才回头问
- 计划先行:多步任务先给"步骤 + 验证方式"的简短计划,逐步执行逐步验证
现在就装上试试
把 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辅助生成(AIGC),仅供参考