企业官网建设流程全解析

Superpowers 是一款专为 Claude Code 打造的 Agentic Skills 框架与软件开发方法论插件，它把头脑风暴、计划编写、测试驱动开发（TDD）、代码评审等能力封装成 AI 助手的强制工作流，并深度集成 Claude Code 原生任务管理。安装只需 3 条命令，再运行一次/onboard自动化配置，5 分钟即可完成全部设置。

Superpowers 是什么？一个"会自律"的 AI 开发框架

简单来说，Superpowers 给 Claude Code 装上了一套工程纪律：AI 助手不再"想到哪写到哪"，而是按标准流程推进每个开发任务。

📌核心理念：先测试后编码、用流程代替猜测、用证据代替口头声明。

下面这两张官方截图直观展示了装上插件前后的差异：

⬆️Vanilla 版本：任务只存在于 markdown 计划里，没有运行时可见性，Agent 可能跳任务，进度只能靠人眼读输出。

装上 Superpowers 之后：任务被原生任务管理器"上轨道"，Task 2 会等 Task 1 完成才开始，用户能实时看到每个任务的pending / in_progress / completed状态。

一键安装 Superpowers 插件：3 条命令搞定 🚀

在 Claude Code 终端中依次执行：

第 1 步：注册插件市场

/plugin marketplace add pcvelz/superpowers

第 2 步：安装插件

/plugin install superpowers-extended-cc@superpowers-extended-cc-marketplace

第 3 步（推荐）：开启市场自动更新

在/plugin界面切换到Marketplaces选项卡，为市场启用 auto-update，之后新版发布会在下次启动时自动安装。

💡 如果只想更新已安装的插件，执行：/plugin update superpowers-extended-cc@superpowers-extended-cc-marketplace

💡 想本地研读技能脚本与 hook 源码？可以克隆仓库：git clone https://gitcode.com/gh_mirrors/sup/superpowers

/onboard 自动化配置：一次选择，五项功能全配齐 ⚡

这是整个安装流程中最省事的一步。在 Claude Code 中执行：

/superpowers-extended-cc:onboard

/onboard会像向导一样逐项提问，每答一题就立刻把配置文件写好，不存在"答完了还得自己动手"的情况。完整逻辑定义见 commands/onboard.md。

第 0 题：配置作用范围（只问一次）

• This project（推荐）：配置写入本项目的docs/superpowers/与.claude/settings.json，仅当前项目生效
• User-level：写入~/.claude/superpowers/与~/.claude/settings.json，所有项目共享

功能 1：开启原生任务工具（关键一步 ✅）

Claude Code 2.1.233+ 默认移除了任务工具，而 Superpowers 正是构建在它之上。onboard 会检测并自动写入：

{"env": {"CLAUDE_CODE_ENABLE_TODO_TOOLS": "1"}}

这一步恢复了任务列表、.tasks.json跨会话恢复和TaskCreate门禁。若你选择跳过，计划仍能执行，但没有任务列表和依赖约束。

功能 2：子代理模型路由（省钱利器 💰）

计划执行时每个任务会派生"实现者 + 2 个评审者"子代理，默认全部继承最贵的会话模型。开启路由后按档位分配（映射文件为docs/superpowers/model-routing.json，设计文档见 docs/model-routing-flow.md）：

删掉映射文件即一键关闭，无需改动任何设置。

功能 3：用户门禁强制执行钩子 🛡️

当你说"确保 X 验证通过再继续"却没说怎么验证时，AI 容易偷工减料。启用后（hook 注册进.claude/settings.json），门禁任务关闭时强制要求逐条贴出AC: <标准> — PROVEN BY <证据>格式的验证证据，细节见 docs/user-gate-flow.md。

功能 4：提交策略

• Per-task（默认）：每个任务结束各自提交，历史细粒度、可单任务回滚
• At-end：计划末尾一次性提交，一个功能一个 commit。开启方式是在docs/superpowers/workflow.json写入{"commitStrategy": "at-end"}，文档见 docs/workflow-config-flow.md

功能 5：插件自动更新

第三方市场默认不会自动更新。onboard 会检测并在~/.claude/settings.json的extraKnownMarketplaces中把autoUpdate设为true，下次启动自动拉到最新版。

✅收尾：onboard 最后会汇总"写了哪些文件、跳过了什么、每项如何撤销"，并自动检查是否误装了上游版本造成技能重名冲突。所有文件都只写入工作区，不会自动 commit。

手动配置备选方案：只需 1 行 JSON

不想跑向导？/onboard配置的所有内容都可以手动完成。唯一必做的一步是开启任务工具——把下面这段加入~/.claude/settings.json（全局）或<project>/.claude/settings.json（单项目）：

{"env": {"CLAUDE_CODE_ENABLE_TODO_TOOLS": "1"}}

另外推荐把EnterPlanMode加入权限拒绝列表，避免 Claude Code 自动进入 Plan 模式与技能工作流冲突：

{ "permissions": { "deny": ["EnterPlanMode"] } }

装上之后：Superpowers 的 7 步开发工作流

安装完成后，Superpowers 会按下面的流水线接管每个开发任务——这些是强制工作流，不是建议。每个技能的完整定义都能在仓库中找到，例如 skills/brainstorming/SKILL.md、skills/writing-plans/SKILL.md、skills/subagent-driven-development/SKILL.md：

1. brainstorming— 写码前激活，通过提问打磨模糊想法、探索备选方案，产出设计文档
2. using-git-worktrees— 设计批准后创建隔离的 worktree 工作区，验证干净的测试基线
3. writing-plans— 把工作拆成 2-5 分钟的小任务，每个任务带文件路径、完整代码和验证步骤，并创建带依赖关系的原生任务
4. subagent-driven-development / executing-plans— 每个任务派发全新子代理，执行"规格符合性 → 代码质量"两阶段评审
5. test-driven-development— 强制 RED-GREEN-REFACTOR：先写失败测试，再写最小实现
6. requesting-code-review— 任务之间按严重程度报告问题，Critical 级别直接阻塞
7. finishing-a-development-branch— 全部任务完成后验证测试，给出 merge / PR / 保留 / 丢弃选项并清理工作区

执行效果如下图所示，顶部是带依赖流向图的计划摘要，底部状态栏实时显示任务清单：

⬆️ Extended CC 版本：任务 7 个、依赖链清晰（如 Task 3 被 Task 1 阻塞），进度状态实时可见。

常见问题速答

Q1：装完插件，AI 会不会"自动变乖"？会。using-superpowers技能（见 skills/using-superpowers/SKILL.md）要求 AI 在任何响应前先检查是否有适用技能，哪怕只有 1% 的适用概率。

Q2：Claude Code 版本低于 2.1.233 需要改配置吗？不需要。低版本默认带任务工具，/onboard检测到TaskCreate已存在时会直接跳过该步骤。

Q3：想临时关闭某个强制门禁怎么办？各门禁都有环境变量开关，如SUPERPOWERS_ROUTING_GUARD=0、SUPERPOWERS_WORKFLOW_GUARD=0，单次会话内临时放行，无需改配置。

Q4：hook 出错了会不会卡死会话？不会。所有门禁都是 fail-open 设计——解析错误时自动放行，绝不阻断你的会话。

小结 🎉

Superpowers 的价值在于把"靠谱的软件开发流程"变成 AI 助手的默认行为。记住这条最短路径：

/plugin marketplace add→/plugin install→/superpowers-extended-cc:onboard

3 条命令 + 5 个选择题，5 分钟即可让 Claude Code 的任务管理、模型路由和门禁强制执行全部就位。接下来，直接丢给它一个真实需求，看它如何一步步"上轨道"地交付代码吧。