333 lines
19 KiB
Markdown
333 lines
19 KiB
Markdown
# 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"
|