Andrej Karpathy Skills184K Star一个 CLAUDE.md 文件根治 AI 编码三大顽疾Karpathy 本人观察提炼的4大原则Claude Code Cursor 双工具支持 184K Star18.8K Fork源自 Andrej Karpathy 本人推文观察的 LLM 编码陷阱提炼为4大原则写入一个 CLAUDE.md 文件Think Before Coding不假设不隐藏困惑/ Simplicity First200行能50行就重写/ Surgical Changes只改必须改的/ Goal-Driven Execution目标驱动验证循环。直接解决 AI 编码三大顽疾错误假设过度复杂乱改无关代码。支持 Claude Code Plugin 安装 CLAUDE.md 项目级 Cursor Rules 三种方式MIT 协议一个文件即可生效 目录1. Andrej Karpathy Skills 是什么2. AI 编码三大顽疾3. 四大原则详解4. 核心洞察5. 效果验证6. 安装方式7. 与同类项目对比8. 总结与推荐1. Andrej Karpathy Skills 是什么Andrej Karpathy Skills是一个源自 Karpathy 本人观察的 Claude Code 行为优化指南。 项目地址https://github.com/multica-ai/andrej-karpathy-skills⭐ GitHub Star184K超级热门 Fork18.8K 作者multica-aiforrestchang 协议MIT 核心文件仅一个CLAUDE.md 来源Andrej Karpathy 本人的推文观察 原始推文karpathy/status/2015883857489522876️ 支持Claude Code Plugin CLAUDE.md Cursor Rules一句话总结Andrej Karpathy Skills 184K Star 的一个 CLAUDE.md 文件 源自 Karpathy 本人观察 LLM 编码陷阱 4大原则解决3大顽疾 → Think Before Coding不假设/不隐藏困惑/呈现权衡 → Simplicity First200行能50行就重写 → Surgical Changes只改必须改的/只清理自己的 → Goal-Driven Execution目标驱动验证循环 一个文件即可生效 Claude Code Cursor 双工具支持 MIT 协议 偏谨慎而非速度非琐碎任务适用2. AI 编码三大顽疾Karpathy 的原始观察❌ 顽疾1错误假设 隐藏困惑 The models make wrong assumptions on your behalf and just run along with them without checking. They dont manage their confusion, dont seek clarifications, dont surface inconsistencies, dont present tradeoffs, dont push back when they should. 翻译模型替你做错误假设然后一路跑下去 不管理困惑、不寻求澄清、不呈现不一致、 不展示权衡、不适当反驳。❌ 顽疾2过度复杂 臃肿抽象 They really like to overcomplicate code and APIs, bloat abstractions, dont clean up dead code... implement a bloated construction over 1000 lines when 100 would do. 翻译特别喜欢过度复杂化代码和API 臃肿抽象、不清理死代码 100行能搞定的事搞1000行。❌ 顽疾3乱改无关代码 They still sometimes change/remove comments and code they dont sufficiently understand as side effects, even if orthogonal to the task. 翻译有时会作为副作用改/删不完全理解的 注释和代码即使跟任务无关。三大顽疾对应四大原则顽疾对应原则错误假设 隐藏困惑Think Before Coding过度复杂 臃肿抽象Simplicity First乱改无关代码Surgical Changes缺乏验证循环Goal-Driven Execution3. 四大原则详解原则1Think Before Coding核心不假设。不隐藏困惑。呈现权衡。✅ 明确陈述假设 —— 不确定就问别猜 ✅ 呈现多种解读 —— 有歧义时不默默选一个 ✅ 适当反驳 —— 如果更简单的方案存在说出来 ✅ 困惑时停下来 —— 说出什么让你困惑请求澄清 Before implementing: → State your assumptions explicitly. If uncertain, ask. → If multiple interpretations exist, present them. → If a simpler approach exists, say so. Push back. → If something is unclear, stop. Name it. Ask.原则2Simplicity First核心最少代码解决问题。不做猜测性设计。❌ 不加没被要求的功能 ❌ 不为单次使用代码做抽象 ❌ 不加没被要求的灵活性或可配置性 ❌ 不为不可能的场景做错误处理 ❌ 200行能50行就重写 自检问题 Would a senior engineer say this is overcomplicated? 如果答案是是简化它。原则3Surgical Changes核心只改必须改的。只清理自己的。编辑现有代码时 ❌ 不改进相邻代码/注释/格式 ❌ 不重构没坏的东西 ✅ 匹配现有风格即使你不太认同 ✅ 发现无关死代码时提出来但不删除 你的改动产生孤儿时 ✅ 移除 YOUR 改动使无用的 import/变量/函数 ❌ 不移除之前就存在的死代码除非被要求 自检每一行改动都应该能追溯到用户的请求。原则4Goal-Driven Execution核心定义成功标准。循环直到验证。命令式指令→ 目标驱动转换“加验证”→ “写无效输入的测试然后让它们通过”“修Bug”→ “写一个能重现它的测试然后让它通过”“重构X”→ “确保重构前后测试都通过”多步骤任务计划模板1. [步骤] → verify: [检查] 2. [步骤] → verify: [检查] 3. [步骤] → verify: [检查]强成功标准 → LLM 可独立循环验证 弱成功标准 → 需要不断人工澄清 Dont tell it what to do, give it success criteria and watch it go. —— Andrej Karpathy4. 核心洞察Karpathy 的关键洞察LLMs are exceptionally good at looping until they meet specific goals... Dont tell it what to do, give it success criteria and watch it go. 翻译LLM 在循环直到达成特定目标方面 异常出色…… 不要告诉它做什么 给它成功标准然后看它跑。洞察应用传统方式命令式 → Add validation → AI 执行 → 人工检查 → 人工反馈 → AI 再改 → ... 目标驱动方式声明式 → Write tests for invalid inputs, then make them pass → AI 自循环写测试 → 跑测试 → 修代码 → 再跑测试 → 全通过 ✅ 区别 命令式 人必须持续监督 目标驱动 AI 自循环验证人只需确认最终结果5. 效果验证如何知道指南生效了✅ diff 中不必要改动减少 —— 只有被请求的改动出现 ✅ 因过度复杂而重写的次数减少 —— 代码第一次就简单 ✅ 澄清问题在实现之前出现 —— 而不是犯错之后 ✅ 干净的、最小化的 PR —— 没有顺手重构或改进适用边界⚠️ 这些指南偏向谨慎而非速度 ⚠️ 琐碎任务简单 typo 修复、明显的一行改动—— 不需要完整严格流程 ⚠️ 目标是减少非琐碎工作的代价性错误 不是拖慢简单任务6. 安装方式方式AClaude Code Plugin推荐# 先添加 marketplace/plugin marketplaceaddforrestchang/andrej-karpathy-skills# 再安装 plugin/plugininstallandrej-karpathy-skillskarpathy-skills✅ 跨项目全局生效 ✅ 作为 Claude Code Plugin 安装 ✅ 所有项目自动获得指南方式BCLAUDE.md项目级新项目curl-oCLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md已有项目追加echoCLAUDE.mdcurlhttps://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.mdCLAUDE.md方式CCursor Rules✅ 仓库已包含 .cursor/rules/karpathy-guidelines.mdc ✅ 打开项目时 Cursor 自动应用 ✅ 详见 CURSOR.md 了解跨项目使用自定义扩展## Project-Specific Guidelines - Use TypeScript strict mode - All API endpoints must have tests - Follow the existing error handling patterns in src/utils/errors.ts7. 与同类项目对比对比维度Andrej Karpathy SkillsClaude Code 官方 Best PracticesCursor Rules通用 AI 编程规范Star184K———来源Karpathy 本人推文Anthropic 官方社区各博主核心形式一个 CLAUDE.md多文档.cursor/rules文章/视频原则数量4大原则多条建议多条规则泛泛而谈针对顽疾✅ 3大顽疾→4原则通用建议通用建议通用建议验证循环✅ Goal-Driven❌❌❌安装方式✅ 3种Plugin/CLAUDE.md/Cursor官方文档手动配置无跨工具支持✅ Claude Code Cursor仅 Claude Code仅 Cursor无一文件生效✅❌❌❌MIT 协议✅——各异最大差异化1. 184K StarGitHub 上最火的 AI 编码行为优化项目 2. Karpathy 本人背书源自其真实推文观察 3. 一个文件生效极简安装零配置 4. 3大顽疾→4原则精准对症不是泛泛而谈 5. Goal-Driven Execution利用 LLM 循环验证的超级能力 6. 跨工具支持Claude Code Cursor 双兼容 7. 偏谨慎而非速度减少非琐碎任务的代价性错误 8. 可定制与项目特定规则合并8. 总结与推荐推荐指数⭐⭐⭐⭐⭐维度评分说明Star 热度⭐⭐⭐⭐⭐184K StarGitHub 最火来源可信⭐⭐⭐⭐⭐Karpathy 本人推文精准对症⭐⭐⭐⭐⭐3顽疾→4原则不是泛泛而谈安装极简⭐⭐⭐⭐⭐一个文件/一个 Plugin 命令跨工具⭐⭐⭐⭐⭐Claude Code Cursor可定制⭐⭐⭐⭐⭐可与项目规则合并一句话推荐如果你在用 Claude Code 或 Cursor 这个184K Star的 CLAUDE.md 是必装的。 源自 Karpathy 本人观察的 AI 编码三大顽疾 错误假设、过度复杂、乱改无关代码。 4大原则精准对症 Think Before Coding 不假设不隐藏困惑 Simplicity First 200行能50行就重写 Surgical Changes 只改必须改的 Goal-Driven Execution 给成功标准看它跑。 一个文件即可生效 Plugin 一行命令安装 Cursor Rules 自动应用。 184K Star 社区认可 MIT 协议自由使用 偏谨慎而非速度 减少非琐碎任务的代价性错误。 项目地址https://github.com/multica-ai/andrej-karpathy-skills Karpathy 推文原文链接标签#AndrejKarpathy #ClaudeCode #Cursor #CLAUDEmd #VibeCoding #AI编程 #SimplicityFirst #SurgicalChanges #GoalDriven #184KStar分类原创文章