别让 AI 把你的代码改得面目全非andrej-karpathy-skills 的 CLAUDE.md 行为指南快速上手【免费下载链接】andrej-karpathy-skillsA single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathys observations on LLM coding pitfalls.项目地址: https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills你让 AI 修一个小 bug打开 diff 一看bug 是修了但旁边十几行无关代码也被顺手收拾过——注释被重写、引号风格被换掉、甚至有它未必真懂的代码被删了。这种情况你遇到过吗andrej-karpathy-skills 就是冲着这类问题来的。它把 Andrej Karpathy 对 LLM 编程通病的观察浓缩成一份CLAUDE.md行为指南文件AI 读到它之后会先问清楚再动手、用最少的代码解决问题、只改该改的行、并且用可验证的标准来判定完成。整个项目的核心就是这一份指南。 先跑起来三步启用1. 拿到仓库git clone https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills2. 用 Claude Code 的人二选一把CLAUDE.md放进目标项目根目录。项目已有同名文件就把内容追加到末尾或者装成插件一次覆盖所有项目。在 Claude Code 中依次输入/plugin marketplace add forrestchang/andrej-karpathy-skills然后/plugin install andrej-karpathy-skillskarpathy-skills。3. 用 Cursor 等其他工具这类工具默认不读CLAUDE.md。把指南内容放到对应规则文件里即可比如 Cursor 放.cursor/rules/karpathy-guidelines.mdc——仓库里已提交了一份直接拷过去就能用。放好之后正常开工就行。指南在会话开始时自动生效不需要额外调用。 机制拆解一条重新定义工作方式的四步工作流不用把四条原则当守则背。它们串起来其实是一条完整的工作流想清楚 → 少做点 → 改到位 → 有标准。第一步先想清楚别假设写码之前AI 必须把假设摊开哪些是猜的、哪些是确定的一个需求有多种理解时全部列出来而不是默默挑一个困惑就停下来问别硬编。它到底在防什么AI 代你做错误假设然后自信地一路跑下去。最贵的往往不是写错的代码而是走错的方向。第二步少做点别做满解决问题的最少代码。没被要求的功能不加、一次性逻辑不抽抽象、没人提过的可配置性不做。内置的自检很朴素一个资深工程师会说这过度复杂吗会就重写。它到底在防什么那种100 行能搞定非要写成 1000 行框架的冲动。第三步改到位别改全改现有代码时只碰和任务直接相关的行。风格跟随现状——哪怕你更讨厌这种写法。发现无关的死代码提一嘴就好别删。只清理你自己改动产生的孤儿代码。自检口径每一行改动都应该能直接追溯到你的原始请求。它到底在防什么diff 被顺手重构污染code review 从此变刑讯。第四步有标准再动手把指令改写成可验证的目标。添加验证变成先写无效输入的测试再让它们通过修 bug变成先写一个能复现 bug 的测试。多步任务则要求 AI 逐步列出步骤 → 验证方式。它到底在防什么拿让它能跑当验收标准。标准弱循环的是你标准强循环的才是 AI。⚖️ 前后对比diff 到底会变成什么样例子一加个折扣计算函数改之前AI 常见产出抽象基类、策略模式、配置对象30 多行算一个折扣还得先实例化一套策略。改之后它大概只写def calculate_discount(amount: float, percent: float) - float: return amount * (percent / 100)等哪天真的需要多种折扣类型再重构。一天都不早。例子二给上传函数加日志改之前AI 会顺手把单引号换成双引号、补上类型标注和 docstring、把布尔返回逻辑重排一遍——整个函数体面目全非而你要的只是几行日志。改之后diff 里只有logger和三条日志调用引号、缩进、命名全部和现有代码保持一致。两个例子的共同点改之前的代码不算错它符合设计模式错在时机。复杂度加早了理解、测试、维护的成本全都提前支付。✅ 自查5 个信号看它是否生效用几天之后对照下面几条勾选diff 里只有你要的改动没有顺带的重写AI 在动手前提澄清问题而不是在翻车后解释第一版代码不过度设计你不用再说一句能不能简单点修 bug 时AI 会先写复现测试而不是直接改逻辑PR 小而干净没有 drive-by 重构两个最容易踩的误区给小事套全流程。指南自己就声明了谨慎优先于速度改个错别字不需要走四步用判断力否则简单任务会变繁琐。放错位置。Cursor 这类工具默认不读CLAUDE.md指南必须进对应工具自己的规则体系否则等于不存在。 进阶玩法合并进你自己的项目规则。这份指南天生为合并设计在CLAUDE.md后加一节项目特定指南写上所有 API 必须带测试之类的约定通用准则和项目习惯就合为一体了。通读一遍对照案例。仓库里的EXAMPLES.md对每条原则都配了改前改后对照包括限速器的分步实现和测试先行的修 bug 流程。看一遍比读十遍原则更快建立直觉。现在就开始把CLAUDE.md丢进你的项目根目录下次打开 diff 时看看它是不是比从前干净了一些。别告诉 AI 该做什么——给它一个成功标准然后看它工作。【免费下载链接】andrej-karpathy-skillsA single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathys observations on LLM coding pitfalls.项目地址: https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 别让 AI 把你的代码改得面目全非：andrej-karpathy-skills 的 CLAUDE.md 行为指南快速上手
别让 AI 把你的代码改得面目全非andrej-karpathy-skills 的 CLAUDE.md 行为指南快速上手【免费下载链接】andrej-karpathy-skillsA single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathys observations on LLM coding pitfalls.项目地址: https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills你让 AI 修一个小 bug打开 diff 一看bug 是修了但旁边十几行无关代码也被顺手收拾过——注释被重写、引号风格被换掉、甚至有它未必真懂的代码被删了。这种情况你遇到过吗andrej-karpathy-skills 就是冲着这类问题来的。它把 Andrej Karpathy 对 LLM 编程通病的观察浓缩成一份CLAUDE.md行为指南文件AI 读到它之后会先问清楚再动手、用最少的代码解决问题、只改该改的行、并且用可验证的标准来判定完成。整个项目的核心就是这一份指南。 先跑起来三步启用1. 拿到仓库git clone https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills2. 用 Claude Code 的人二选一把CLAUDE.md放进目标项目根目录。项目已有同名文件就把内容追加到末尾或者装成插件一次覆盖所有项目。在 Claude Code 中依次输入/plugin marketplace add forrestchang/andrej-karpathy-skills然后/plugin install andrej-karpathy-skillskarpathy-skills。3. 用 Cursor 等其他工具这类工具默认不读CLAUDE.md。把指南内容放到对应规则文件里即可比如 Cursor 放.cursor/rules/karpathy-guidelines.mdc——仓库里已提交了一份直接拷过去就能用。放好之后正常开工就行。指南在会话开始时自动生效不需要额外调用。 机制拆解一条重新定义工作方式的四步工作流不用把四条原则当守则背。它们串起来其实是一条完整的工作流想清楚 → 少做点 → 改到位 → 有标准。第一步先想清楚别假设写码之前AI 必须把假设摊开哪些是猜的、哪些是确定的一个需求有多种理解时全部列出来而不是默默挑一个困惑就停下来问别硬编。它到底在防什么AI 代你做错误假设然后自信地一路跑下去。最贵的往往不是写错的代码而是走错的方向。第二步少做点别做满解决问题的最少代码。没被要求的功能不加、一次性逻辑不抽抽象、没人提过的可配置性不做。内置的自检很朴素一个资深工程师会说这过度复杂吗会就重写。它到底在防什么那种100 行能搞定非要写成 1000 行框架的冲动。第三步改到位别改全改现有代码时只碰和任务直接相关的行。风格跟随现状——哪怕你更讨厌这种写法。发现无关的死代码提一嘴就好别删。只清理你自己改动产生的孤儿代码。自检口径每一行改动都应该能直接追溯到你的原始请求。它到底在防什么diff 被顺手重构污染code review 从此变刑讯。第四步有标准再动手把指令改写成可验证的目标。添加验证变成先写无效输入的测试再让它们通过修 bug变成先写一个能复现 bug 的测试。多步任务则要求 AI 逐步列出步骤 → 验证方式。它到底在防什么拿让它能跑当验收标准。标准弱循环的是你标准强循环的才是 AI。⚖️ 前后对比diff 到底会变成什么样例子一加个折扣计算函数改之前AI 常见产出抽象基类、策略模式、配置对象30 多行算一个折扣还得先实例化一套策略。改之后它大概只写def calculate_discount(amount: float, percent: float) - float: return amount * (percent / 100)等哪天真的需要多种折扣类型再重构。一天都不早。例子二给上传函数加日志改之前AI 会顺手把单引号换成双引号、补上类型标注和 docstring、把布尔返回逻辑重排一遍——整个函数体面目全非而你要的只是几行日志。改之后diff 里只有logger和三条日志调用引号、缩进、命名全部和现有代码保持一致。两个例子的共同点改之前的代码不算错它符合设计模式错在时机。复杂度加早了理解、测试、维护的成本全都提前支付。✅ 自查5 个信号看它是否生效用几天之后对照下面几条勾选diff 里只有你要的改动没有顺带的重写AI 在动手前提澄清问题而不是在翻车后解释第一版代码不过度设计你不用再说一句能不能简单点修 bug 时AI 会先写复现测试而不是直接改逻辑PR 小而干净没有 drive-by 重构两个最容易踩的误区给小事套全流程。指南自己就声明了谨慎优先于速度改个错别字不需要走四步用判断力否则简单任务会变繁琐。放错位置。Cursor 这类工具默认不读CLAUDE.md指南必须进对应工具自己的规则体系否则等于不存在。 进阶玩法合并进你自己的项目规则。这份指南天生为合并设计在CLAUDE.md后加一节项目特定指南写上所有 API 必须带测试之类的约定通用准则和项目习惯就合为一体了。通读一遍对照案例。仓库里的EXAMPLES.md对每条原则都配了改前改后对照包括限速器的分步实现和测试先行的修 bug 流程。看一遍比读十遍原则更快建立直觉。现在就开始把CLAUDE.md丢进你的项目根目录下次打开 diff 时看看它是不是比从前干净了一些。别告诉 AI 该做什么——给它一个成功标准然后看它工作。【免费下载链接】andrej-karpathy-skillsA single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathys observations on LLM coding pitfalls.项目地址: https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考