243 lines
15 KiB
Markdown
243 lines
15 KiB
Markdown
# 1
|
||
|
||
这个是预评估的项目：`https://github.com/multica-ai/andrej-karpathy-skills`
|
||
|
||
我现在已经安装了Superpowers，`https://github.com/obra/superpowers`，并且在Codex、CluadCode中使用了这些插件/Skill。
|
||
|
||
我想了解：
|
||
1. andrej-karpathy-skills 是否已经被 superpowers 所覆盖
|
||
2. 再安装这个andrej-karpathy-skills 是否还有价值，是否会引起冲突。
|
||
|
||
# 预评估：andrej-karpathy-skills vs Superpowers
|
||
|
||
## 1. 快速结论
|
||
|
||
**结论：`andrej-karpathy-skills` 的核心价值已经被 Superpowers 高度覆盖。你现在不建议再全局安装它。**
|
||
|
||
更准确地说：
|
||
|
||
* **不是 100% 文本级覆盖**：`andrej-karpathy-skills` 有一条很清晰的“轻量行为守则”，尤其是 **Surgical Changes / 只做必要改动** 这部分表达得很直接。
|
||
* **但在工程工作流层面，Superpowers 覆盖得更深**：Superpowers 已经把“先澄清、少假设、YAGNI、TDD、验证、代码审查、子代理执行、不要乱改”这些原则拆进了多个强制工作流技能里。它不是一条提醒，而是一整套流程。
|
||
* **再安装的边际收益低**：对 Claude Code 来说，安装后通常只是多一个非常宽泛的 `karpathy-guidelines` skill；对 Codex 来说，这个仓库本身没有明显的 Codex 插件入口，而 Superpowers 已经支持 Codex CLI / App。
|
||
* **冲突不是文件级硬冲突，主要是行为级重复/噪声冲突**：Claude Code 插件技能有命名空间，理论上不会和 Superpowers 的 skill 名称直接冲突；但两个“全局编码行为约束”同时存在，容易导致技能触发冗余、上下文噪声、过度谨慎或重复提醒。Claude Code 官方文档也说明插件 skills 使用 `plugin-name:skill-name` 命名空间，因此不会和其他层级技能直接同名冲突。([Claude Code][1])
|
||
|
||
**推荐动作：**
|
||
|
||
* **主动作：不要全局安装 `andrej-karpathy-skills`。**
|
||
* **次动作：收藏它，把其中 2–3 条最有用的规则合并进你自己的“轻量全局守则”或项目级 AGENTS/CLAUDE 规则。**
|
||
* **不建议做的事：不要用 README 里的 `curl -o CLAUDE.md` 或 `curl >> CLAUDE.md` 直接覆盖/追加到真实项目。** 这个仓库 README 明确提供了新建覆盖和已有项目追加的方式，但这很容易污染你已有的项目指令体系。([GitHub][2])
|
||
|
||
---
|
||
|
||
## 2. 两个项目的真实定位差异
|
||
|
||
### `andrej-karpathy-skills`
|
||
|
||
它不是一个完整的 Agent 框架，也不是复杂工具集。它的本质是：
|
||
|
||
> 一个单技能 / 单 CLAUDE.md 级别的行为提醒，用来减少 LLM 编码时的常见坏习惯。
|
||
|
||
仓库 README 也直接说它是 “A single `CLAUDE.md` file”，核心围绕四条原则：**Think Before Coding、Simplicity First、Surgical Changes、Goal-Driven Execution**。([GitHub][2])
|
||
它的插件清单也显示，插件只暴露了一个 skill：`./skills/karpathy-guidelines`。([GitHub][3])
|
||
|
||
### Superpowers
|
||
|
||
Superpowers 的定位明显更重：它是“coding agents 的软件开发方法论 + composable skills”。README 描述它会从需求澄清、设计确认、实施计划、TDD、子代理执行、代码审查一直覆盖到收尾。([GitHub][4])
|
||
|
||
Superpowers 的基础工作流包括：
|
||
|
||
* brainstorming
|
||
* using-git-worktrees
|
||
* writing-plans
|
||
* subagent-driven-development / executing-plans
|
||
* test-driven-development
|
||
* requesting-code-review
|
||
* finishing-a-development-branch
|
||
|
||
这些已经把 Karpathy 那四条原则的大部分内容流程化了。([GitHub][4])
|
||
|
||
---
|
||
|
||
## 3. 覆盖关系判断
|
||
|
||
| Karpathy 原则 | Superpowers 是否覆盖 | 判断 |
|
||
| ----------------------------------- | ---------------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||
| Think Before Coding：先想清楚，不要默默假设 | **高覆盖** | Superpowers 的 `brainstorming` 要求先理解项目、逐个澄清问题、提出 2–3 个方案和权衡，并且在用户批准设计前不进入实现。([GitHub][5]) |
|
||
| Simplicity First：最小实现，反过度工程 | **高覆盖** | `brainstorming` 明确要求 YAGNI；`writing-plans` 要求 DRY、YAGNI、TDD；`test-driven-development` 要求用最小代码通过测试，避免额外功能。([GitHub][5]) ([GitHub][6]) ([GitHub][7]) |
|
||
| Surgical Changes：只改必须改的，不顺手重构 | **中高覆盖** | Superpowers 在 `brainstorming` 中明确说不要提出无关重构，要聚焦当前目标；`writing-plans` 要求明确文件路径和任务边界；`subagent-driven-development` 的 spec review 也会阻止 over/under-building。([GitHub][5]) ([GitHub][6]) ([GitHub][8]) 但 Karpathy 这条“每一行改动都要能追溯到用户请求”的表达更直接。 |
|
||
| Goal-Driven Execution：目标驱动、测试优先、可验证 | **高覆盖甚至更强** | Superpowers 的 `writing-plans` 要求每步有确切命令和预期输出；`test-driven-development` 要求先写失败测试，再写最小实现；`systematic-debugging` 要求先找根因、再写复现测试。([GitHub][6]) ([GitHub][7]) ([GitHub][9]) |
|
||
|
||
**总判断：Superpowers 覆盖了 `andrej-karpathy-skills` 约 80–90% 的实际行为目标，而且覆盖方式更工程化。**
|
||
|
||
唯一值得单独吸收的是 Karpathy 里那种非常短、硬的 diff 约束：
|
||
|
||
> 只做必要改动；不要改邻近代码；不要顺手重构；每一行改动都必须能追溯到用户请求。
|
||
|
||
这条可以加入你的个人规则，但不需要为此再装一个全局插件。
|
||
|
||
---
|
||
|
||
## 4. 是否会引起冲突？
|
||
|
||
## 4.1 文件级 / 安装级冲突：低
|
||
|
||
Claude Code 官方文档说明，插件技能使用 `plugin-name:skill-name` 命名空间，所以插件技能不会和个人、项目或其他层级的同名技能直接冲突。([Claude Code][1])
|
||
|
||
也就是说，理论上：
|
||
|
||
* Superpowers 里的技能会是类似 `superpowers:brainstorming`
|
||
* Karpathy 插件里的技能会是类似 `andrej-karpathy-skills:karpathy-guidelines`
|
||
|
||
所以**不会因为 skill 名称一样而覆盖 Superpowers**。
|
||
|
||
但注意：如果你采用 `andrej-karpathy-skills` README 的 **CLAUDE.md 方式**，尤其是 `curl -o CLAUDE.md` 或 `curl >> CLAUDE.md`，就不再是插件命名空间隔离，而是直接改项目指令文件。这个风险比插件安装更高。([GitHub][2])
|
||
|
||
## 4.2 行为级冲突：中
|
||
|
||
真正的问题不在“冲突报错”，而在“重复约束”。
|
||
|
||
`andrej-karpathy-skills` 的 skill 描述非常宽泛：写代码、review、重构时都适用。([GitHub][10])
|
||
Superpowers 的 `using-superpowers` 又要求只要有 1% 可能适用，就必须先调用相关 skill。([GitHub][11])
|
||
|
||
这意味着：在 Claude Code 里，真实风险是模型在很多编码任务中同时认为：
|
||
|
||
* `superpowers:test-driven-development` 适用；
|
||
* `superpowers:brainstorming` 适用；
|
||
* `superpowers:writing-plans` 适用；
|
||
* `andrej-karpathy-skills:karpathy-guidelines` 也适用。
|
||
|
||
结果可能是：
|
||
|
||
* 多调用一个宽泛 skill；
|
||
* 输出更啰嗦；
|
||
* 本来 Superpowers 已经强制 TDD / 计划 / 审查，又叠一层“别复杂化”的提醒；
|
||
* 简单任务可能更慢；
|
||
* 技能列表和描述预算更拥挤。Claude Code 文档说明 skill 名称和描述会进入技能列表预算，技能太多时可能影响描述可用性。([Claude Code][1])
|
||
|
||
## 4.3 价值冲突：中
|
||
|
||
Superpowers 是“流程强约束”。
|
||
Karpathy skill 是“行为提醒”。
|
||
|
||
两者理念并不矛盾，但 Superpowers 比 Karpathy 更强势。例如：
|
||
|
||
* Karpathy 说“简单任务可自行判断，不必每次完整流程”；
|
||
* Superpowers 的 TDD skill 则明确要求功能、bugfix、重构、行为变更都先写失败测试，除非征求人类同意例外。([GitHub][7])
|
||
|
||
所以同时安装后，Karpathy 不会推翻 Superpowers，反而多半只是增加一层提醒。这个提醒有时有用，但对你现在的系统来说**不是高价值增量**。
|
||
|
||
---
|
||
|
||
## 5. 对 Codex / Claude Code 的分别判断
|
||
|
||
### Claude Code
|
||
|
||
**不建议再全局安装。**
|
||
|
||
原因：
|
||
|
||
* Superpowers 已经有 Claude Code 插件安装路径，而且是官方/自有 marketplace 两种方式。([GitHub][4])
|
||
* `andrej-karpathy-skills` 也是 Claude Code 插件，但只有一个通用 guideline skill。([GitHub][3])
|
||
* 安装后不会明显增强工程能力，只会增加一个“宽泛行为守则”。
|
||
|
||
更好的做法是：**只把 Karpathy 的 Surgical Changes 思想合并到你的个人 prompt / 项目规则中。**
|
||
|
||
可以加一条类似：
|
||
|
||
```text
|
||
When modifying an existing codebase, make surgical changes only. Do not refactor, reformat, rename, clean up adjacent code, or remove pre-existing dead code unless explicitly asked. Every changed line must trace directly to the requested task.
|
||
```
|
||
|
||
这比安装整个插件更干净。
|
||
|
||
### Codex
|
||
|
||
**基本不建议为 Codex 额外折腾这个仓库。**
|
||
|
||
原因：
|
||
|
||
* `andrej-karpathy-skills` 仓库根目录能看到 `.claude-plugin`、`.cursor/rules`、`skills/karpathy-guidelines`、`CLAUDE.md`、`CURSOR.md` 等文件，但未看到 `.codex-plugin` 入口。([GitHub][2])
|
||
* Superpowers README 明确支持 Codex CLI 和 Codex App，并提供 Codex 插件安装路径。([GitHub][4])
|
||
* 你已经在 Codex 中使用 Superpowers，再手工搬运 Karpathy 规则，收益很小。
|
||
|
||
---
|
||
|
||
## 6. 是否还有安装价值？
|
||
|
||
| 场景 | 是否值得安装 |
|
||
| ----------------------------------------- | ------------------------------- |
|
||
| 你还没装 Superpowers，只想要一个轻量 Claude Code 行为守则 | 值得试 |
|
||
| 你已经在 Claude Code 安装并使用 Superpowers | **不建议安装** |
|
||
| 你想让 Claude 更少乱改 diff | 不建议装插件，建议摘取 Surgical Changes 规则 |
|
||
| 你想在 Codex 中增强工作流 | 用 Superpowers，不用这个 |
|
||
| 你想学习 Skill 写法 | 可以收藏参考 |
|
||
| 你想纳入长期系统 | 只纳入一小段规则，不纳入插件 |
|
||
|
||
---
|
||
|
||
## 7. 对你当前系统的适配判断
|
||
|
||
结合你长期关注 AI Skill / Agent / 自动化、Windows 本地和 CentOS 远程两套环境的优先级，`andrej-karpathy-skills` 不涉及 GPU、Docker、数据库、向量库、API Key 或本地模型，安装成本很低；但它对你当前已安装 Superpowers 的系统来说，**不是能力补齐型项目，而是重复提醒型项目**。
|
||
|
||
| 维度 | 判断 |
|
||
| ------------------- | ---------------------------------------- |
|
||
| AI Skill / Agent 价值 | 中：是一个单 skill，但不是系统级框架 |
|
||
| 自动化工作流价值 | 低：没有执行节点、工具调用、脚本、MCP |
|
||
| 长期系统融合价值 | 低到中：适合抽取规则，不适合全局插件化 |
|
||
| 论文 / 知识管理 / 写作 | 低：主要是编码行为准则 |
|
||
| Windows 本地可行性 | 高：没有运行依赖 |
|
||
| CentOS 远程可行性 | 高但没必要：不是服务，不需要部署 |
|
||
| 与 Superpowers 互补性 | 低到中：只在 “surgical diff discipline” 上有轻微补强 |
|
||
| 冲突风险 | 文件冲突低，行为冗余中 |
|
||
| 推荐动作 | 收藏 + 摘规则，不安装 |
|
||
|
||
---
|
||
|
||
## 8. 最终建议
|
||
|
||
**我的建议：不要再安装 `andrej-karpathy-skills`。**
|
||
|
||
你现在已经装了 Superpowers，而且在 Codex、Claude Code 中使用。Superpowers 已经覆盖了：
|
||
|
||
* 需求澄清；
|
||
* 方案权衡；
|
||
* YAGNI；
|
||
* TDD；
|
||
* 计划拆解；
|
||
* 验证；
|
||
* 代码审查；
|
||
* 子代理执行；
|
||
* debug 根因分析；
|
||
* 防止 over/under-building。
|
||
|
||
`andrej-karpathy-skills` 更适合作为：
|
||
|
||
* **收藏参考**
|
||
* **Prompt 片段来源**
|
||
* **Skill 写法样例**
|
||
* **补充到个人规则中的短句**
|
||
|
||
不适合作为你当前 Superpowers 系统里的第二套常驻编码准则。
|
||
|
||
**最优落地方式：只吸收这一条：**
|
||
|
||
```text
|
||
Make surgical changes only. Do not refactor, reformat, rename, clean up adjacent code, or remove pre-existing dead code unless explicitly asked. Every changed line must trace directly to the user’s request.
|
||
```
|
||
|
||
这条可以加进你的全局 Codex / Claude Code 个人规则，或者放进你自己的“AI 编码行为基线”Skill，而不是安装整个 `andrej-karpathy-skills` 插件。
|
||
|
||
[1]: https://code.claude.com/docs/en/skills?utm_source=chatgpt.com "Extend Claude with skills - Claude Code Docs"
|
||
[2]: https://github.com/multica-ai/andrej-karpathy-skills?utm_source=chatgpt.com "GitHub - multica-ai/andrej-karpathy-skills: A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls. · GitHub"
|
||
[3]: https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/.claude-plugin/plugin.json?utm_source=chatgpt.com "raw.githubusercontent.com"
|
||
[4]: https://github.com/obra/superpowers?utm_source=chatgpt.com "GitHub - obra/superpowers: An agentic skills framework & software development methodology that works. · GitHub"
|
||
[5]: https://raw.githubusercontent.com/obra/superpowers/main/skills/brainstorming/SKILL.md?utm_source=chatgpt.com "raw.githubusercontent.com"
|
||
[6]: https://raw.githubusercontent.com/obra/superpowers/main/skills/writing-plans/SKILL.md?utm_source=chatgpt.com "raw.githubusercontent.com"
|
||
[7]: https://raw.githubusercontent.com/obra/superpowers/main/skills/test-driven-development/SKILL.md?utm_source=chatgpt.com "raw.githubusercontent.com"
|
||
[8]: https://raw.githubusercontent.com/obra/superpowers/main/skills/subagent-driven-development/SKILL.md?utm_source=chatgpt.com "raw.githubusercontent.com"
|
||
[9]: https://raw.githubusercontent.com/obra/superpowers/main/skills/systematic-debugging/SKILL.md?utm_source=chatgpt.com "raw.githubusercontent.com"
|
||
[10]: https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/skills/karpathy-guidelines/SKILL.md?utm_source=chatgpt.com "raw.githubusercontent.com"
|
||
[11]: https://raw.githubusercontent.com/obra/superpowers/main/skills/using-superpowers/SKILL.md?utm_source=chatgpt.com "raw.githubusercontent.com"
|
||
|
||
|