这是一个把 Andrej Karpathy 关于 LLM 编码常见毛病的观察,提炼成一份 CLAUDE.md 指南的项目(作者 jiayuan_jy/forrestchang,现归 multica-ai 组织)。它不是软件,而是一份可直接放进项目的配置/规则文件:用四条原则纠正 AI 编码助手的典型问题——Think Before Coding(别擅自假设、暴露困惑、给权衡)、Simplicity First(只写解决问题的最少代码、不过度抽象)、Surgical Changes(只改该改的、别顺手重构)、Goal-Driven Execution(把命令式任务转成可验证目标,让模型自己 loop)。配套 CURSOR.md、Cursor 规则文件和 Claude Code 插件,README 标注 MIT。
来源:README The Problems/Solution/License;GitHub desc 查看 GitHub 仓库 →约 14.5 万星、1.4 万 fork——是同类「提示词/配置」类仓库里星标极高的一个。爆火原因很直接:它绑定了 Karpathy 这个顶级背书,把他广为流传的「模型会擅自假设、过度复杂化、乱动不该动的代码」吐槽,整理成一份照着抄就能改善 Claude Code/Cursor 行为的极简清单,零门槛、即抄即用、共鸣强,社交传播力极大。
来源:GitHub 144,735 stars / 14,820 forks,created 2026-01-27;README 来源 Karpathy 推文强制显式推理:不确定就问而非猜、存在歧义时给出多种解读而非沉默选一、有更简方案就直说、困惑时点明不清之处并求澄清,针对模型「擅自假设、隐藏困惑、不给权衡」的毛病。
来源:README The Four Principles - 1只写解决问题的最少代码:不加未要求的功能/抽象/可配置性、不为不可能的场景写错误处理;判据是「资深工程师会不会觉得过度复杂」,能 50 行就别写 200 行。
来源:README The Four Principles - 2只动必须动的:不顺手改相邻代码/注释/格式、不重构没坏的东西、匹配现有风格;只清理自己改动产生的孤儿 import/变量,发现既有 dead code 只提示不删;判据是每一行改动都能直接追溯到用户需求。
来源:README The Four Principles - 3把命令式任务转成可验证目标(如「加校验」→「先写非法输入的测试再让它通过」),多步任务给出带 verify 的简短计划;强成功标准让模型能独立 loop,弱标准(『让它能用』)则需反复澄清。
来源:README The Four Principles - 4/Key Insight可作 Claude Code 插件安装(/plugin marketplace add 后 install,跨项目生效),或把 CLAUDE.md 直接 curl 进新/旧项目;含 Cursor 规则文件(.cursor/rules/karpathy-guidelines.mdc)与 CURSOR.md;设计为可与项目自有指令合并。
来源:README Install/Using with Cursor/Customization这是一个「配置/文档」型仓库,没有可执行代码,文件极少但组织清晰:CLAUDE.md 是核心指南(四原则),CURSOR.md 和 .cursor/rules/karpathy-guidelines.mdc 把同一套规则适配到 Cursor,skills/karpathy-guidelines/SKILL.md 把它包成一个 agent skill,.claude-plugin/marketplace.json + plugin.json 让它能作为 Claude Code 插件分发,EXAMPLES.md 给示例,README.md/README.zh.md 提供中英文说明。本质是把一套「人审过的编码行为约束」用多种载体(CLAUDE.md / Cursor rule / skill / plugin)打包,方便不同工具直接加载。
来源:tree(CLAUDE.md、CURSOR.md、.cursor/rules、skills/、.claude-plugin/、EXAMPLES.md)中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成
Claude Code (CLAUDE.md / plugin)Cursor (.cursor/rules)Agent Skill 格式适合:①用 Claude Code/Cursor 等编码 agent、苦于模型擅自假设/过度复杂/乱改无关代码的开发者,想要一份立刻见效的行为约束;②团队想统一 AI 编码规范、并入自己 CLAUDE.md 的场景;③想理解「如何给 agent 写有效约束」的人,可当范本学习。不适合:不使用支持 CLAUDE.md/规则文件的 agent 的人;以及期待它是某种工具/框架的人——它只是一份指南,效果取决于底层模型是否遵循。对极简单改动(typo、明显一行)也不必上全套。
来源:README How to Know It's Working/Tradeoff Note/Customization仓库无正式 GitHub Release,以配置文件形式维护,最近一次更新在 2026-04-20;仓库已从 forrestchang 迁到 multica-ai 组织,README 顶部引流到作者的新项目 Multica(管理编码 agent 与可复用 skill 的开源平台)。
来源:GitHub pushed_at 2026-04-20、full_name=multica-ai/andrej-karpathy-skills;README 顶部 Multica 链接这个项目的价值不在代码——它根本没有代码——而在于把 Karpathy 对 LLM 编码毛病的精辟吐槽,浓缩成四条可操作、可合并、即抄即用的约束,正好戳中每个 Claude Code/Cursor 用户的痛处,加上顶级背书,14.5 万星更多是话题与共鸣的产物。把它当作一份高质量的「AI 编码行为基线」并入自己的 CLAUDE.md,确实能减少擅自假设、过度复杂和乱改代码的情况,性价比很高。但要清醒:它是软约束、效果靠模型自觉,内容也偏通用原则,真正起作用还需结合项目自身规范。值得抄一份用,别期待它是什么神器。
来源:综合 README 定位/原则、tree(纯配置)、星标与更新状态的事实判断这是一个把 Andrej Karpathy 关于 LLM 编码常见毛病的观察,提炼成一份 CLAUDE.md 指南的项目(作者 jiayuan_jy/forrestchang,现归 multica-ai 组织)。
andrej-karpathy-skills 的核心功能包括:Think Before Coding、Simplicity First、Surgical Changes、Goal-Driven Execution、多端安装与可合并。
约 14.5 万星、1.4 万 fork——是同类「提示词/配置」类仓库里星标极高的一个。爆火原因很直接:它绑定了 Karpathy 这个顶级背书,把他广为流传的「模型会擅自假设、过度复杂化、乱动不该动的代码」吐槽,整理成一份照着抄就能改善 Claude Code/Cursor 行为的极简清单,零门槛、即抄即用、共鸣强,社交传播力极大。
适合:①用 Claude Code/Cursor 等编码 agent、苦于模型擅自假设/过度复杂/乱改无关代码的开发者,想要一份立刻见效的行为约束;②团队想统一 AI 编码规范、并入自己 CLAUDE.md 的场景;③想理解「如何给 agent 写有效约束」的人,可当范本学习。不适合:不使用支持 CLAUDE.md/规则文件的 agent 的人;以及期待它是某种工具/框架的人——它只是一份指南,效果取决于底层模型是否遵循。