@liangjie559567/ultrapower 5.5.12 → 5.5.13

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>

package/skills/writing-skills/graphviz-conventions.dot

@@ -1,172 +1,172 @@
-digraph STYLE_GUIDE {
-    // The style guide for our process DSL, written in the DSL itself
-
-    // Node type examples with their shapes
-    subgraph cluster_node_types {
-        label="NODE TYPES AND SHAPES";
-
-        // Questions are diamonds
-        "Is this a question?" [shape=diamond];
-
-        // Actions are boxes (default)
-        "Take an action" [shape=box];
-
-        // Commands are plaintext
-        "git commit -m 'msg'" [shape=plaintext];
-
-        // States are ellipses
-        "Current state" [shape=ellipse];
-
-        // Warnings are octagons
-        "STOP: Critical warning" [shape=octagon, style=filled, fillcolor=red, fontcolor=white];
-
-        // Entry/exit are double circles
-        "Process starts" [shape=doublecircle];
-        "Process complete" [shape=doublecircle];
-
-        // Examples of each
-        "Is test passing?" [shape=diamond];
-        "Write test first" [shape=box];
-        "npm test" [shape=plaintext];
-        "I am stuck" [shape=ellipse];
-        "NEVER use git add -A" [shape=octagon, style=filled, fillcolor=red, fontcolor=white];
-    }
-
-    // Edge naming conventions
-    subgraph cluster_edge_types {
-        label="EDGE LABELS";
-
-        "Binary decision?" [shape=diamond];
-        "Yes path" [shape=box];
-        "No path" [shape=box];
-
-        "Binary decision?" -> "Yes path" [label="yes"];
-        "Binary decision?" -> "No path" [label="no"];
-
-        "Multiple choice?" [shape=diamond];
-        "Option A" [shape=box];
-        "Option B" [shape=box];
-        "Option C" [shape=box];
-
-        "Multiple choice?" -> "Option A" [label="condition A"];
-        "Multiple choice?" -> "Option B" [label="condition B"];
-        "Multiple choice?" -> "Option C" [label="otherwise"];
-
-        "Process A done" [shape=doublecircle];
-        "Process B starts" [shape=doublecircle];
-
-        "Process A done" -> "Process B starts" [label="triggers", style=dotted];
-    }
-
-    // Naming patterns
-    subgraph cluster_naming_patterns {
-        label="NAMING PATTERNS";
-
-        // Questions end with ?
-        "Should I do X?";
-        "Can this be Y?";
-        "Is Z true?";
-        "Have I done W?";
-
-        // Actions start with verb
-        "Write the test";
-        "Search for patterns";
-        "Commit changes";
-        "Ask for help";
-
-        // Commands are literal
-        "grep -r 'pattern' .";
-        "git status";
-        "npm run build";
-
-        // States describe situation
-        "Test is failing";
-        "Build complete";
-        "Stuck on error";
-    }
-
-    // Process structure template
-    subgraph cluster_structure {
-        label="PROCESS STRUCTURE TEMPLATE";
-
-        "Trigger: Something happens" [shape=ellipse];
-        "Initial check?" [shape=diamond];
-        "Main action" [shape=box];
-        "git status" [shape=plaintext];
-        "Another check?" [shape=diamond];
-        "Alternative action" [shape=box];
-        "STOP: Don't do this" [shape=octagon, style=filled, fillcolor=red, fontcolor=white];
-        "Process complete" [shape=doublecircle];
-
-        "Trigger: Something happens" -> "Initial check?";
-        "Initial check?" -> "Main action" [label="yes"];
-        "Initial check?" -> "Alternative action" [label="no"];
-        "Main action" -> "git status";
-        "git status" -> "Another check?";
-        "Another check?" -> "Process complete" [label="ok"];
-        "Another check?" -> "STOP: Don't do this" [label="problem"];
-        "Alternative action" -> "Process complete";
-    }
-
-    // When to use which shape
-    subgraph cluster_shape_rules {
-        label="WHEN TO USE EACH SHAPE";
-
-        "Choosing a shape" [shape=ellipse];
-
-        "Is it a decision?" [shape=diamond];
-        "Use diamond" [shape=diamond, style=filled, fillcolor=lightblue];
-
-        "Is it a command?" [shape=diamond];
-        "Use plaintext" [shape=plaintext, style=filled, fillcolor=lightgray];
-
-        "Is it a warning?" [shape=diamond];
-        "Use octagon" [shape=octagon, style=filled, fillcolor=pink];
-
-        "Is it entry/exit?" [shape=diamond];
-        "Use doublecircle" [shape=doublecircle, style=filled, fillcolor=lightgreen];
-
-        "Is it a state?" [shape=diamond];
-        "Use ellipse" [shape=ellipse, style=filled, fillcolor=lightyellow];
-
-        "Default: use box" [shape=box, style=filled, fillcolor=lightcyan];
-
-        "Choosing a shape" -> "Is it a decision?";
-        "Is it a decision?" -> "Use diamond" [label="yes"];
-        "Is it a decision?" -> "Is it a command?" [label="no"];
-        "Is it a command?" -> "Use plaintext" [label="yes"];
-        "Is it a command?" -> "Is it a warning?" [label="no"];
-        "Is it a warning?" -> "Use octagon" [label="yes"];
-        "Is it a warning?" -> "Is it entry/exit?" [label="no"];
-        "Is it entry/exit?" -> "Use doublecircle" [label="yes"];
-        "Is it entry/exit?" -> "Is it a state?" [label="no"];
-        "Is it a state?" -> "Use ellipse" [label="yes"];
-        "Is it a state?" -> "Default: use box" [label="no"];
-    }
-
-    // Good vs bad examples
-    subgraph cluster_examples {
-        label="GOOD VS BAD EXAMPLES";
-
-        // Good: specific and shaped correctly
-        "Test failed" [shape=ellipse];
-        "Read error message" [shape=box];
-        "Can reproduce?" [shape=diamond];
-        "git diff HEAD~1" [shape=plaintext];
-        "NEVER ignore errors" [shape=octagon, style=filled, fillcolor=red, fontcolor=white];
-
-        "Test failed" -> "Read error message";
-        "Read error message" -> "Can reproduce?";
-        "Can reproduce?" -> "git diff HEAD~1" [label="yes"];
-
-        // Bad: vague and wrong shapes
-        bad_1 [label="Something wrong", shape=box];  // Should be ellipse (state)
-        bad_2 [label="Fix it", shape=box];  // Too vague
-        bad_3 [label="Check", shape=box];  // Should be diamond
-        bad_4 [label="Run command", shape=box];  // Should be plaintext with actual command
-
-        bad_1 -> bad_2;
-        bad_2 -> bad_3;
-        bad_3 -> bad_4;
-    }
+digraph STYLE_GUIDE {
+    // The style guide for our process DSL, written in the DSL itself
+
+    // Node type examples with their shapes
+    subgraph cluster_node_types {
+        label="NODE TYPES AND SHAPES";
+
+        // Questions are diamonds
+        "Is this a question?" [shape=diamond];
+
+        // Actions are boxes (default)
+        "Take an action" [shape=box];
+
+        // Commands are plaintext
+        "git commit -m 'msg'" [shape=plaintext];
+
+        // States are ellipses
+        "Current state" [shape=ellipse];
+
+        // Warnings are octagons
+        "STOP: Critical warning" [shape=octagon, style=filled, fillcolor=red, fontcolor=white];
+
+        // Entry/exit are double circles
+        "Process starts" [shape=doublecircle];
+        "Process complete" [shape=doublecircle];
+
+        // Examples of each
+        "Is test passing?" [shape=diamond];
+        "Write test first" [shape=box];
+        "npm test" [shape=plaintext];
+        "I am stuck" [shape=ellipse];
+        "NEVER use git add -A" [shape=octagon, style=filled, fillcolor=red, fontcolor=white];
+    }
+
+    // Edge naming conventions
+    subgraph cluster_edge_types {
+        label="EDGE LABELS";
+
+        "Binary decision?" [shape=diamond];
+        "Yes path" [shape=box];
+        "No path" [shape=box];
+
+        "Binary decision?" -> "Yes path" [label="yes"];
+        "Binary decision?" -> "No path" [label="no"];
+
+        "Multiple choice?" [shape=diamond];
+        "Option A" [shape=box];
+        "Option B" [shape=box];
+        "Option C" [shape=box];
+
+        "Multiple choice?" -> "Option A" [label="condition A"];
+        "Multiple choice?" -> "Option B" [label="condition B"];
+        "Multiple choice?" -> "Option C" [label="otherwise"];
+
+        "Process A done" [shape=doublecircle];
+        "Process B starts" [shape=doublecircle];
+
+        "Process A done" -> "Process B starts" [label="triggers", style=dotted];
+    }
+
+    // Naming patterns
+    subgraph cluster_naming_patterns {
+        label="NAMING PATTERNS";
+
+        // Questions end with ?
+        "Should I do X?";
+        "Can this be Y?";
+        "Is Z true?";
+        "Have I done W?";
+
+        // Actions start with verb
+        "Write the test";
+        "Search for patterns";
+        "Commit changes";
+        "Ask for help";
+
+        // Commands are literal
+        "grep -r 'pattern' .";
+        "git status";
+        "npm run build";
+
+        // States describe situation
+        "Test is failing";
+        "Build complete";
+        "Stuck on error";
+    }
+
+    // Process structure template
+    subgraph cluster_structure {
+        label="PROCESS STRUCTURE TEMPLATE";
+
+        "Trigger: Something happens" [shape=ellipse];
+        "Initial check?" [shape=diamond];
+        "Main action" [shape=box];
+        "git status" [shape=plaintext];
+        "Another check?" [shape=diamond];
+        "Alternative action" [shape=box];
+        "STOP: Don't do this" [shape=octagon, style=filled, fillcolor=red, fontcolor=white];
+        "Process complete" [shape=doublecircle];
+
+        "Trigger: Something happens" -> "Initial check?";
+        "Initial check?" -> "Main action" [label="yes"];
+        "Initial check?" -> "Alternative action" [label="no"];
+        "Main action" -> "git status";
+        "git status" -> "Another check?";
+        "Another check?" -> "Process complete" [label="ok"];
+        "Another check?" -> "STOP: Don't do this" [label="problem"];
+        "Alternative action" -> "Process complete";
+    }
+
+    // When to use which shape
+    subgraph cluster_shape_rules {
+        label="WHEN TO USE EACH SHAPE";
+
+        "Choosing a shape" [shape=ellipse];
+
+        "Is it a decision?" [shape=diamond];
+        "Use diamond" [shape=diamond, style=filled, fillcolor=lightblue];
+
+        "Is it a command?" [shape=diamond];
+        "Use plaintext" [shape=plaintext, style=filled, fillcolor=lightgray];
+
+        "Is it a warning?" [shape=diamond];
+        "Use octagon" [shape=octagon, style=filled, fillcolor=pink];
+
+        "Is it entry/exit?" [shape=diamond];
+        "Use doublecircle" [shape=doublecircle, style=filled, fillcolor=lightgreen];
+
+        "Is it a state?" [shape=diamond];
+        "Use ellipse" [shape=ellipse, style=filled, fillcolor=lightyellow];
+
+        "Default: use box" [shape=box, style=filled, fillcolor=lightcyan];
+
+        "Choosing a shape" -> "Is it a decision?";
+        "Is it a decision?" -> "Use diamond" [label="yes"];
+        "Is it a decision?" -> "Is it a command?" [label="no"];
+        "Is it a command?" -> "Use plaintext" [label="yes"];
+        "Is it a command?" -> "Is it a warning?" [label="no"];
+        "Is it a warning?" -> "Use octagon" [label="yes"];
+        "Is it a warning?" -> "Is it entry/exit?" [label="no"];
+        "Is it entry/exit?" -> "Use doublecircle" [label="yes"];
+        "Is it entry/exit?" -> "Is it a state?" [label="no"];
+        "Is it a state?" -> "Use ellipse" [label="yes"];
+        "Is it a state?" -> "Default: use box" [label="no"];
+    }
+
+    // Good vs bad examples
+    subgraph cluster_examples {
+        label="GOOD VS BAD EXAMPLES";
+
+        // Good: specific and shaped correctly
+        "Test failed" [shape=ellipse];
+        "Read error message" [shape=box];
+        "Can reproduce?" [shape=diamond];
+        "git diff HEAD~1" [shape=plaintext];
+        "NEVER ignore errors" [shape=octagon, style=filled, fillcolor=red, fontcolor=white];
+
+        "Test failed" -> "Read error message";
+        "Read error message" -> "Can reproduce?";
+        "Can reproduce?" -> "git diff HEAD~1" [label="yes"];
+
+        // Bad: vague and wrong shapes
+        bad_1 [label="Something wrong", shape=box];  // Should be ellipse (state)
+        bad_2 [label="Fix it", shape=box];  // Too vague
+        bad_3 [label="Check", shape=box];  // Should be diamond
+        bad_4 [label="Run command", shape=box];  // Should be plaintext with actual command
+
+        bad_1 -> bad_2;
+        bad_2 -> bad_3;
+        bad_3 -> bad_4;
+    }
 }