wantsong
/
knowledge-vault
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
knowledge-vault/discussions/agents/GitHub助手GPT/2026-06-15-agent-skills.md

19 KiB
Raw Blame History

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)

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

换句话说：

维度 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)

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)

所以如果你问“它是不是 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)

4. 是否会引起冲突？

4.1 文件层面：低风险

两个项目的插件名不同：

  • Superpowers 的 Claude 插件名是 superpowers。(GitHub)
  • agent-skills 的 Claude 插件名是 agent-skills，并声明了 commands、skills、agents 路径。(GitHub)

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

4.2 行为层面：中高风险

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

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

这会带来几个具体冲突：

冲突类型 风险 说明
重复 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)
Codex skill 列表膨胀 中 Codex 文档说明 skill 初始列表有上下文预算限制，过多 skills 会截短描述，极大集合可能遗漏部分 skill 并警告。(OpenAI Developers)
同名 skill 中 Codex 文档说明两个 skills 同名时不会合并，都会出现在 selector 里。(OpenAI Developers)

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

5. 对 Codex 的判断

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

原因有三点：

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

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

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

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

建议优先抽取：

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

暂时不要抽取：

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) 这点是它对 Claude Code 的直接价值：你可以显式调用 /review、/ship、/webperf 之类命令，而不是只靠自动触发。

但要注意两点：

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

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

Claude Code 推荐试法：

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

本会话 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)
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 里挑这几个看：

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：

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

第三阶段：Codex 只装精选版

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

最终判断

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

它对你的最佳价值是：

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

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