# 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*