# 1

这个是预评估的项目：`https://github.com/addyosmani/agent-skills`

我现在已经安装了Superpowers，`https://github.com/obra/superpowers`，并且在Codex、CluadCode中使用了这些插件/Skill。

我想了解：
1. agent-skills 与 superpowers 的异同点，再安装
2. 再安装这个agent-skills 是否还有价值，是否会引起冲突。

# 预评估结论：agent-skills 是否值得在已有 Superpowers 后再装？

结论：**不要无脑全局安装；有价值，但更适合作为“补充 Skill 库 + 按需调用的工程检查清单”，而不是替代 Superpowers 的主工作流。**

你的判断优先级是 AI Skill / Agent / 自动化、长期系统融合、知识管理/写作、本地低成本和架构借鉴，这类项目确实对口；你的环境也主要依赖 Codex / Claude Code，而不是本地 GPU 或 Docker 服务。
但在你已经安装 Superpowers 的前提下，**agent-skills 的主要风险不是文件冲突，而是“行为冲突 / 路由冲突 / 过度流程化”。**

我的建议：

* **Claude Code：可以试装，但不要马上作为长期全局默认。**先在一个小测试仓库里启用，观察 `/spec`、`/plan`、`/review`、`/ship` 是否比 Superpowers 更适合你的工作流。
* **Codex：不建议整包安装为长期全局技能集。**更建议只抽取 5–8 个 Superpowers 没覆盖好的 skills，放到个人或项目级 skills 目录。
* **长期系统：值得收藏、拆解、二次改造成你自己的 Skill。**尤其是 `source-driven-development`、`doubt-driven-development`、`context-engineering`、`documentation-and-adrs`、`security-and-hardening`、`performance-optimization` 这类技能，比它的完整生命周期命令更有增量价值。

---

## 1. 一句话区别

**Superpowers 是一套“强主导的软件开发方法论”。**它从会话开始就介入，自动引导 brainstorming、计划、TDD、subagent 开发、代码审查和收尾流程；README 明确说它会在你开始构建时先后退一步询问目标、形成 spec、写计划，并在你说 go 后进入 subagent-driven development。([GitHub][1])

**agent-skills 是一套“工程生命周期 Skill 包”。**它把软件开发拆成 Define → Plan → Build → Verify → Review → Ship，并提供 `/spec`、`/plan`、`/build`、`/test`、`/review`、`/code-simplify`、`/ship` 等命令入口。([GitHub][2])

换句话说：

| 维度     | Superpowers        | agent-skills                |
| ------ | ------------------ | --------------------------- |
| 核心定位   | 主工作流 / 方法论         | 工程 Skill 包 / 生命周期工具箱        |
| 使用方式   | 自动触发为主             | Slash commands + skill 自动匹配 |
| 风格     | 强约束、强 TDD、强流程      | 更模块化，覆盖面更广                  |
| 最适合    | 让 Agent 按一套固定开发法工作 | 给 Agent 增加更多工程专项能力          |
| 对你当前价值 | 已经是主干              | 更适合补充、抽取、改造                 |

---

## 2. 它们的重叠点很大

Superpowers 已经覆盖了这些核心流程：

* brainstorming
* writing-plans
* executing-plans
* subagent-driven-development
* test-driven-development
* requesting-code-review
* finishing-a-development-branch
* systematic-debugging
* verification-before-completion
  Superpowers README 把这些列为 Basic Workflow / Skills Library，并强调 agent 会在任务前检查相关 skill，属于“mandatory workflows, not suggestions”。([GitHub][1])

agent-skills 也覆盖了类似链路：

* `interview-me`
* `idea-refine`
* `spec-driven-development`
* `planning-and-task-breakdown`
* `incremental-implementation`
* `test-driven-development`
* `debugging-and-error-recovery`
* `code-review-and-quality`
* `shipping-and-launch`
  README 说明它包含 24 个 skills，并按 Define、Plan、Build、Verify、Review、Ship 分层。([GitHub][2])

所以如果你问“它是不是 Superpowers 的替代品？”——**不是。**
如果你问“已经有 Superpowers 后，它是不是还有增量？”——**有，但主要在专项工程能力，而不是基础开发流程。**

---

## 3. agent-skills 对 Superpowers 的真实增量

我认为最有价值的增量不是 `/spec`、`/plan`、`/build` 这些基础命令，而是下面这些 Superpowers 没那么细分、或不以同样方式表达的工程 Skill：

| agent-skills 增量 Skill               | 对你的价值                                                      |
| ----------------------------------- | ---------------------------------------------------------- |
| `source-driven-development`         | 要求框架/库决策基于官方文档、验证并标注未验证内容；适合你让 Codex/Claude Code 做高可信工程修改。 |
| `doubt-driven-development`          | 对高风险决策做对抗式复核；适合安全、生产、迁移、复杂重构前使用。                           |
| `context-engineering`               | 适合你长期构建 Agent / Skill / CCRA 系统，关注如何给 Agent 喂上下文。          |
| `api-and-interface-design`          | 适合接口、模块边界、长期系统抽象。                                          |
| `frontend-ui-engineering`           | 如果你做前端 UI、组件、设计系统，有明显补充价值。                                 |
| `security-and-hardening`            | 适合远程服务、Dify/OpenClaw、公网部署前检查。                              |
| `performance-optimization`          | 对 Web 性能、Core Web Vitals、profiling 有专项价值。                  |
| `documentation-and-adrs`            | 很适合你的知识管理、长期系统沉淀、架构决策记录。                                   |
| `observability-and-instrumentation` | 对远程服务、Agent 服务化、自动化系统长期维护有价值。                              |

agent-skills 的 README 明确列出 API、UI、source-driven、doubt-driven、安全、性能、ADR、可观测性、CI/CD、迁移等专项 skill。([GitHub][2])

---

## 4. 是否会引起冲突？

### 4.1 文件层面：低风险

两个项目的插件名不同：

* Superpowers 的 Claude 插件名是 `superpowers`。([GitHub][3])
* agent-skills 的 Claude 插件名是 `agent-skills`，并声明了 `commands`、`skills`、`agents` 路径。([GitHub][4])

所以**正常插件安装不应该互相覆盖文件**。它们不是同一个目录、同一个 plugin name，也不是同一个包管理依赖。

### 4.2 行为层面：中高风险

真正的问题是：两个项目都会试图影响 Agent 的“下一步应该怎么做”。

Superpowers 会在 session start 注入 `using-superpowers` 内容，并告诉 agent “You have superpowers”，让它用 Skill tool 调用其他 skill。([GitHub][5])
agent-skills 也有 session-start hook，会注入 `using-agent-skills` meta-skill；但它的 hook 依赖 `jq`，缺失时会提示 meta-skill 注入不可用、单个 skills 仍可用。([GitHub][6])

这会带来几个具体冲突：

| 冲突类型             | 风险 | 说明                                                                                                                      |
| ---------------- | -: | ----------------------------------------------------------------------------------------------------------------------- |
| 重复 TDD           |  高 | 两边都有 `test-driven-development`。Superpowers 会强制 Red-Green-Refactor，agent-skills 也有 TDD skill。                            |
| 重复规划             | 中高 | Superpowers 的 brainstorming / writing-plans 与 agent-skills 的 interview/spec/plan 会重复问问题、重复写计划。                          |
| 重复 review        | 中高 | Superpowers 有 requesting-code-review，agent-skills 有 code-review-and-quality + code-reviewer persona。                    |
| 路由歧义             | 中高 | agent-skills 自己就有 open issue 指出 `code-reviewer` persona 和 `code-review-and-quality` skill 对同一自然语言请求存在路由歧义。([GitHub][7]) |
| Codex skill 列表膨胀 |  中 | Codex 文档说明 skill 初始列表有上下文预算限制，过多 skills 会截短描述，极大集合可能遗漏部分 skill 并警告。([OpenAI Developers][8])                             |
| 同名 skill         |  中 | Codex 文档说明两个 skills 同名时不会合并，都会出现在 selector 里。([OpenAI Developers][8])                                                   |

因此结论是：**不会像 Python 依赖那样冲突，但会像“两个项目经理同时指挥同一个 Agent”那样冲突。**

---

## 5. 对 Codex 的判断

**Codex 里不建议全量安装 agent-skills，至少不建议和 Superpowers 一起全局启用。**

原因有三点：

第一，Superpowers 已经有 Codex 官方 marketplace 安装路径，README 明确写了 Codex CLI / Codex App 的安装方式。([GitHub][1])
而 agent-skills README 对 Codex / other agents 的表述是“plain Markdown，任何接受 system prompt 或 instruction files 的 agent 都可用”，并没有像 Superpowers 那样展示 `.codex-plugin` 级别的官方插件路径。([GitHub][2])

第二，Codex 官方文档明确说 skills 是可复用 workflow 的 authoring format，plugins 是分发单元；skill 过多会受初始 skills list 的上下文预算影响。([OpenAI Developers][8])
你已经装 Superpowers，再塞入 agent-skills 全包，会增加 skill selection 噪声。

第三，两个包都有 `test-driven-development` 这类同名/近似触发 skill。Codex 文档说同名不会合并；这意味着 selector 或隐式路由时可能出现两个相似入口。([OpenAI Developers][8])

**更好的 Codex 策略：只装精选 skill。**

建议优先抽取：

```text
source-driven-development
doubt-driven-development
context-engineering
api-and-interface-design
security-and-hardening
documentation-and-adrs
observability-and-instrumentation
performance-optimization
```

暂时不要抽取：

```text
test-driven-development
spec-driven-development
planning-and-task-breakdown
code-review-and-quality
shipping-and-launch
```

这些已经和 Superpowers 主流程高度重叠。

---

## 6. 对 Claude Code 的判断

**Claude Code 可以试装 agent-skills，但建议把它当“命令工具箱”，不要让它覆盖 Superpowers 的默认方法论。**

agent-skills 在 Claude Code 中提供 marketplace 安装命令，并暴露 `/spec`、`/plan`、`/build`、`/test`、`/review`、`/ship`、`/code-simplify` 等命令。([GitHub][2])
这点是它对 Claude Code 的直接价值：你可以显式调用 `/review`、`/ship`、`/webperf` 之类命令，而不是只靠自动触发。

但要注意两点：

第一，agent-skills 的 issues 里曾有 Claude Code 插件启用后 Skill tool 找不到 skills 的问题，后来该 issue 显示已关闭；这说明项目在 Claude Code 插件适配上经历过真实兼容性问题。([GitHub][9])

第二，当前还有 open issue 指出 agent-skills 内部的 persona 与 skill 存在路由歧义，尤其是 code review、security、test 相关入口。([GitHub][7])
当它再和 Superpowers 叠加时，这种歧义会更明显。

**Claude Code 推荐试法：**

不要先让它接管所有任务。你可以安装后在第一个测试会话里明确写：

```text
本会话 Superpowers 作为主工作流。
agent-skills 只在我显式调用 /spec、/plan、/review、/ship、/webperf，或明确点名某个 agent-skills skill 时使用。
不要同时执行 Superpowers 和 agent-skills 的重复 planning/TDD/review 流程。
```

如果这样仍然频繁重复规划、重复问问题、重复 review，就不适合双开。

---

## 7. Windows / CentOS 环境门槛

这两个项目本质上都是 **Markdown skills + hooks + plugin manifest**，不是需要 GPU 的模型项目。

| 环境项        | agent-skills                                               | Superpowers                                                                |
| ---------- | ---------------------------------------------------------- | -------------------------------------------------------------------------- |
| GPU / CUDA | 不需要                                                        | 不需要                                                                        |
| Docker     | 不需要                                                        | 不需要                                                                        |
| 数据库 / 向量库  | 不需要                                                        | 不需要                                                                        |
| API Key    | skills 本身不需要，取决于 Codex/Claude/Gemini                       | 同左                                                                         |
| Windows 本地 | 可用，但 session-start hook 依赖 bash + jq，可能不如 Superpowers 适配顺滑 | 有 Windows hook wrapper，会尝试 Git for Windows bash 或 PATH bash。([GitHub][10]) |
| CentOS 远程  | 可用，jq/bash 更容易满足                                           | 可用                                                                         |

对你这个 Windows 11、无 WSL、无 Docker 的本地环境来说：**agent-skills 的主功能仍可用，但自动注入 meta-skill 这类 hook 可能依赖 bash/jq；Superpowers 在 Windows hook 兼容上看起来更成熟。**

---

## 8. 是否值得再安装？

我的分层判断：

| 场景                                  | 是否值得          |
| ----------------------------------- | ------------- |
| 想替代 Superpowers                     | 不值得           |
| 想让 Claude Code 多一组显式 slash commands | 值得小范围试装       |
| 想给 Codex 增加全量 24 skills             | 不建议           |
| 想抽取专项工程 skills 融入长期系统               | 值得            |
| 想学习 Skill 设计范式                      | 值得            |
| 想马上提升日常编码稳定性                        | 不确定，可能被重复流程抵消 |
| 想做自己的 Skill 库 / CCRA 工程检查链          | 很值得借鉴         |

综合评分：

| 维度                     |                 分数 |
| ---------------------- | -----------------: |
| 项目定位清晰度                |            4.5 / 5 |
| Skill / Agent / 自动化相关性 |            4.5 / 5 |
| 与 Superpowers 互补性      |            3.5 / 5 |
| 与 Superpowers 冲突风险     | 3.5 / 5，分数越高代表风险越大 |
| Codex 全量安装价值           |            2.5 / 5 |
| Claude Code 试装价值       |            3.8 / 5 |
| 长期系统/自建 Skill 借鉴价值     |            4.5 / 5 |
| 立即全局安装价值               |            2.8 / 5 |

---

## 9. 我的推荐动作

**主动作：收藏 + clone 阅读 + 抽取精选 skills。**
不要马上把完整 agent-skills 同时塞进 Codex 和 Claude Code 的长期全局环境。

**次动作：只在 Claude Code 里做一次隔离试装。**
测试目标不是“能不能安装”，而是看它和 Superpowers 双开时是否出现：

* 重复问需求；
* 重复生成 spec；
* 重复写 plan；
* TDD 规则互相覆盖；
* code review 入口混乱；
* agent 开始纠结到底用 Superpowers 还是 agent-skills。

**不建议做的事：**

* 不建议在 Codex 中和 Superpowers 一起全量安装 agent-skills。
* 不建议把两个系统都设成“自动主导所有任务”。
* 不建议直接把 agent-skills 的所有 skills 复制进个人全局 skills 目录。
* 不建议保留两个同名 `test-driven-development` skill 长期共存。

---

## 10. 最实用的落地方案

我会按这个顺序做：

### 第一阶段：不安装，先做 Skill 采样

从 agent-skills 里挑这几个看：

```text
source-driven-development
doubt-driven-development
context-engineering
documentation-and-adrs
security-and-hardening
observability-and-instrumentation
api-and-interface-design
```

判断它们是否值得改造成你的个人 Skill。

### 第二阶段：Claude Code 小范围试装

只在 Claude Code 里测试，因为 agent-skills 的 slash commands 对 Claude Code 的增量最大。

测试 prompt：

```text
请用当前项目做一次小改动评估。
Superpowers 作为主工作流。
agent-skills 只在我显式调用 /review、/ship、/webperf 或点名具体 skill 时使用。
不要重复执行两个系统的 planning/TDD/review。
```

### 第三阶段：Codex 只装精选版

Codex 更适合保留 Superpowers 为主，只补充少数 agent-skills 专项能力。Codex 官方文档支持把 skills 放在用户级或 repo 级目录，也支持通过配置禁用指定 skill。([OpenAI Developers][8])

---

## 最终判断

**agent-skills 还有价值，但不是“再装一个 Superpowers”。**

它对你的最佳价值是：

* 作为工程质量 checklist；
* 作为 Skill 写法范本；
* 作为你长期 Skill 系统的素材库；
* 作为 Superpowers 之外的专项增强包。

**我的推荐：不要全量双开；先试 Claude Code，Codex 只抽取精选 skills。**

[1]: https://github.com/obra/superpowers?utm_source=chatgpt.com "GitHub - obra/superpowers: An agentic skills framework & software development methodology that works. · GitHub"
[2]: https://github.com/addyosmani/agent-skills?utm_source=chatgpt.com "GitHub - addyosmani/agent-skills: Production-grade engineering skills for AI coding agents. · GitHub"
[3]: https://raw.githubusercontent.com/obra/superpowers/main/.claude-plugin/plugin.json?utm_source=chatgpt.com "raw.githubusercontent.com"
[4]: https://raw.githubusercontent.com/addyosmani/agent-skills/main/.claude-plugin/plugin.json?utm_source=chatgpt.com "raw.githubusercontent.com"
[5]: https://raw.githubusercontent.com/obra/superpowers/main/hooks/session-start?utm_source=chatgpt.com "raw.githubusercontent.com"
[6]: https://raw.githubusercontent.com/addyosmani/agent-skills/main/hooks/session-start.sh?utm_source=chatgpt.com "raw.githubusercontent.com"
[7]: https://github.com/addyosmani/agent-skills/issues/173?utm_source=chatgpt.com "Routing ambiguity: code-reviewer persona and code-review-and-quality skill compete for the same natural-language intent · Issue #173 · addyosmani/agent-skills · GitHub"
[8]: https://developers.openai.com/codex/skills?utm_source=chatgpt.com "Agent Skills – Codex | OpenAI Developers"
[9]: https://github.com/addyosmani/agent-skills/issues/112?utm_source=chatgpt.com "Skill tool reports 'Unknown skill' for all 21 skills in Claude Code despite plugin enabled · Issue #112 · addyosmani/agent-skills · GitHub"
[10]: https://raw.githubusercontent.com/obra/superpowers/main/hooks/run-hook.cmd?utm_source=chatgpt.com "raw.githubusercontent.com"