15 KiB
1
这个是预评估的项目:https://github.com/multica-ai/andrej-karpathy-skills
我现在已经安装了Superpowers,https://github.com/obra/superpowers,并且在Codex、CluadCode中使用了这些插件/Skill。
我想了解:
- andrej-karpathy-skills 是否已经被 superpowers 所覆盖
- 再安装这个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-guidelinesskill;对 Codex 来说,这个仓库本身没有明显的 Codex 插件入口,而 Superpowers 已经支持 Codex CLI / App。 - 冲突不是文件级硬冲突,主要是行为级重复/噪声冲突:Claude Code 插件技能有命名空间,理论上不会和 Superpowers 的 skill 名称直接冲突;但两个“全局编码行为约束”同时存在,容易导致技能触发冗余、上下文噪声、过度谨慎或重复提醒。Claude Code 官方文档也说明插件 skills 使用
plugin-name:skill-name命名空间,因此不会和其他层级技能直接同名冲突。(Claude Code)
推荐动作:
- 主动作:不要全局安装
andrej-karpathy-skills。 - 次动作:收藏它,把其中 2–3 条最有用的规则合并进你自己的“轻量全局守则”或项目级 AGENTS/CLAUDE 规则。
- 不建议做的事:不要用 README 里的
curl -o CLAUDE.md或curl >> CLAUDE.md直接覆盖/追加到真实项目。 这个仓库 README 明确提供了新建覆盖和已有项目追加的方式,但这很容易污染你已有的项目指令体系。(GitHub)
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)
它的插件清单也显示,插件只暴露了一个 skill:./skills/karpathy-guidelines。(GitHub)
Superpowers
Superpowers 的定位明显更重:它是“coding agents 的软件开发方法论 + composable skills”。README 描述它会从需求澄清、设计确认、实施计划、TDD、子代理执行、代码审查一直覆盖到收尾。(GitHub)
Superpowers 的基础工作流包括:
- brainstorming
- using-git-worktrees
- writing-plans
- subagent-driven-development / executing-plans
- test-driven-development
- requesting-code-review
- finishing-a-development-branch
这些已经把 Karpathy 那四条原则的大部分内容流程化了。(GitHub)
3. 覆盖关系判断
| Karpathy 原则 | Superpowers 是否覆盖 | 判断 |
|---|---|---|
| Think Before Coding:先想清楚,不要默默假设 | 高覆盖 | Superpowers 的 brainstorming 要求先理解项目、逐个澄清问题、提出 2–3 个方案和权衡,并且在用户批准设计前不进入实现。(GitHub) |
| Simplicity First:最小实现,反过度工程 | 高覆盖 | brainstorming 明确要求 YAGNI;writing-plans 要求 DRY、YAGNI、TDD;test-driven-development 要求用最小代码通过测试,避免额外功能。(GitHub) (GitHub) (GitHub) |
| Surgical Changes:只改必须改的,不顺手重构 | 中高覆盖 | Superpowers 在 brainstorming 中明确说不要提出无关重构,要聚焦当前目标;writing-plans 要求明确文件路径和任务边界;subagent-driven-development 的 spec review 也会阻止 over/under-building。(GitHub) (GitHub) (GitHub) 但 Karpathy 这条“每一行改动都要能追溯到用户请求”的表达更直接。 |
| Goal-Driven Execution:目标驱动、测试优先、可验证 | 高覆盖甚至更强 | Superpowers 的 writing-plans 要求每步有确切命令和预期输出;test-driven-development 要求先写失败测试,再写最小实现;systematic-debugging 要求先找根因、再写复现测试。(GitHub) (GitHub) (GitHub) |
总判断:Superpowers 覆盖了 andrej-karpathy-skills 约 80–90% 的实际行为目标,而且覆盖方式更工程化。
唯一值得单独吸收的是 Karpathy 里那种非常短、硬的 diff 约束:
只做必要改动;不要改邻近代码;不要顺手重构;每一行改动都必须能追溯到用户请求。
这条可以加入你的个人规则,但不需要为此再装一个全局插件。
4. 是否会引起冲突?
4.1 文件级 / 安装级冲突:低
Claude Code 官方文档说明,插件技能使用 plugin-name:skill-name 命名空间,所以插件技能不会和个人、项目或其他层级的同名技能直接冲突。(Claude Code)
也就是说,理论上:
- 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)
4.2 行为级冲突:中
真正的问题不在“冲突报错”,而在“重复约束”。
andrej-karpathy-skills 的 skill 描述非常宽泛:写代码、review、重构时都适用。(GitHub)
Superpowers 的 using-superpowers 又要求只要有 1% 可能适用,就必须先调用相关 skill。(GitHub)
这意味着:在 Claude Code 里,真实风险是模型在很多编码任务中同时认为:
superpowers:test-driven-development适用;superpowers:brainstorming适用;superpowers:writing-plans适用;andrej-karpathy-skills:karpathy-guidelines也适用。
结果可能是:
- 多调用一个宽泛 skill;
- 输出更啰嗦;
- 本来 Superpowers 已经强制 TDD / 计划 / 审查,又叠一层“别复杂化”的提醒;
- 简单任务可能更慢;
- 技能列表和描述预算更拥挤。Claude Code 文档说明 skill 名称和描述会进入技能列表预算,技能太多时可能影响描述可用性。(Claude Code)
4.3 价值冲突:中
Superpowers 是“流程强约束”。 Karpathy skill 是“行为提醒”。
两者理念并不矛盾,但 Superpowers 比 Karpathy 更强势。例如:
- Karpathy 说“简单任务可自行判断,不必每次完整流程”;
- Superpowers 的 TDD skill 则明确要求功能、bugfix、重构、行为变更都先写失败测试,除非征求人类同意例外。(GitHub)
所以同时安装后,Karpathy 不会推翻 Superpowers,反而多半只是增加一层提醒。这个提醒有时有用,但对你现在的系统来说不是高价值增量。
5. 对 Codex / Claude Code 的分别判断
Claude Code
不建议再全局安装。
原因:
- Superpowers 已经有 Claude Code 插件安装路径,而且是官方/自有 marketplace 两种方式。(GitHub)
andrej-karpathy-skills也是 Claude Code 插件,但只有一个通用 guideline skill。(GitHub)- 安装后不会明显增强工程能力,只会增加一个“宽泛行为守则”。
更好的做法是:只把 Karpathy 的 Surgical Changes 思想合并到你的个人 prompt / 项目规则中。
可以加一条类似:
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)- Superpowers README 明确支持 Codex CLI 和 Codex App,并提供 Codex 插件安装路径。(GitHub)
- 你已经在 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 系统里的第二套常驻编码准则。
最优落地方式:只吸收这一条:
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 插件。