@liangjie559567/ultrapower 5.5.2 → 5.5.3

package/skills/ax-knowledge/AGENTS.md

@@ -1,10 +1,10 @@
 <!-- Parent: ../AGENTS.md -->
-<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+<!-- Generated: 2026-02-27 | Updated: 2026-03-02 -->
 
 # skills/ax-knowledge/
 
 ## Purpose
-Axiom 知识库管理 skill。搜索知识库和模式库，返回相关条目，支持查询和管理操作。
+Axiom 知识库管理 skill。搜索知识库和模式库，返回相关条目，支持关键词过滤和分类精确匹配。
 
 ## Key Files
 
@@ -14,6 +14,30 @@ Axiom 知识库管理 skill。搜索知识库和模式库，返回相关条目
 
 ## For AI Agents
 
+### 参数解析指引
+
+`ax-knowledge` 支持以下调用形式：
+
+```
+ax-knowledge                          # 全量返回所有知识条目
+ax-knowledge --filter typescript      # 按关键词过滤（title 或 category 包含）
+ax-knowledge --category architecture  # 按分类精确匹配
+```
+
+**参数解析规则：**
+1. 检测 `--filter <keyword>`：提取关键词，调用 `KnowledgeIndexManager.filterByKeyword(keyword)`
+   - 关键词长度 > 256 字符时，返回错误提示而非抛出异常
+   - 匹配规则：`title.includes(kw) || category.includes(kw)`（toLowerCase 后比较）
+2. 检测 `--category <category>`：提取分类名，调用 `KnowledgeIndexManager.filterByCategory(category)`
+   - 匹配规则：`category === cat`（toLowerCase 后比较，精确匹配）
+3. 无参数：调用 `KnowledgeIndexManager.loadIndex()`，返回全量
+
+**输出统计行（必须包含）：**
+```
+显示 X/Y 条，使用无参数调用查看全部
+```
+其中 X 为过滤后条目数，Y 为知识库总条目数。
+
 ### 修改此目录时
 - 编辑 `SKILL.md` 修改 skill 行为
 - 触发关键词变更需同步更新 `src/features/magic-keywords/`
@@ -22,6 +46,7 @@ Axiom 知识库管理 skill。搜索知识库和模式库，返回相关条目
 ## Dependencies
 
 ### Internal
+- `src/hooks/learner/index-manager.ts` — `filterByKeyword()` / `filterByCategory()` / `loadIndex()` 实现
 - `src/skills/` — Skill TypeScript 运行时注册
 - `src/features/magic-keywords/` — 关键词触发系统
 

package/skills/ax-knowledge/SKILL.md

@@ -15,7 +15,12 @@ description: "/ax-knowledge — Axiom 知识查询：搜索知识库和模式库
 
 搜索 `.omc/axiom/evolution/knowledge_base.md` 索引，返回匹配的知识条目。
 
-**触发词：** `ax-knowledge [关键词]`
+**触发词：** `ax-knowledge [--filter <keyword>] [--category <category>] [关键词]`
+
+**参数说明：**
+- `--filter <keyword>`：按关键词过滤，Title 或 Category 包含关键词（大小写不敏感，最多 256 字符）
+- `--category <category>`：按分类精确过滤，Category 字段完整匹配（大小写不敏感）
+- 无参数：返回全量知识条目
 
 ### 模式库查询
 
@@ -32,13 +37,23 @@ description: "/ax-knowledge — Axiom 知识查询：搜索知识库和模式库
 - 其他 → 知识条目查询
 - 两者都包含 → 并行查询两个库
 
+解析过滤参数：
+- 检查是否含 `--filter <keyword>`，提取关键词（超出 256 字符时返回错误提示）
+- 检查是否含 `--category <category>`，提取分类名
+- 两个参数均无时，执行全量查询
+
 ### Step 2: 搜索索引
 
-**知识库查询：**
-读取 `.omc/axiom/evolution/knowledge_base.md`，按关键词匹配：
-- 标题匹配（权重高）
-- 标签匹配（权重中）
-- 描述匹配（权重低）
+**知识库查询（无参数 — 全量返回）：**
+调用 `KnowledgeIndexManager.loadIndex()`，返回全量条目。
+
+**知识库查询（--filter）：**
+调用 `KnowledgeIndexManager.filterByKeyword(keyword)`：
+- Title 或 Category 包含关键词（includes，大小写不敏感）
+
+**知识库查询（--category）：**
+调用 `KnowledgeIndexManager.filterByCategory(category)`：
+- Category 字段精确匹配（大小写不敏感）
 
 **模式库查询：**
 读取 `.omc/axiom/evolution/pattern_library.md`，按关键词匹配：
@@ -55,7 +70,7 @@ description: "/ax-knowledge — Axiom 知识查询：搜索知识库和模式库
 ### Step 4: 格式化输出
 
 ```markdown
-## 知识查询结果：[关键词]
+## 知识查询结果：[关键词/参数]
 
 ### 知识条目（X 条）
 
@@ -72,6 +87,9 @@ description: "/ax-knowledge — Axiom 知识查询：搜索知识库和模式库
 - **触发条件**: [何时使用]
 - **解决方案**: [简要描述]
 [查看完整内容: .omc/axiom/evolution/patterns/[name].md]
+
+---
+显示 X/Y 条，使用无参数调用查看全部
 ```
 
 ### Step 5: 无结果处理
@@ -97,6 +115,20 @@ description: "/ax-knowledge — Axiom 知识查询：搜索知识库和模式库
     └── [name].md          # 模式条目
 ```
 
+## ax-knowledge import
+
+**命令：** `ax-knowledge import <file>`
+
+导入外部 JSON 知识文件到知识库，以 `namespace` 隔离。
+
+**执行步骤：**
+1. 读取 `<file>`（JSON 数组，每项含 `id`、`title`，可选 `category`/`confidence`/`created`）
+2. 显示确认提示：`导入 X 条条目，source_project: <namespace>，是否继续？(Yes/No)`
+3. 用户确认后调用 `importKnowledge(file, namespace)` 追加到索引
+4. 输出结果：`已导入 X 条，跳过 Y 条（重复）`
+
+**namespace 规则：** 条目 id 以 `<namespace>::<id>` 格式存储，防止跨项目污染。
+
 ## 与 learner skill 的关系
 
 - `ax-knowledge`：查询已有知识

package/skills/ax-reflect/SKILL.md

@@ -58,6 +58,8 @@ Task(subagent_type="ultrapower:analyst", model="opus", prompt="基于以下会
 - [ ] [REFLECTION] [待办事项]
 ```
 
+> **自动归档**：每次写入新反思条目后，系统自动检查条目数；若 `count > 10`，最旧的条目将自动移至 `.omc/axiom/evolution/reflection_log_archive.md`，并输出 `[归档] reflection_log: 已移动 N 条反思至 reflection_log_archive.md`。
+
 ### Step 4: Action Items 入队
 
 将 Action Items 追加到 `active_context.md` 的任务队列，标记为 `[REFLECTION]`。

package/skills/ax-status/SKILL.md

@@ -15,7 +15,7 @@ description: "/ax-status — Axiom 状态仪表盘：显示当前任务状态、
 
 并行读取：
 - `.omc/axiom/active_context.md` — 当前任务状态
-- `.omc/state/axiom-context.json` — 状态机状态
+- `.omc/axiom/state_machine.md` — 状态机状态
 - `.omc/axiom/evolution/learning_queue.md` — 待处理学习素材数量
 - `.omc/axiom/evolution/workflow_metrics.md` — 工作流指标
 
@@ -52,6 +52,17 @@ description: "/ax-status — Axiom 状态仪表盘：显示当前任务状态、
 - [基于当前状态的建议]
 ```
 
+### Step 2b: 最近模式晋升记录
+
+调用 `getRecentPromotions(7)` 读取 `pattern_library.md` 中最近 7 天内 `status: active` 的条目，输出：
+
+```markdown
+## 最近晋升模式（7天内）
+- [P-xxx] [模式名称] — [category]
+```
+
+若无晋升条目，输出 `（近7天无新晋升）`。
+
 ### Step 3: 健康检查
 
 检查以下文件是否存在且格式正确：
@@ -60,3 +71,25 @@ description: "/ax-status — Axiom 状态仪表盘：显示当前任务状态、
 - `.omc/axiom/evolution/knowledge_base.md`
 
 若文件缺失，提示用户运行 `/ax-context init` 初始化。
+
+### Step 4: 可观测性摘要
+
+调用 `queryEngine` 查询本 session 的可观测性数据并追加到报告末尾：
+
+```typescript
+import { queryEngine } from 'src/hooks/observability/query-engine.js';
+const runs  = queryEngine.getAgentRuns({ last: 5 });
+const tools = queryEngine.getToolCalls({ last: 5 });
+const costs = queryEngine.getCostSummary();
+```
+
+输出格式（追加在报告末尾）：
+
+```markdown
+## 可观测性快照
+- Top agents: [agent_type(avg_ms)] ...
+- Top tools:  [tool_name(p95_ms, failure_rate)] ...
+- 本次成本:   $X.XXXX USD
+```
+
+若数据库无数据则跳过此节。

package/skills/executing-plans/SKILL.md

@@ -46,7 +46,7 @@ description: 当你有书面实现计划需要在独立会话中执行并设置
 
 所有任务完成并验证后：
 - 宣布："I'm using the finishing-a-development-branch skill to complete this work."
-- **必需子 skill：** 使用 superpowers:finishing-a-development-branch
+- **必需子 skill：** 使用 ultrapower:finishing-a-development-branch
 - 遵循该 skill 验证测试、呈现选项、执行选择
 
 ## 何时停止并寻求帮助
@@ -79,9 +79,9 @@ description: 当你有书面实现计划需要在独立会话中执行并设置
 ## 集成
 
 **必需工作流 skill：**
-- **superpowers:using-git-worktrees** —— 必需：开始前设置隔离工作区
-- **superpowers:writing-plans** —— 创建此 skill 执行的计划
-- **superpowers:finishing-a-development-branch** —— 所有任务完成后完成开发
+- **ultrapower:using-git-worktrees** —— 必需：开始前设置隔离工作区
+- **ultrapower:writing-plans** —— 创建此 skill 执行的计划
+- **ultrapower:finishing-a-development-branch** —— 所有任务完成后完成开发
 
 ## 路由触发
 

package/skills/next-step-router/SKILL.md

@@ -19,6 +19,23 @@ description: 在关键节点分析产出内容，用 AskUserQuestion 推荐最
 
 ## 智能分析逻辑
 
+### 使用推荐引擎
+
+使用 `src/features/workflow-recommender/` 模块：
+
+```typescript
+import { classifyIntent, analyzeContext, getRecommendation } from './features/workflow-recommender/index.js';
+
+const intent = classifyIntent(userInput);
+const context = analyzeContext(output_summary);
+const recommendation = getRecommendation(intent, context);
+```
+
+推荐引擎自动处理：
+- 意图分类（feature-single/multiple, bug-fix, refactor, review, explore, plan）
+- 上下文分析（文件数、安全、性能、UI、API、架构）
+- 置信度评分（70-95%）
+
 ### 第一步：分析产出信号
 
 分析 output_summary：

package/skills/release/SKILL.md

@@ -135,6 +135,48 @@ node_modules/
 dist/
 ```
 
+## 首次配置 CI Secrets（新仓库必读）
+
+GitHub Actions 自动发布依赖以下 secrets，**首次使用前必须手动配置**：
+
+### NPM_TOKEN（必须手动配置）
+
+`GITHUB_TOKEN` 是 Actions 内置的，但 `NPM_TOKEN` **不会自动注入**，必须手动添加到仓库 Secrets。
+
+```bash
+# 1. 获取 npm token（从本地 .npmrc 读取）
+cat ~/.npmrc | grep "_authToken=" | cut -d= -f2
+
+# 2. 设置到 GitHub Secrets
+gh secret set NPM_TOKEN -R <owner>/<repo>
+# 粘贴上一步输出的 token，回车确认
+```
+
+> ⚠️ `actions/setup-node@v4` 配置 `registry-url` 后会注入 `NODE_AUTH_TOKEN=github.token`。若 workflow 显式覆盖为 `${{ secrets.NPM_TOKEN }}` 而该 secret 未设置，npm publish 会静默失败（k-066）。
+
+### GITHUB_TOKEN 权限（job 级声明）
+
+默认 `GITHUB_TOKEN` 无 `contents: write` 权限，`gh release create` 和 `git push` 会返回 HTTP 403。需在对应 job 级声明：
+
+```yaml
+jobs:
+  github-release:
+    permissions:
+      contents: write   # gh release create 需要
+  marketplace-sync:
+    permissions:
+      contents: write   # git push 需要
+```
+
+> ⚠️ 遵循最小权限原则，在 job 级而非 workflow 级声明（k-067）。
+
+### 验证 Secrets 配置
+
+```bash
+gh secret list -R <owner>/<repo>
+# 应看到 NPM_TOKEN 在列表中
+```
+
 ## 故障排查
 
 ### 安装后 skill 无法识别

package/skills/requesting-code-review/SKILL.md

@@ -5,7 +5,7 @@ description: 完成任务、实施主要功能或合并前使用，以验证工
 
 # 请求代码审查
 
-派遣 superpowers:code-reviewer 子 agent 在问题扩散前捕获它们。
+派遣 ultrapower:code-reviewer 子 agent 在问题扩散前捕获它们。
 
 **核心原则：** 尽早审查，频繁审查。
 
@@ -31,7 +31,7 @@ HEAD_SHA=$(git rev-parse HEAD)
 
 **2. 派遣 code-reviewer 子 agent：**
 
-使用 Task 工具，类型为 superpowers:code-reviewer，填写 `code-reviewer.md` 中的模板
+使用 Task 工具，类型为 ultrapower:code-reviewer，填写 `code-reviewer.md` 中的模板
 
 **占位符：**
 - `{WHAT_WAS_IMPLEMENTED}` - 刚构建的内容
@@ -56,7 +56,7 @@ You: Let me request code review before proceeding.
 BASE_SHA=$(git log --oneline | grep "Task 1" | head -1 | awk '{print $1}')
 HEAD_SHA=$(git rev-parse HEAD)
 
-[Dispatch superpowers:code-reviewer subagent]
+[Dispatch ultrapower:code-reviewer subagent]
   WHAT_WAS_IMPLEMENTED: Verification and repair functions for conversation index
   PLAN_OR_REQUIREMENTS: Task 2 from docs/superpowers/plans/deployment-plan.md
   BASE_SHA: a7981ec

package/skills/subagent-driven-development/SKILL.md

@@ -59,7 +59,7 @@ digraph process {
     "Read plan, extract all tasks with full text, note context, create TodoWrite" [shape=box];
     "More tasks remain?" [shape=diamond];
     "Dispatch final code reviewer subagent for entire implementation" [shape=box];
-    "Use superpowers:finishing-a-development-branch" [shape=box style=filled fillcolor=lightgreen];
+    "Use ultrapower:finishing-a-development-branch" [shape=box style=filled fillcolor=lightgreen];
 
     "Read plan, extract all tasks with full text, note context, create TodoWrite" -> "Dispatch implementer subagent (./implementer-prompt.md)";
     "Dispatch implementer subagent (./implementer-prompt.md)" -> "Implementer subagent asks questions?";
@@ -78,7 +78,7 @@ digraph process {
     "Mark task complete in TodoWrite" -> "More tasks remain?";
     "More tasks remain?" -> "Dispatch implementer subagent (./implementer-prompt.md)" [label="yes"];
     "More tasks remain?" -> "Dispatch final code reviewer subagent for entire implementation" [label="no"];
-    "Dispatch final code reviewer subagent for entire implementation" -> "Use superpowers:finishing-a-development-branch";
+    "Dispatch final code reviewer subagent for entire implementation" -> "Use ultrapower:finishing-a-development-branch";
 }
 ```
 
@@ -230,16 +230,16 @@ Done!
 ## 集成
 
 **必需的工作流 skill：**
-- **superpowers:using-git-worktrees** - 必需：开始前设置隔离工作区
-- **superpowers:writing-plans** - 创建此 skill 执行的计划
-- **superpowers:requesting-code-review** - 审查 subagent 的代码审查模板
-- **superpowers:finishing-a-development-branch** - 所有任务完成后结束开发
+- **ultrapower:using-git-worktrees** - 必需：开始前设置隔离工作区
+- **ultrapower:writing-plans** - 创建此 skill 执行的计划
+- **ultrapower:requesting-code-review** - 审查 subagent 的代码审查模板
+- **ultrapower:finishing-a-development-branch** - 所有任务完成后结束开发
 
 **Subagent 应使用：**
-- **superpowers:test-driven-development** - Subagent 为每个任务遵循 TDD
+- **ultrapower:test-driven-development** - Subagent 为每个任务遵循 TDD
 
 **替代工作流：**
-- **superpowers:executing-plans** - 用于并行 session 而非同 session 执行
+- **ultrapower:executing-plans** - 用于并行 session 而非同 session 执行
 
 ## 路由触发
 

package/skills/subagent-driven-development/code-quality-reviewer-prompt.md

@@ -7,7 +7,7 @@
 **仅在规格合规审查通过后才派发。**
 
 ```
-Task tool (superpowers:code-reviewer):
+Task tool (ultrapower:code-reviewer):
   Use template at requesting-code-review/code-reviewer.md
 
   WHAT_WAS_IMPLEMENTED: [来自实现者的报告]

package/skills/systematic-debugging/SKILL.md

@@ -176,7 +176,7 @@ You MUST complete each phase before proceeding to the next.
    - Automated test if possible
    - One-off test script if no framework
    - MUST have before fixing
-   - Use the `superpowers:test-driven-development` skill for writing proper failing tests
+   - Use the `ultrapower:test-driven-development` skill for writing proper failing tests
 
 2. **Implement Single Fix**
    - Address the root cause identified
@@ -284,8 +284,8 @@ These techniques are part of systematic debugging and available in this director
 - **`condition-based-waiting.md`** - Replace arbitrary timeouts with condition polling
 
 **Related skills:**
-- **superpowers:test-driven-development** - For creating failing test case (Phase 4, Step 1)
-- **superpowers:verification-before-completion** - Verify fix worked before claiming success
+- **ultrapower:test-driven-development** - For creating failing test case (Phase 4, Step 1)
+- **ultrapower:verification-before-completion** - Verify fix worked before claiming success
 
 ## Real-World Impact
 

package/skills/trace/SKILL.md

@@ -31,3 +31,44 @@ description: 显示 agent 流程追踪时间线和摘要
 - **模式转换**（执行模式如何变化）
 - **瓶颈**（慢速工具或 agent）
 - **流程模式**（关键词 -> skill -> agent 链）
+
+---
+
+## `--observe` 子命令
+
+当用户运行 `/trace --observe` 或提到"观测"、"observability"时，切换到可观测性模式：
+
+### 说明
+
+使用 `queryEngine` 从 `~/.claude/.omc/observability.db` 查询数据并展示：
+
+```typescript
+import { queryEngine } from 'src/hooks/observability/query-engine.js';
+
+const agentRuns  = queryEngine.getAgentRuns({ last: 10 });
+const toolCalls  = queryEngine.getToolCalls({ last: 10 });
+const costSummary = queryEngine.getCostSummary();
+```
+
+### 输出格式
+
+```markdown
+# Agent 可观测性报告
+
+## Agent 运行摘要（最近10条）
+| agent_type | count | avg_ms | total_ms |
+|------------|-------|--------|----------|
+| executor   | 5     | 1200   | 6000     |
+
+## 工具调用分析（最近10条）
+| tool_name | count | avg_ms | p95_ms | failure_rate |
+|-----------|-------|--------|--------|--------------|
+| Bash      | 20    | 350    | 800    | 0.05         |
+
+## 成本摘要
+| model  | total_cost_usd | input_tokens | output_tokens |
+|--------|----------------|--------------|---------------|
+| sonnet | 0.0123         | 4100         | 1200          |
+```
+
+若数据库不存在或无数据，输出：`（暂无可观测性数据，请确认 observability hooks 已启用）`

package/skills/wizard/SKILL.md

@@ -4,13 +4,13 @@ description: 交互式向导，通过3个问题引导用户选择合适的执行
 ---
 
 <Purpose>
-Wizard 是一个交互式向导，帮助不确定该使用哪个执行模式的用户，通过3个简单问题快速找到最合适的 ultrapower 命令。
+Wizard 是一个交互式向导，帮助新用户在 2 分钟内通过 3 个简单问题找到最合适的执行模式。
 </Purpose>
 
 <Use_When>
-- 用户说 "wizard"、"帮我选"、"不知道用什么"、"怎么开始"、"用哪个命令"
-- 用户面对新任务不知道该用 autopilot/ralph/team/executor 哪个
+- 用户说 "wizard"、"帮我选"、"不知道用什么"、"怎么开始"
 - 用户第一次使用 ultrapower，需要引导
+- 用户不确定该用 autopilot/ralph/team/executor 哪个
 </Use_When>
 
 <Do_Not_Use_When>
@@ -20,109 +20,140 @@ Wizard 是一个交互式向导，帮助不确定该使用哪个执行模式的
 
 <Execution>
 
-## 第一步：问 Q1
+## 实现方式
 
-使用 AskUserQuestion 工具提问：
+使用 `src/features/wizard/` 模块的 `WizardEngine` 类：
 
-```
-问题: "你想做什么？"
-选项:
-  A. 新功能 / 构建新东西
-  B. 修复 bug
-  C. 代码审查
-  D. 重构 / 优化
-```
+```typescript
+import { WizardEngine } from './features/wizard/index.js';
 
-## 第二步：根据 Q1 路由
+const wizard = new WizardEngine();
+```
 
-- **B（修复 bug）** → 直接推荐，跳到输出
-  - 推荐: `systematic-debugging`
-  - 原因: bug 修复需要先定位根因，再修复，systematic-debugging 提供结构化调试流程
+## 问题流程
 
-- **C（代码审查）** → 直接推荐，跳到输出
-  - 推荐: `code-review`
-  - 原因: 代码审查有专门的多维度审查流水线
+### Q1: 你想做什么？
 
-- **A 或 D** → 继续问 Q2
+使用 AskUserQuestion 提问：
 
-## 第三步：问 Q2（仅 A/D 路径）
+```
+问题: "你想做什么？"
+header: "任务类型"
+选项:
+  1. 实现单个功能 — 添加一个新功能或改进现有功能
+  2. 实现多个功能 — 同时开发多个独立或相关的功能
+  3. 修复问题 — 修复 bug、错误或测试失败
+  4. 不确定，需要探索 — 还不清楚具体要做什么，需要先分析
+```
 
-使用 AskUserQuestion 工具提问：
+### Q2: 分支问题（根据 Q1）
 
+**如果 Q1 = 单个功能**，问：
 ```
-问题: "任务复杂度大概是？"
+问题: "任务复杂度？"
+header: "复杂度"
 选项:
-  A. 简单（改动集中在1-2个文件）
-  B. 中等（多文件改动，逻辑比较清晰）
-  C. 复杂（架构级改动，需要规划设计）
+  1. 简单 — 修改 1-3 个文件，逻辑清晰
+  2. 复杂 — 涉及多个模块，需要架构设计
 ```
 
-## 第四步：根据 Q2 路由
-
-- **A（简单）** → 直接推荐，跳到输出
-  - 推荐: `executor agent`
-  - 原因: 单文件改动不需要完整流水线，直接委托 executor 最高效
+**如果 Q1 = 多个功能**，问：
+```
+问题: "功能是否独立？"
+header: "依赖关系"
+选项:
+  1. 是 — 功能之间没有依赖，可以并行开发
+  2. 否 — 功能之间有依赖关系，需要协调
+```
 
-- **C（复杂）** → 直接推荐，跳到输出
-  - 推荐: `team`
-  - 原因: 架构级改动需要 plan→exec→verify 多 agent 协作流水线
+**如果 Q1 = 修复问题**，问：
+```
+问题: "问题范围？"
+header: "影响范围"
+选项:
+  1. 单个文件 — 问题定位明确，影响范围小
+  2. 多个文件 — 问题涉及多个模块或不确定位置
+```
 
-- **B（中等）** → 继续问 Q3
+**如果 Q1 = 不确定**，问：
+```
+问题: "需要规划吗？"
+header: "规划需求"
+选项:
+  1. 是 — 需要先分析和制定计划
+  2. 否 — 直接开始探索
+```
 
-## 第五步：问 Q3（仅中等复杂度路径）
+### Q3: 细化问题（部分路径需要）
 
-使用 AskUserQuestion 工具提问：
+**如果 Q1=单个功能 且 Q2=简单**，问：
+```
+问题: "需要持续执行直到完成？"
+header: "执行模式"
+选项:
+  1. 是 — 不停止直到任务完全完成并验证通过
+  2. 否 — 完成基本实现即可
+```
 
+**如果 Q1=修复问题 且 Q2=多个文件**，问：
 ```
-问题: "这个任务需要持续运行直到完成吗？"
+问题: "需要验证循环？"
+header: "验证策略"
 选项:
-  A. 是，可能需要多轮迭代，不确定几次能完成
-  B. 否，一次性执行，完成就好
+  1. 是 — 修复后需要反复测试验证
+  2. 否 — 修复一次即可
 ```
 
-## 第六步：根据 Q3 路由
+## 推荐逻辑
 
-- **A（需要持续运行）** → 推荐 `ralph`
-- **B（一次性）** → 推荐 `autopilot`
+调用 `getRecommendation()` 获取推荐模式：
 
-## 输出格式
+| Q1 | Q2 | Q3 | 推荐 |
+|---|---|---|---|
+| 单个功能 | 简单 | 否 | executor |
+| 单个功能 | 简单 | 是 | ralph |
+| 单个功能 | 复杂 | - | autopilot |
+| 多个功能 | 独立 | - | ultrawork |
+| 多个功能 | 不独立 | - | team |
+| 修复问题 | 单文件 | - | executor |
+| 修复问题 | 多文件 | 否 | ultrawork |
+| 修复问题 | 多文件 | 是 | ralph |
+| 不确定 | 需要规划 | - | plan |
+| 不确定 | 不需要 | - | 重新回答 Q1 |
 
-每次给出推荐时，使用以下格式：
+## 输出格式
 
 ```
-推荐: /ultrapower:<mode> "<在这里填入你的任务描述>"
+✨ 根据你的回答，我推荐使用: <mode>
 
-原因: <一句话解释为什么这个模式最合适>
+📋 <Mode> 模式说明:
+<一句话描述>
 
-备选方案:
-  - /ultrapower:<alt1>  — <适用场景>
-  - /ultrapower:<alt2>  — <适用场景>
-```
-
-### 各模式备选方案参考
+🎯 使用方式:
+/<mode> "你的任务描述"
 
-**systematic-debugging 的备选**:
-- `/ultrapower:executor` — 如果你已经知道问题在哪，直接修
-- `/ultrapower:analyze` — 如果只需要分析，不需要修复
+💡 示例:
+/<mode> "<具体示例>"
 
-**code-review 的备选**:
-- `/ultrapower:security-review` — 如果专注安全漏洞
-- `/ultrapower:quality-reviewer` — 如果专注代码质量
+❓ 选择:
+1. 确认并执行
+2. 返回重新选择
+3. 查看所有模式
+```
 
-**executor 的备选**:
-- `/ultrapower:autopilot` — 如果任务比预期复杂
-- `/ultrapower:ralph` — 如果需要持续迭代
+### 模式说明参考
 
-**team 的备选**:
-- `/ultrapower:autopilot` — 如果不需要多 agent 并行
-- `/ultrapower:ralph` — 如果需要持续循环直到完成
+- **executor**: 直接实现，适合简单明确的任务
+- **ralph**: 持续执行直到验证通过，适合需要反复迭代的任务
+- **autopilot**: 自主规划和实现，适合复杂的单一功能
+- **ultrawork**: 最大并行度，适合多个独立任务
+- **team**: 协调式团队执行，适合有依赖关系的多任务
+- **plan**: 先制定计划，适合不确定的探索性任务
 
-**ralph 的备选**:
-- `/ultrapower:autopilot` — 如果任务相对确定，一次能完成
-- `/ultrapower:team` — 如果需要多 agent 并行协作
+## 特殊处理
 
-**autopilot 的备选**:
-- `/ultrapower:ralph` — 如果任务可能需要多轮迭代
-- `/ultrapower:team` — 如果需要多个 agent 并行协作
+- 支持 "b" 或 "back" 返回上一步
+- 支持 "q" 或 "quit" 退出向导
+- 无效输入时重新显示当前问题
 
 </Execution>