一份 CLAUDE.md 驯服 AI 编程三大坏毛病：andrej-karpathy-skills 快速上手指南

一份 CLAUDE.md 驯服 AI 编程三大坏毛病andrej-karpathy-skills 快速上手指南【免费下载链接】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它顺手把整个函数的引号换成了双引号、补上一堆没人要的类型注解还删了一段看起来没用的死代码。代码是修好了你的 code review 却要翻两倍的量确认它没顺手改坏别的。这类糟心事的根源不是模型不行而是没人告诉它边界在哪。andrej-karpathy-skills 就是为这件事做的一个开源项目它把 Andrej Karpathy 对 LLM 编程坑位的观察压缩成一份 核心指南文件给 AI 编程行为加上一套约束让 diff 变干净、返工变少。三步跑起来从 clone 到验证生效拿到核心文件。仓库地址https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skillsgit clone https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills按你的工具做最小配置。用 Claude Code 的话直接在会话里装官方插件全局生效/plugin marketplace add forrestchang/andrej-karpathy-skills /plugin install andrej-karpathy-skillskarpathy-skills用 Cursor 的话把仓库里的.cursor/rules/karpathy-guidelines.mdc复制到你项目的.cursor/rules/目录下它带了alwaysApply: true打开项目即生效详见 Cursor 使用说明。其他只认根目录说明文件工具的话把 CLAUDE.md 拷到项目根目录即可已有该文件就追加合并别覆盖。验证准则真的生效了。装完别急着干正事丢一个故意模糊的小任务比如帮我把搜索变快一点。AI 先反问是响应时间、并发量还是体验问题说明准则在工作它直接闷头开始加缓存、加索引说明没接上回头检查安装步骤。它到底改变了什么四条准则逐条拆解这份准则就四句话能概括完的东西核心是把模糊指令转成可验证目标。逐条看它怎么管住 AI 的手准则管住什么编码前思考场景一句导出用户数据范围、格式、字段全是没说清的信息。做法AI 先列出自己的假设、把多种解释摆出来、没把握就停住提问而不是挑一个解释闷头跑完。效果方向性错误在动手前被拦下而不是交付后你才发现它导出了不该导出的东西。简单优先场景一个百分比折扣计算AI 爱给你整出策略模式加配置类的抽象。做法只写解决当前问题的最小代码没被要求的灵活性一概不加200 行能压到 50 行就重写。效果代码第一次提交就够简洁不用等你喊这也太复杂了再返工。外科手术式修改场景修一个校验 bugAI 习惯顺手重排格式、改注释、补注解。做法只动与任务直接相关的行匹配现有代码风格发现无关死代码只报告不删自己改动产生的孤儿代码才负责清理。效果diff 里每一行变更都能追溯回你的原始请求review 一眼看完。目标驱动执行场景修好认证系统这种话没有验收标准AI 只能靠猜。做法把任务转成为非法输入写测试再让它通过先写复现 bug 的测试再修重构前后测试全绿。效果AI 能自己循环到验证通过你不用全程盯着逐条确认。这里有个值得记住的洞察LLM 特别擅长朝着明确目标循环迭代。所以别告诉它做什么给它成功标准然后看着它自己跑。示例文档 里按这四条准则整理了十几组真实代码正反例比如加速率限制任务被拆成每步一个验证点的渐进计划比通读规则更能帮你建立直觉。同一个需求装没装准则的差别说个典型的下午你让 AI 加个计算折扣的小函数。没上准则时它给你端回来一个 30 多行的策略模式——抽象基类、枚举、工厂方法齐活仿佛你明天就要支持八种折扣。第二天你让它修个邮箱校验的 bug它顺手把整个函数的引号统一了、加了类型注解还删掉一段它判断为无用的旧逻辑。代码确实修好了但 PR 里混进了你根本没授权的变更。装上准则后同样的两件事折扣函数是三行就完事的写法真要多种折扣时再抽象不迟修 bug 的 diff 只剩邮箱校验那两行的痕迹旁边那段可疑的死代码它只在回复里提了一句这个函数从没被调用过没有擅自删。最明显的变化是 AI 开始先问你丢一句导出用户数据它先问哪些字段、什么格式、大概多少条再动手——假设被摆上了台面而不是埋进代码里等你踩雷。# 没装准则策略模式 配置类30 行起 class DiscountStrategy(ABC): abstractmethod def calculate(self, amount): ... # 装上之后 def calculate_discount(amount, percent): return amount * (percent / 100)新手容易踩的坑这份指南是万能的吗不是。它把高频失误压下去不保证零失误。测试、代码审查该有还是要有的它解决的是AI 自己给自己挖的坑替代不了验收环节。是不是每个任务都得走全套流程不用。修个拼写错误不需要列假设、写验证计划。指南开头就写了它的取舍是谨慎优先于速度琐碎任务用你自己的判断就行别为了仪式感拖慢简单活。我用的是 Cursor还需要 CLAUDE.md 吗各走各的配置Claude Code 认根目录的 CLAUDE.mdCursor 读.cursor/rules/下的规则文件两者内容一致、互不冲突。团队项目建议根目录放一份 CLAUDE.md让每个人的 AI 都受同一套约束。下一步就一件事这份指南的价值一句话能说完它不教 AI 写代码而是约束 AI 的行为让 diff 更干净、返工更少、提问出现在动手之前而不是事故之后。把 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辅助生成（AIGC），仅供参考