3 步上手 andrej-karpathy-skills:AI 编程行为约束完整指南
2026/8/28 23:39:32 网站建设 项目流程

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),仅供参考

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

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

立即咨询