diff --git a/AI工程/AndrejKarpathySkills.md b/AI工程/AndrejKarpathySkills.md new file mode 100755 index 0000000..c1698d3 --- /dev/null +++ b/AI工程/AndrejKarpathySkills.md @@ -0,0 +1,221 @@ +# Andrej Karpathy Skills 研究 + +> 基于 Karpathy 洞察的 AI 编程行为指南 +> +> 归档:2026-04-23 + +--- + +## 📊 项目概览 + +| 项目 | Stars | 定位 | +|------|-------|------| +| **andrej-karpathy-skills** | ⭐ 79,105 | 核心 CLAUDE.md 行为指南 | +| **karpathy-wiki** | ⭐ 66 | LLM Wiki 模式(知识库) | +| **superpowers-zh** | ⭐ 1,331 | 含 Karpathy 汉化版 | + +**来源**:[Andrej Karpathy 的推文](https://x.com/karpathy/status/2015883857489522876) + +--- + +## 💡 核心洞察 + +Karpathy 指出 AI 编程的**四大问题**: + +> "模型会替你做出错误假设并一路走下去。它们不管理困惑、不寻求澄清、不暴露矛盾、不展示权衡、不该推的时候不推。" + +> "它们喜欢过度复杂化代码和 API、膨胀抽象、不清理死代码……用 1000 行实现 100 行就能搞定的事。" + +> "它们有时会修改/删除它们不理解的代码和注释,即使与任务无关。" + +--- + +## 🎯 四大原则 + +### 原则 1: Think Before Coding(先思考再编码) + +**解决问题**:错误假设、隐藏困惑、缺少权衡 + +| 行为 | 说明 | +|------|------| +| 明确假设 | 不确定就问,不要猜 | +| 多种解读 | 有歧义时不要默默选择 | +| 该推就推 | 有更简单方法就说出来 | +| 困惑就停 | 说清哪里不清楚并询问 | + +### 原则 2: Simplicity First(简单优先) + +**解决问题**:过度复杂化、膨胀抽象 + +| 规则 | 说明 | +|------|------| +| ❌ 不要额外功能 | 只做被要求的 | +| ❌ 不要一次性抽象 | 只有一处用就别抽象 | +| ❌ 不要"灵活性" | 没要求就别做 | +| ❌ 不要不可能场景的错误处理 | 过度防御 | +| ✅ 200 行能改 50 行就重写 | 保持简洁 | + +**测试标准**:资深工程师会说这过度复杂吗?如果是,简化。 + +### 原则 3: Surgical Changes(精准修改) + +**解决问题**:无关修改、碰不该碰的代码 + +| 规则 | 说明 | +|------|------| +| ❌ 不要"改进"相邻代码 | 只改必须改的 | +| ❌ 不要重构没坏的东西 | | +| ✅ 匹配现有风格 | 即使你会不同做法 | +| ✅ 发现死代码提一嘴 | 但别删(除非被要求) | +| ✅ 清理自己引入的孤儿 | 自己的垃圾自己收拾 | + +**测试标准**:每行变更都能追溯到用户需求。 + +### 原则 4: Goal-Driven Execution(目标驱动执行) + +**解决问题**:模糊的成功标准、反复沟通 + +| 不要说 | 应该说 | +|--------|--------| +| "加验证" | "写无效输入测试,然后让它通过" | +| "修 Bug" | "写复现测试,然后修复" | +| "重构 X" | "确保重构前后测试通过" | + +**Karpathy 原话**: +> "LLM 非常擅长循环直到达成具体目标……不要告诉它怎么做,给它成功标准然后看它干活。" + +--- + +## 🚀 安装方式 + +### Claude Code 插件(推荐) + +```bash +/plugin marketplace add forrestchang/andrej-karpathy-skills +/plugin install andrej-karpathy-skills@karpathy-skills +``` + +### 项目级 CLAUDE.md + +```bash +# 新项目 +curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md + +# 已有项目(追加) +curl https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.md +``` + +### Cursor + +项目自带 `.cursor/rules/karpathy-guidelines.mdc` + +--- + +## 📋 效果检验 + +| ✅ 好的信号 | ❌ 不好的信号 | +|-----------|-------------| +| Diff 里只有被要求的变更 | 大量无关修改 | +| 代码第一次就简洁 | 因为过度复杂重写 | +| 实现前会提问题 | 做完才发现理解错了 | +| PR 干净最小 | 附带重构和"改进" | + +--- + +## 🧠 Karpathy Wiki(衍生项目) + +**项目**:[toolboxmd/karpathy-wiki](https://github.com/toolboxmd/karpathy-wiki) + +**定位**:基于 Karpathy LLM Wiki 模式的持久知识库技能 + +### 两种 Wiki + +| 类型 | 用途 | +|------|------| +| **Research Wiki** | 研究/学习/个人知识管理 | +| **Project Wiki** | 代码库文档自动生成 | + +### 三层结构 + +``` +Raw Sources(原始资料) + ↓ +The Wiki(LLM 生成的结构化知识库) + ↓ +The Schema(SKILL.md 定义规范) +``` + +### 三种操作 + +| 操作 | 说明 | +|------|------| +| **Ingest** | 处理新资料,更新 10-15 页 | +| **Query** | 搜索知识库,合成答案 | +| **Lint** | 健康检查:矛盾、过期、孤立页面 | + +### 安装 + +```bash +# 通用知识库 +cp -r karpathy-wiki ~/.claude/skills/wiki + +# 项目知识库 +cp -r karpathy-project-wiki ~/.claude/skills/project-wiki +``` + +### 使用 + +``` +"Initialize a wiki for my research on [topic]" +"Initialize a project wiki for this codebase" +``` + +**自动触发**: +- 添加新资料到 `raw/` +- 问综合问题("比较 A 和 B") +- 请求健康检查("lint the wiki") + +--- + +## 🌐 中文版本 + +**项目**:[vtroisWhite/andrej-karpathy-skills](https://github.com/vtroisWhite/andrej-karpathy-skills) ⭐ 87 + +完整简体中文翻译。 + +--- + +## 📊 对比 Superpowers + +| 维度 | Karpathy Skills | Superpowers | +|------|----------------|-------------| +| **Stars** | 79k | 159k | +| **定位** | 行为准则 | 完整方法论 | +| **复杂度** | 单文件 | 20+ Skills | +| **安装** | 一个 CLAUDE.md | 插件系统 | +| **适用** | 所有 AI 编程工具 | 需 Skills 支持的工具 | +| **互补** | ✅ 可以一起用 | ✅ 可以一起用 | + +--- + +## 🔗 资源 + +| 资源 | 链接 | +|------|------| +| 英文原版 | https://github.com/forrestchang/andrej-karpathy-skills | +| 中文版 | https://github.com/vtroisWhite/andrej-karpathy-skills | +| Karpathy Wiki | https://github.com/toolboxmd/karpathy-wiki | +| 原始推文 | https://x.com/karpathy/status/2015883857489522876 | + +--- + +## AI工程索引 + +相关笔记: +- [[INDEX_AI工程]] - AI工程知识索引 +- [[ClaudeCode完全研究]] - Claude Code 完整指南 +- [[ClaudeCodeSuperpowers]] - Superpowers 方法论 + +--- + +*整理:知识库管理员 | 归档:2026-04-23* \ No newline at end of file