@liangjie559567/ultrapower 5.6.6 → 5.6.8

package/docs/plans/2026-02-24-superpowers-ultrapower-integration-design.md

@@ -133,7 +133,7 @@ brainstorming 触发时的强制流程：
 `next-step-router` 在阶段2→3的关键节点，根据任务特征智能推荐执行模式：
 
 | 任务特征 | 推荐模式 | 原因 |
-|---|---|---|
+| --- | --- | --- |
 | 单一连贯交付物 | `autopilot` | 全自主端到端，无需干预 |
 | 多组件系统（前端+后端+DB） | `team` | 分阶段pipeline（plan→prd→exec→verify→fix），默认编排器 |
 | "不要停直到完成" | `ralph` | 持久循环+强制验证，包含ultrawork并行能力 |
@@ -187,7 +187,7 @@ brainstorming 触发时的强制流程：
 ⚠️ **防重复规则**：`using-superpowers` 触发 explore 后，`brainstorming` 不再重复调用 explore，直接使用已有的 `codebase_summary`。
 
 | Agent/Skill | 关键节点 | 主推 | 备选 | 推荐理由 |
-|---|---|---|---|---|
+| --- | --- | --- | --- | --- |
 | `explore` agent | 代码库理解完成后（AGENTS.md 已存在） | `brainstorming` | `systematic-debugging` | 探索后进入设计或调试 |
 | `explore` agent | 代码库理解完成后（AGENTS.md 不存在） | `deepinit` skill | `brainstorming` | 首次初始化，先生成层级化 AGENTS.md |
 | `deepinit` skill | AGENTS.md 生成完成后 | `brainstorming` | `sciomc` skill | 代码库初始化完成，进入设计阶段 |
@@ -198,7 +198,7 @@ brainstorming 触发时的强制流程：
 ### 阶段1：探索与设计
 
 | Skill | 关键节点 | 主推 | 备选 | 推荐理由 |
-|---|---|---|---|---|
+| --- | --- | --- | --- | --- |
 | `using-superpowers` | 新功能请求到达 | `explore` agent（强制，model: haiku） | `systematic-debugging` | 新功能必须先探索代码库再设计 |
 | `using-superpowers` | explore 完成后 | `brainstorming` | `systematic-debugging` | 代码库已理解，进入设计对话 |
 | `brainstorming` | **触发时**（codebase_summary 已存在） | 直接进入设计对话 | — | explore 已完成，不重复调用 |
@@ -211,14 +211,14 @@ brainstorming 触发时的强制流程：
 **UX/UI 设计分支**（涉及前端/界面变更时触发）：
 
 | Skill | 关键节点 | 主推 | 备选 | 推荐理由 |
-|---|---|---|---|---|
+| --- | --- | --- | --- | --- |
 | `brainstorming` | 设计含 UI/UX 组件时 | `frontend-ui-ux` skill | `designer` agent | 前端工作路由到专用 UI/UX skill |
 | `frontend-ui-ux` skill | UI 设计方案确认后 | `writing-plans` skill | `brainstorming` | UI 设计完成进入实现计划 |
 
 ### 阶段2：规划与隔离
 
 | Skill | 关键节点 | 主推 | 备选 | 推荐理由 |
-|---|---|---|---|---|
+| --- | --- | --- | --- | --- |
 | `writing-plans` | 计划文档提交后 | `using-git-worktrees` | `subagent-driven-development` | 先建隔离环境再执行 |
 | `using-git-worktrees` | worktree创建验证后 | `subagent-driven-development` | `executing-plans` | 环境就绪，开始并行实现 |
 
@@ -227,13 +227,13 @@ brainstorming 触发时的强制流程：
 **执行模式路由（writing-plans 完成后触发）：**
 
 | Skill | 关键节点 | 主推 | 备选 | 推荐理由 |
-|---|---|---|---|---|
+| --- | --- | --- | --- | --- |
 | `writing-plans` 完成后 | 计划文档提交后 | `team` skill | `ralph` skill | team 是默认多agent编排器 |
 
 **执行模式内部路由：**
 
 | 执行模式 | 关键节点 | 主推 | 备选 | 推荐理由 |
-|---|---|---|---|---|
+| --- | --- | --- | --- | --- |
 | `autopilot` | 全自主完成后 | `verification-before-completion` | `requesting-code-review` | 自主执行后需验证 |
 | `team` | team-verify 阶段通过后 | `qa-tester` agent | `verification-before-completion` | team 内置验证，通过后进部署测试 |
 | `ralph` | 验证循环完成后 | `qa-tester` agent | `finishing-a-development-branch` | ralph 强制验证，通过后进部署 |
@@ -244,7 +244,7 @@ brainstorming 触发时的强制流程：
 **子 Skill 路由：**
 
 | Skill | 关键节点 | 主推 | 备选 | 推荐理由 |
-|---|---|---|---|---|
+| --- | --- | --- | --- | --- |
 | `subagent-driven-development` | 每个subagent完成后 | `requesting-code-review` | `quality-reviewer` | 每个任务完成即触发审查 |
 | `executing-plans` | 每批次执行完毕后 | `requesting-code-review` | `verification-before-completion` | 批次完成需要审查确认 |
 | `dispatching-parallel-agents` | 所有并行结果返回后 | `verifier` agent | `quality-reviewer` agent | 并行结果汇聚需统一验证（属于阶段3执行层，非阶段5） |
@@ -253,39 +253,41 @@ brainstorming 触发时的强制流程：
 ### 阶段3b：调试支路
 
 | Skill | 关键节点 | 主推 | 备选 | 推荐理由 |
-|---|---|---|---|---|
+| --- | --- | --- | --- | --- |
 | `systematic-debugging` | 根因确认后 | `test-driven-development` | `executor` agent | 先写失败测试再修复 |
 | `test-driven-development` | GREEN+重构完成后 | `requesting-code-review` | `verification-before-completion` | TDD完成需代码审查 |
 
 ### 阶段4：审查（多分支）
 
 | Skill | 关键节点 | 主推 | 备选 | 推荐理由 |
-|---|---|---|---|---|
+| --- | --- | --- | --- | --- |
 | `requesting-code-review` | 审查报告返回后 | `receiving-code-review` | `executor` agent | 请求与接收是配对skill |
 | `receiving-code-review` | 所有意见处理完后 | `verification-before-completion` | `finishing-a-development-branch` | 处理完审查需重新验证 |
 
 **安全审查分支**（有安全相关变更时触发）：
-- `requesting-code-review` → `security-reviewer` agent → `receiving-code-review`
+
+* `requesting-code-review` → `security-reviewer` agent → `receiving-code-review`
 
 **性能验证分支**（有性能敏感路径时触发）：
-- `verification-before-completion` → `performance-reviewer` agent → `finishing-a-development-branch`
+
+* `verification-before-completion` → `performance-reviewer` agent → `finishing-a-development-branch`
 
 ### 阶段5：验证
 
 | Skill | 关键节点 | 主推 | 备选 | 推荐理由 |
-|---|---|---|---|---|
+| --- | --- | --- | --- | --- |
 | `verification-before-completion` | 验证通过后 | `build-fixer` agent | `finishing-a-development-branch` | 验证通过先做构建验证 |
 
 ### 阶段5b：构建验证（新增）
 
 | Agent | 关键节点 | 主推 | 备选 | 推荐理由 |
-|---|---|---|---|---|
+| --- | --- | --- | --- | --- |
 | `build-fixer` agent | lsp_diagnostics 零错误后 | `qa-tester` agent | `requesting-code-review` | 构建通过进入部署测试 |
 
 ### 阶段6：部署测试
 
 | Agent/Skill | 关键节点 | 主推 | 备选 | 推荐理由 |
-|---|---|---|---|---|
+| --- | --- | --- | --- | --- |
 | `qa-tester` agent | 测试用例执行后（有失败） | `ultraqa` skill循环 | `executor` agent | 发现问题进入ultraqa修复循环 |
 | `qa-tester` agent | 测试用例执行后（全通过） | `test-engineer` agent | `product-manager` agent | 直接进入回归测试 |
 | `ultraqa` skill | 循环中（修复后重测） | `qa-tester` agent → `executor/build-fixer` → `verifier` | — | 循环：测试→修复→验证→重测 |
@@ -295,27 +297,27 @@ brainstorming 触发时的强制流程：
 ### 阶段6b：回归测试（新增）
 
 | Agent | 关键节点 | 主推 | 备选 | 推荐理由 |
-|---|---|---|---|---|
+| --- | --- | --- | --- | --- |
 | `test-engineer` agent | 所有回归测试通过后 | `product-manager` agent | `finishing-a-development-branch` | 无回归后进入产品验收 |
 
 ### 阶段7：产品验收
 
 | Agent | 关键节点 | 主推 | 备选 | 推荐理由 |
-|---|---|---|---|---|
+| --- | --- | --- | --- | --- |
 | `product-manager` agent | PRD验收完成后 | `ux-researcher` agent | `finishing-a-development-branch` | 功能验收后做UX审计 |
 | `ux-researcher` agent | UX审计完成后 | `finishing-a-development-branch` | `executor` agent | 验收通过进入收尾 |
 
 ### 阶段8：收尾与发布（新增发布节点）
 
 | Skill/Agent | 关键节点 | 主推 | 备选 | 推荐理由 |
-|---|---|---|---|---|
+| --- | --- | --- | --- | --- |
 | `finishing-a-development-branch` | 用户选择整合方式后 | `git-master` agent | `verifier` agent | 分支整合需git专家 |
 | `git-master` agent | PR合并后 | `release` skill | — | 合并后触发发布流程 |
 
 ### 工具类（随时可用）
 
 | Skill | 关键节点 | 主推 | 备选 |
-|---|---|---|---|
+| --- | --- | --- | --- |
 | `writing-skills` | skill压力测试通过后 | `verifier` agent | `quality-reviewer` agent |
 
 ---
@@ -337,10 +339,14 @@ description: 在关键节点分析产出内容，用 AskUserQuestion 推荐最
 ## 触发方式
 
 由其他 skill 在关键节点末尾调用，传入以下参数：
-- `current_skill`: 当前完成的 skill 名称（如 "brainstorming"）
-- `stage`: 当前阶段标识（如 "design_approved", "root_cause_confirmed", "plan_committed"）
-- `output_summary`: 当前 skill 的产出摘要（文件数、变更类型、关键决策）
-- `full_context`: 完整上下文对象
+
+* `current_skill`: 当前完成的 skill 名称（如 "brainstorming"）
+
+* `stage`: 当前阶段标识（如 "design_approved", "root_cause_confirmed", "plan_committed"）
+
+* `output_summary`: 当前 skill 的产出摘要（文件数、变更类型、关键决策）
+
+* `full_context`: 完整上下文对象
   - `doc_paths`: 相关文档路径列表
   - `key_decisions`: 用户已确认的关键决策
   - `user_direction`: 用户选择的方向（前端/后端/架构/调试）
@@ -378,9 +384,12 @@ full_context.user_direction:
 ### 第三步：查路由映射表
 
 根据 `current_skill` + `stage` 组合查完整路由映射表，得到：
-- 主推 agent/skill（置信度 60-95%）
-- 备选 agent/skill（置信度 30-60%）
-- 推荐理由
+
+* 主推 agent/skill（置信度 60-95%）
+
+* 备选 agent/skill（置信度 30-60%）
+
+* 推荐理由
 
 ## 输出格式
 
@@ -414,6 +423,7 @@ full_context.user_direction:
 **新增内容（插入到"## 检查清单"之前）：**
 
 ```markdown
+
 ## 强制前置：代码库探索
 
 <HARD-GATE>
@@ -428,14 +438,17 @@ full_context.user_direction:
    - 近期提交（最近5个 commit 的变更摘要）
    - 现有约定（命名规范、架构模式）
 
-2. 将探索结果作为 `codebase_summary` 存入上下文
+1. 将探索结果作为 `codebase_summary` 存入上下文
 
-3. 探索完成后，才进入"理解想法"阶段
+1. 探索完成后，才进入"理解想法"阶段
 
 ### 探索完成标准
-- [ ] 已识别与任务相关的主要文件（≥3个）
-- [ ] 已了解现有架构模式
-- [ ] 已检查近期相关提交
+
+* [ ] 已识别与任务相关的主要文件（≥3个）
+
+* [ ] 已了解现有架构模式
+
+* [ ] 已检查近期相关提交
 ```
 
 **修改位置：** "## 设计完成后" → "**实现：**" 部分末尾，添加路由触发
@@ -443,13 +456,18 @@ full_context.user_direction:
 **新增内容（追加到 skill 末尾）：**
 
 ```markdown
+
 ## 路由触发（设计批准后）
 
 设计文档提交到 git 后，调用 `next-step-router`：
-- current_skill: "brainstorming"
-- stage: "design_approved"
-- output_summary: 设计涉及的文件数、模块数、是否有架构/安全/性能变更
-- full_context: { doc_paths: [设计文档路径], key_decisions: [...], codebase_summary: [...] }
+
+* current_skill: "brainstorming"
+
+* stage: "design_approved"
+
+* output_summary: 设计涉及的文件数、模块数、是否有架构/安全/性能变更
+
+* full_context: { doc_paths: [设计文档路径], key_decisions: [...], codebase_summary: [...] }
 ```
 
 ---
@@ -461,6 +479,7 @@ full_context.user_direction:
 **新增内容（插入到"## 红旗"之前）：**
 
 ```markdown
+
 ## 新功能路由规则
 
 当用户请求涉及**新功能开发**时（非 bug 修复），强制执行以下流程：
@@ -470,20 +489,26 @@ full_context.user_direction:
   ↓
 1. 调用 explore agent（haiku）→ 理解代码库
   ↓
-2. 调用 brainstorming skill → 设计对话
+1. 调用 brainstorming skill → 设计对话
   ↓
-3. 设计批准后 → next-step-router 推荐下一步
+1. 设计批准后 → next-step-router 推荐下一步
 ```
 
 **判断是否为新功能：**
-- 包含"添加"、"新增"、"实现"、"构建"、"创建" → 新功能流程
-- 包含"修复"、"bug"、"错误"、"不工作" → 调试流程（systematic-debugging）
-- 包含"重构"、"优化"、"改进" → 先 explore，再判断
+
+* 包含"添加"、"新增"、"实现"、"构建"、"创建" → 新功能流程
+
+* 包含"修复"、"bug"、"错误"、"不工作" → 调试流程（systematic-debugging）
+
+* 包含"重构"、"优化"、"改进" → 先 explore，再判断
 
 **路由触发（每次消息到达后）：**
-- 新功能 → explore agent → brainstorming
-- 已知 bug → systematic-debugging
-- 不确定 → AskUserQuestion 询问用户意图
+
+* 新功能 → explore agent → brainstorming
+
+* 已知 bug → systematic-debugging
+
+* 不确定 → AskUserQuestion 询问用户意图
 ```
 
 ---
@@ -494,155 +519,240 @@ full_context.user_direction:
 
 **`writing-plans`（计划提交后）：**
 ```markdown
+
 ## 路由触发
+
 计划文档提交后调用 next-step-router：
-- current_skill: "writing-plans"
-- stage: "plan_committed"
-- output_summary: 计划中的任务数、涉及文件数、是否有架构变更
+
+* current_skill: "writing-plans"
+
+* stage: "plan_committed"
+
+* output_summary: 计划中的任务数、涉及文件数、是否有架构变更
 ```
 
 **`using-git-worktrees`（worktree创建验证后）：**
 ```markdown
+
 ## 路由触发
+
 worktree 创建并验证后调用 next-step-router：
-- current_skill: "using-git-worktrees"
-- stage: "worktree_ready"
-- output_summary: worktree 路径、基于哪个分支
+
+* current_skill: "using-git-worktrees"
+
+* stage: "worktree_ready"
+
+* output_summary: worktree 路径、基于哪个分支
 ```
 
 **`subagent-driven-development`（每个subagent完成后）：**
 ```markdown
+
 ## 路由触发
+
 每个 subagent 任务完成后调用 next-step-router：
-- current_skill: "subagent-driven-development"
-- stage: "subagent_task_complete"
-- output_summary: 完成的任务描述、修改的文件列表
+
+* current_skill: "subagent-driven-development"
+
+* stage: "subagent_task_complete"
+
+* output_summary: 完成的任务描述、修改的文件列表
 ```
 
 **`executing-plans`（每批次完成后）：**
 ```markdown
+
 ## 路由触发
+
 每批次执行完毕后调用 next-step-router：
-- current_skill: "executing-plans"
-- stage: "batch_complete"
-- output_summary: 本批次完成的任务数、剩余任务数
+
+* current_skill: "executing-plans"
+
+* stage: "batch_complete"
+
+* output_summary: 本批次完成的任务数、剩余任务数
 ```
 
 **`dispatching-parallel-agents`（所有结果返回后）：**
 ```markdown
+
 ## 路由触发
+
 所有并行 agent 结果汇聚后调用 next-step-router：
-- current_skill: "dispatching-parallel-agents"
-- stage: "all_results_returned"
-- output_summary: agent 数量、成功/失败数、汇总结果
+
+* current_skill: "dispatching-parallel-agents"
+
+* stage: "all_results_returned"
+
+* output_summary: agent 数量、成功/失败数、汇总结果
 ```
 
 **`systematic-debugging`（根因确认后）：**
 ```markdown
+
 ## 路由触发
+
 根因确认后调用 next-step-router：
-- current_skill: "systematic-debugging"
-- stage: "root_cause_confirmed"
-- output_summary: 根因描述、涉及文件、是否需要测试先行
+
+* current_skill: "systematic-debugging"
+
+* stage: "root_cause_confirmed"
+
+* output_summary: 根因描述、涉及文件、是否需要测试先行
 ```
 
 **`test-driven-development`（GREEN+重构完成后）：**
 ```markdown
+
 ## 路由触发
+
 GREEN 阶段完成后调用 next-step-router：
-- current_skill: "test-driven-development"
-- stage: "green_complete"
-- output_summary: 通过的测试数、修改的文件列表
+
+* current_skill: "test-driven-development"
+
+* stage: "green_complete"
+
+* output_summary: 通过的测试数、修改的文件列表
 ```
 
 **`requesting-code-review`（审查报告返回后）：**
 ```markdown
+
 ## 路由触发
+
 审查报告返回后调用 next-step-router：
-- current_skill: "requesting-code-review"
-- stage: "review_returned"
-- output_summary: 审查意见数量、严重程度分布
+
+* current_skill: "requesting-code-review"
+
+* stage: "review_returned"
+
+* output_summary: 审查意见数量、严重程度分布
 ```
 
 **`receiving-code-review`（所有意见处理完后）：**
 ```markdown
+
 ## 路由触发
+
 所有审查意见处理完毕后调用 next-step-router：
-- current_skill: "receiving-code-review"
-- stage: "review_addressed"
-- output_summary: 处理的意见数、修改的文件列表
+
+* current_skill: "receiving-code-review"
+
+* stage: "review_addressed"
+
+* output_summary: 处理的意见数、修改的文件列表
 ```
 
 **`verification-before-completion`（验证通过后）：**
 ```markdown
+
 ## 路由触发
+
 验证通过后调用 next-step-router：
-- current_skill: "verification-before-completion"
-- stage: "verification_passed"
-- output_summary: 验证项目数、通过率、是否有构建错误
+
+* current_skill: "verification-before-completion"
+
+* stage: "verification_passed"
+
+* output_summary: 验证项目数、通过率、是否有构建错误
 ```
 
 **`finishing-a-development-branch`（整合方式确认后）：**
 ```markdown
+
 ## 路由触发
+
 用户选择整合方式后调用 next-step-router：
-- current_skill: "finishing-a-development-branch"
-- stage: "merge_strategy_confirmed"
-- output_summary: 选择的整合方式（merge/squash/rebase）
+
+* current_skill: "finishing-a-development-branch"
+
+* stage: "merge_strategy_confirmed"
+
+* output_summary: 选择的整合方式（merge/squash/rebase）
 ```
 
 **`writing-skills`（压力测试通过后）：**
 ```markdown
+
 ## 路由触发
+
 skill 压力测试通过后调用 next-step-router：
-- current_skill: "writing-skills"
-- stage: "stress_test_passed"
-- output_summary: 测试的 skill 名称、通过的测试场景数
+
+* current_skill: "writing-skills"
+
+* stage: "stress_test_passed"
+
+* output_summary: 测试的 skill 名称、通过的测试场景数
 ```
 
 **`deepinit`（AGENTS.md 生成完成后）：**
 ```markdown
+
 ## 路由触发
+
 层级化 AGENTS.md 文档生成完成后调用 next-step-router：
-- current_skill: "deepinit"
-- stage: "agents_md_generated"
-- output_summary: 生成的 AGENTS.md 文件数、覆盖的目录层级数
+
+* current_skill: "deepinit"
+
+* stage: "agents_md_generated"
+
+* output_summary: 生成的 AGENTS.md 文件数、覆盖的目录层级数
 ```
 
 **`sciomc`（综合分析报告完成后）：**
 ```markdown
+
 ## 路由触发
+
 并行 scientist 分析完成、综合报告生成后调用 next-step-router：
-- current_skill: "sciomc"
-- stage: "analysis_report_complete"
-- output_summary: 参与的 scientist agent 数、分析维度数、关键发现摘要
+
+* current_skill: "sciomc"
+
+* stage: "analysis_report_complete"
+
+* output_summary: 参与的 scientist agent 数、分析维度数、关键发现摘要
 ```
 
 **`external-context`（外部资料收集完成后）：**
 ```markdown
+
 ## 路由触发
+
 并行外部搜索完成、资料汇总后调用 next-step-router：
-- current_skill: "external-context"
-- stage: "external_context_gathered"
-- output_summary: 搜索切面数、收集的文档数、关键参考资料摘要
+
+* current_skill: "external-context"
+
+* stage: "external_context_gathered"
+
+* output_summary: 搜索切面数、收集的文档数、关键参考资料摘要
 ```
 
 **`frontend-ui-ux`（UI 设计方案确认后）：**
 ```markdown
+
 ## 路由触发
+
 UI/UX 设计方案经用户确认后调用 next-step-router：
-- current_skill: "frontend-ui-ux"
-- stage: "ui_design_approved"
-- output_summary: 设计的组件数、是否有设计系统变更、是否有无障碍要求
+
+* current_skill: "frontend-ui-ux"
+
+* stage: "ui_design_approved"
+
+* output_summary: 设计的组件数、是否有设计系统变更、是否有无障碍要求
 ```
 
 **`release`（发布流程完成后）：**
 ```markdown
+
 ## 路由触发
+
 发布流程完成后调用 next-step-router：
-- current_skill: "release"
-- stage: "release_complete"
-- output_summary: 发布版本号、发布渠道、是否有回滚计划
+
+* current_skill: "release"
+
+* stage: "release_complete"
+
+* output_summary: 发布版本号、发布渠道、是否有回滚计划
 ```
 
 ---
@@ -662,7 +772,7 @@ UI/UX 设计方案经用户确认后调用 next-step-router：
 当某个 agent 执行失败（非测试失败，而是超时/崩溃）时：
 
 | 失败类型 | 路由到 | 说明 |
-|---|---|---|
+| --- | --- | --- |
 | executor 超时/崩溃 | `debugger` agent | 分析失败原因，再决定是否重试 |
 | build-fixer 无法修复 | 上报用户 + notepad 记录 | 超出自动修复能力，需人工介入 |
 | verifier 无法验证 | `quality-reviewer` agent | 换角度验证 |
@@ -670,11 +780,13 @@ UI/UX 设计方案经用户确认后调用 next-step-router：
 
 ## 影响范围
 
-- **新增文件：** 1个（`skills/next-step-router/SKILL.md`）
-- **修改文件：** 18个（各 skill 末尾添加触发点）
+* **新增文件：** 1个（`skills/next-step-router/SKILL.md`）
+
+* **修改文件：** 18个（各 skill 末尾添加触发点）
   - 原有14个 skill：brainstorming、using-superpowers、writing-plans、using-git-worktrees、subagent-driven-development、executing-plans、dispatching-parallel-agents、systematic-debugging、test-driven-development、requesting-code-review、receiving-code-review、verification-before-completion、finishing-a-development-branch、writing-skills
   - 新增4个 skill：deepinit、sciomc、external-context、frontend-ui-ux
-- **不修改：** agents/、src/、bridge/ 等核心代码
+
+* **不修改：** agents/、src/、bridge/ 等核心代码
 
 ---