前言¶
在 Cursor、Claude Code 等环境里写代码，常见情况是：需求一多就跳过设计直接改文件，测试和 Code Review 靠自觉，分支收尾也缺少固定步骤。对话式 Agent 能写代码，但缺少一条可重复走完的链路。
下面介绍 SkillHub 上的 Superpowers。它把「头脑风暴 → 设计 → 计划 → TDD → 子 Agent 开发 → 代码审查 → 分支收尾」串成一套方法论，并以 Skill 形式交给 Agent 执行，适用于新功能、重构、修 bug 等编程任务。
这是什么¶
Superpowers 是一套完整的软件开发方法论与 Skill 组合系统，由社区发布者 user_14606527 维护，坐标为 @user_14606527/superpowers-skill，当前版本 1.0.1，分类为 dev-programming，来源标注为 community，说明自 obra/superpowers 移植而来。
SkillHub 页面简介将其定位为：提供结构化、可重复的工作流，用于 coding、建项目、重构、修 bug 或任意编程任务。标签 requires_api_key=false，表示安装后一般不需要额外 API Key 才能启用 Skill 本身。
核心功能¶
依据官方简介，Superpowers 覆盖以下阶段（名称保持原文）：
- brainstorming：在写代码前澄清目标与约束。
- design：形成可执行的设计结论，避免直接堆实现。
- planning：把设计拆成可验证的步骤。
- TDD：以测试驱动的方式推进实现。
- subagent-driven dev：在合适环节用子 Agent 分担探索或并行任务。
- code review：在合并前做结构化的代码审查。
- finishing branch：完成分支上的收尾工作（如测试、文档、合并前检查等，具体步骤以 Skill 内
SKILL.md为准）。
整体是「方法论 + 多个 Skill 组合」，而不是单点提示词：Agent 读取 Skill 后，应按上述顺序组织对话与工具调用，而不是每次从零即兴发挥。
安装与启用¶
通过 SkillHub CLI（推荐）¶
SkillHub 安装说明见 skillhub.cn/install/skillhub.md。先确认本机是否已有 CLI：
command -v skillhub && skillhub --version
若未安装，可执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装 Superpowers 时，必须用 --dir 指向当前 Agent 的 skills 目录；默认装到 ./skills/ 时，部分客户端不会自动加载。
在 Cursor 中，skills 目录一般为：
skillhub install @user_14606527/superpowers-skill --dir ~/.cursor/skills/
其他常见路径（来自 SkillHub 安装文档，按你实际使用的客户端选择）：
- Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/ - Windsurf：
~/.codeium/windsurf/skills/或项目下的.windsurf/skills/
安装完成后，按你所用客户端的要求重启或刷新 Agent，使新 Skill 被索引。
通过自然语言让 Agent 安装¶
SkillHub 技能页提供的安装提示为：请 Agent 根据 https://skillhub.cn/install/skillhub.md 安装 @user_14606527/superpowers-skill。适合已打开对话、希望由 Agent 代劳 CLI 的场景；仍须指定正确的 --dir，否则 Skill 可能装到错误位置。
典型用法¶
官方页面未给出单独的业务 demo 仓库；典型用法是：在编程类任务中启用 Superpowers，让 Agent 按工作流阶段推进，而不是只回答单轮补丁。
可复现的起步方式示例：
- 完成上述安装，确认 Skill 出现在对应 skills 目录。
- 在 Cursor（或其他已配置目录的客户端）中发起任务，例如：「用 Superpowers 流程：先 brainstorm，再 design 和 plan，然后 TDD 实现某某功能。」
- 观察 Agent 是否分阶段产出（需求/设计/计划/测试与实现/审查/分支收尾），并在每阶段确认后再进入下一步。
若需核对某一阶段的具体指令或子 Skill 名称，应打开安装后的 SKILL.md 及同目录下的引用文件；本文仅依据 SkillHub 公开简介与安装说明，不展开未在页面上列出的内部文件名。
适用场景与注意¶
适合谁
- 希望 Agent 参与完整开发周期、而不只是「改一行代码」的个人或小团队。
- 需要 repeatable workflow：多次任务走同一套 brainstorming → finishing branch。
- 已在用 Cursor / Claude Code / Codex 等支持 Skills 目录的客户端。
限制与注意
- 工作流比自由对话更长，小改动可能显得「重」；可明确要求 Agent 跳过不适用的阶段，但仍以 Skill 内规则为准。
- 子 Agent、TDD、代码审查的效果取决于底层模型与项目测试基建；Skill 提供结构，不替代 CI 或人工终审。
- 版本以 SkillHub 为准（当前 1.0.1）；升级可用
skillhub的 update 类命令（参见 SkillHub 安装文档第三节），并再次指定--dir。 - SkillHub 抓取信息显示：评分 100000，下载 34976，分类 dev-programming；具体统计会随平台更新变化，以 技能页 为准。
结尾¶
Superpowers 把 obra/superpowers 的方法论落到 SkillHub 可安装的 Skill 上，用固定阶段约束 Agent 的软件开发过程。若你希望编程任务默认走「先想清再写、先测再合、审查后再收尾」，可以从安装 @user_14606527/superpowers-skill 开始。
官方入口：
