## 项目概述

`andrej-karpathy-skills` 是一个面向 Claude Code 的行为准则/技能仓库，核心内容是一个 `CLAUDE.md` 文件。它根据 Andrej Karpathy 对 LLM 编程常见问题的观察，将改进 Claude Code 行为的原则整理为可安装、可复用的规则。仓库同时包含 Cursor 项目规则文件（`.cursor/rules/karpathy-guidelines.mdc`），并提供了 README 中文版。

## 核心功能

仓库用四个原则应对 LLM 编程中的典型问题：

| 原则 | 解决的问题 |
|-----------|-----------|
| Think Before Coding（先思考再编码） | 错误假设、隐藏困惑、缺少权衡 |
| Simplicity First（简洁优先） | 过度复杂化、抽象膨胀 |
| Surgical Changes（外科手术式修改） | 无关改动、修改不该碰的代码 |
| Goal-Driven Execution（目标驱动执行） | 通过测试优先、可验证的成功标准来驱动 |

具体包括：明确陈述假设、遇到歧义时询问、拒绝过度设计、只修改与任务直接相关的行、清理由自己改动产生的孤儿代码、用测试定义成功标准并循环验证等。

## 适用与不适用场景

根据仓库内容，适用场景包括：
- 使用 Claude Code 或 Cursor 进行非平凡编码任务时，希望减少不必要的 diff 和返工。
- 已有一定复杂度的项目，需要约束 AI 不要“顺手”改动无关代码。
- 需要将命令式任务转化为可验证目标的中长期开发任务。

不适用/需慎用场景：
- 简单拼写修正、明显的一行修改等琐碎任务（仓库明确提示不需要完整严谨流程）。
- 对速度要求极高、且错误成本很低的场景。
- 不读取 `CLAUDE.md` 或该插件规则的 AI 工具。

## 技术架构与依赖

仓库资料未提供完整技术架构或依赖清单。从现有内容看：
- 核心交付物为单个 `CLAUDE.md` 文本文件。
- 插件安装方式依赖 Claude Code 的 plugin marketplace 机制。
- 另含一个 Cursor 规则文件 `.cursor/rules/karpathy-guidelines.mdc`。
- 未提供语言、构建工具、运行时依赖等信息。

## 安装与快速开始

仓库 README 提供两种安装方式。

**方式 A：Claude Code 插件（推荐）**

在 Claude Code 中添加 marketplace：

```
/plugin marketplace add forrestchang/andrej-karpathy-skills
```

然后安装插件：

```
/plugin install andrej-karpathy-skills@karpathy-skills
```

**方式 B：CLAUDE.md（按项目）**

新项目：

```bash
curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md
```

已有项目追加：

```bash
echo "" >> CLAUDE.md
curl https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.md
```

在 Cursor 中使用时，仓库已提交 `.cursor/rules/karpathy-guidelines.mdc`，可按 `CURSOR.md` 中的说明将其用于其他项目。

## 典型使用方法

将四原则以可执行的方式嵌入工作流：

- 编码前先明确假设，遇到歧义时列出多种解释并请用户确认。
- 尽量用最少代码解决问题；不添加未被要求的特性、抽象、灵活性或错误处理。
- 修改现有代码时，不“顺手”重构、不改善相邻代码、不删除预先存在的死代码；只清理自己改动产生的未使用引用。
- 把“添加校验”改为“为无效输入写测试并让测试通过”；把“修复 Bug”改为“先写复现测试再修复”。

多步骤任务可先列计划：

```
1. [步骤] → 验证: [检查项]
2. [步骤] → 验证: [检查项]
3. [步骤] → 验证: [检查项]
```

## 配置与部署要点

- 这些规则适合与项目专属规则合并，可写入已有 `CLAUDE.md` 或新建一个。
- 可在 `CLAUDE.md` 中追加“Project-Specific Guidelines”小节，加入 TypeScript strict、API 测试要求等具体约定。
- 插件方式安装后，技能可在所有项目中生效；`CLAUDE.md` 方式则只影响单个项目。
- Cursor 用户可参考 `CURSOR.md` 和 `.cursor/rules/karpathy-guidelines.mdc` 配置文件。
- 仓库提示这些准则偏向“谨慎优先于速度”，琐碎任务可自行判断是否完整执行。

## 限制、风险与许可证

- 许可证：README 声明为 MIT。仓库元数据未提供 license 字段，但 README 明确写出 MIT。
- 适用范围有限：它不能替代调试或项目架构决策，只约束代码生成行为。
- 过度谨慎可能降低简单任务的速度；仓库已给出权衡说明。
- 安装命令中的 marketplace 地址为 `forrestchang/andrej-karpathy-skills`，与当前仓库地址 `multica-ai/andrej-karpathy-skills` 不一致，使用前请确认实际可用的 marketplace 路径。
- 仓库未提供 release、changelog、issue 模板或贡献指南。

## 官方链接

- GitHub 仓库：https://github.com/multica-ai/andrej-karpathy-skills
- 英文 README：https://github.com/multica-ai/andrej-karpathy-skills#readme
- 简体中文 README：https://github.com/multica-ai/andrej-karpathy-skills/blob/main/README.zh.md
- 作者 X 账号：https://x.com/jiayuan_jy
- 关联项目 Multica：https://github.com/multica-ai/multica

## 信息来源和分析时间

信息来源：GitHub 仓库元数据（owner、url、description）及 README.md；仓库未包含 documents 或 latestRelease 内容。分析时间：2026-04-27。