andrej-karpathy-skills 中文教程：把规则合并进项目，不要覆盖项目事实
andrej-karpathy-skills 的主体是一份 CLAUDE.md。它试图纠正编码代理的四种常见问题：未经确认就假设、把简单问题做复杂、顺手修改无关代码，以及没有清楚的完成标准。
1. 四条原则分别管什么
| 原则 | 要解决的问题 | 验收方法 |
|---|---|---|
| Think Before Coding | 把不确定的理解当成事实 | 实现前是否写清假设与歧义 |
| Simplicity First | 添加未要求的抽象和配置 | 改动是否是当前需求所需的最小范围 |
| Surgical Changes | 重构相邻代码或改动无关格式 | 每一行 diff 能否对应用户请求 |
| Goal-Driven Execution | 完成标准模糊，无法自检 | 是否先定义复现、测试或可观察结果 |
这些是行为规则。项目怎样启动、跑哪些测试、哪些目录不能改、怎样处理密钥，仍要由项目自己的 CLAUDE.md 或文档明确规定。
2. 安全合并，不要直接覆盖
官方 README 给出插件安装和 curl 写文件两种方法。实际使用时，先在浏览器打开 CLAUDE.md 并人工合并。已有文件尤其不能用下载命令覆盖。
# 先备份
cp CLAUDE.md CLAUDE.md.before-karpathy
# 下载到临时文件，不直接覆盖
curl -o /tmp/karpathy-guidelines.md \
https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/CLAUDE.md
diff -u CLAUDE.md /tmp/karpathy-guidelines.md保留项目原来的构建命令、安全限制和代码规范，只加入确实缺失的原则。若已经通过插件加载这组规则，就不要再把相同内容复制到项目文件。
3. 仓库迁移后的地址问题
仓库当前位于 multica-ai 组织，但 README 的 marketplace 命令与 raw URL 仍写 forrestchang。GitHub 当前能重定向旧地址，长期依赖重定向仍有风险。安装插件前应打开当前仓库的 .claude-plugin 清单，手工下载则使用当前 owner，并记录 commit。
官方 Releases 页面为空，所以没有可锁定的正式版本号。团队采用时应把具体 commit 写进内部记录。
4. 怎么验证它有没有用
选两个规模相近的小任务，保持模型、仓库和上下文相同，一次使用原规则，一次加入这四条规则。记录：
- 与需求无关的 diff 行数；
- 实现后返工次数；
- 运行了哪些测试，是否先复现错误；
- 澄清问题是否发生在编码之前；
- 人工审查是否发现过度抽象。
单次体验不能证明普遍提升。规则也可能让简单拼写修复变慢，README 自己在 Tradeoff Note 中要求对小改动酌情使用。
5. 和 Anthropic 官方 Agent Skills 的区别
相比 Anthropic 官方 skills 仓库，本项目是一套适合常驻项目上下文的通用编码基线。Anthropic 的 Agent Skill 是按任务加载的文件夹，以带 name、description 的 SKILL.md 为入口，还可以附脚本和资源。
编码纪律可以放在 CLAUDE.md；PDF、测试、发布等专门流程更适合独立 Skill。若同一内容同时出现在项目规则、插件和 Skill 中，会浪费上下文，也可能形成冲突。
6. 验证状态与验证边界
验证边界：没有验证旧 owner 重定向的长期稳定性、插件 marketplace 安装、Cursor 自动加载、不同模型的规则遵循率或代码质量提升。文中的验收指标是建议方法，不是项目已经公布的对照实验结果。
这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。
先判断这个项目是否适合你
近期变化与关注原因
项目针对编码代理常见的错误假设、过度设计和顺手改代码，文件少、容易阅读和复制。它降低了制定团队 AI 编码基线的门槛，但规则是提示层约束，实际效果仍取决于模型、任务、现有项目说明和验收方法。
原教程未展开的系统信息
架构与数据流
CLAUDE.md 是核心文本；README 提供安装和取舍说明；CURSOR.md 与 .cursor/rules/karpathy-guidelines.mdc 适配 Cursor；skills/karpathy-guidelines/SKILL.md 提供技能载体；.claude-plugin 目录支持 marketplace。仓库没有应用运行时、服务器或模型，只在客户端加载上下文时影响行为。
常见问题
andrej-karpathy-skills 是可执行软件吗？
不是。核心是 Markdown 规则和插件配置，没有服务器或应用运行时。它通过编码代理读取指令来影响行为。
仓库已经迁到 multica-ai，旧安装命令还能用吗？
README 仍使用 forrestchang 地址，GitHub 当前会把仓库重定向到 multica-ai。为减少以后重定向失效的风险，安装前应打开当前仓库并核对 marketplace 清单，手工复制时使用当前内容。
可以用 curl 直接覆盖现有 CLAUDE.md 吗？
不建议。新建项目也应先阅读文件；已有项目要比较和合并，避免覆盖测试命令、安全规则和团队约定。
四条规则能证明代码质量提高吗？
不能直接证明。可以在同类任务中记录无关 diff、返工次数、测试通过率和人工审查意见，再判断这套规则对自己的模型和仓库是否有效。