andrej-karpathy-skills:4 条原则一份文件,让 Claude Code 少写废代码
2026/8/28 23:52:29 网站建设 项目流程

andrej-karpathy-skills:4 条原则一份文件,让 Claude Code 少写废代码

【免费下载链接】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 改一行,它顺手重构了半个文件

你让 Claude Code 改一行校验逻辑,它交回一个 diff:顺手重命名了函数、重排了注释,还改写了没人提过的参数检查。andrej-karpathy-skills 用一份 CLAUDE.md 约束 AI 编码行为:不假设、不过度工程化、不顺手重构,专治这类问题。

andrej-karpathy-skills 是什么,凭什么管用

一句话:它是放进项目根目录的一份 CLAUDE.md,你正在用的 Claude Code 每次打开你的项目都会读到它,并照着里面的规矩写代码。这份文件的核心是四条原则,它们不是四张孤立的清单,而是一条链:编码前思考要求 AI 动手前把假设摆到台面上,拿不准就先问而不是猜;简单优先让它只为当前问题写代码,不添加没被要求过的抽象和"灵活性";精准修改规定每一处改动都要能追溯到你的请求,风格上跟随你项目里已有的写法,不碰无关代码;目标驱动执行则把"修一下 bug"翻译成"先写一个能复现它的测试,再让它通过",然后循环验证直到达标。先想清楚再动手、写得简单、只改该改的、用目标验收——整条链路走完,AI 的产出才是可控的。仓库里的 EXAMPLES.md 收录了一组组正反对比示例,值得花十分钟读完。

看一组对比:如何避免 AI 过度抽象

以"加一个折扣计算函数"为例,AI 不装规范时的典型输出是这样的:

错误写法:给一个折扣上策略模式

from abc import ABC, abstractmethod class DiscountStrategy(ABC): @abstractmethod def calculate(self, amount: float) -> float: pass class PercentageDiscount(DiscountStrategy): def calculate(self, amount: float) -> float: return amount * (self.percentage / 100) # ... 后面还有 FixedDiscount、DiscountConfig、DiscountCalculator # 等 30 多行,只为一个简单计算

正确写法:一个函数就够了

def calculate_discount(amount: float, percent: float) -> float: """计算折扣金额,percent 取 0-100""" return amount * (percent / 100) # 使用 discount = calculate_discount(100.0, 10.0) # 优惠 10 美元

区别不在第一版"写得不好"——策略模式本身没有错,错在时机。还没有第二种折扣类型出现之前引入抽象,只是提前支付维护成本,还让调用方多写 30 行样板。简单版本 3 行解决今天的问题,等真需要固定金额折扣时再重构,十分钟的事。

把 andrej-karpathy-skills 装进项目只需三步

第一步,克隆规范仓库:

git clone https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills

第二步,把 CLAUDE.md 放进你的项目根目录。新项目直接复制;已有项目如果已经有 CLAUDE.md,用追加而不是覆盖,你自己的项目约定继续生效:

cp andrej-karpathy-skills/CLAUDE.md CLAUDE.md # 新项目 cat andrej-karpathy-skills/CLAUDE.md >> CLAUDE.md # 已有项目,追加

第三步,打开项目给它一个真实任务,比如修一个一行的小 bug,看它是否先交代假设、diff 里是否只有你要的改动。

怎么判断 Claude Code 的行为真的变好了

你大概会注意到三件事:diff 变短了——让改一行就只有一行和直接牵连的代码,"顺带"的注释重排消失了;AI 开始多问——需求有歧义时它先停下来澄清,而不是闷头做完再返工;PR 变干净——没有夹带重构,每一行改动都解释得清。如果一周后它还在替你重构,回头检查 CLAUDE.md 是否真的在项目根目录、是否被你项目里更靠后的自定义约定覆盖了。

现在就能做的一步

打开终端,把上面第一步那条 clone 命令跑掉,把 CLAUDE.md 丢进你最近常改的那个项目,下次任务先从一个单行 bug 开始试。

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

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

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

立即咨询