@liangjie559567/ultrapower 5.0.4

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

@@ -0,0 +1,162 @@
+---
+name: next-step-router
+description: 在关键节点分析产出内容，用 AskUserQuestion 推荐最优下一步 agent/skill，并完整传递上下文
+---
+
+# Next Step Router
+
+## 触发方式
+
+由其他 skill 在关键节点末尾调用，传入以下参数：
+- `current_skill`: 当前完成的 skill 名称（如 "brainstorming"）
+- `stage`: 当前阶段标识（如 "design_approved", "root_cause_confirmed", "plan_committed"）
+- `output_summary`: 当前 skill 的产出摘要（文件数、变更类型、关键决策）
+- `full_context`: 完整上下文对象
+  - `doc_paths`: 相关文档路径列表
+  - `key_decisions`: 用户已确认的关键决策
+  - `user_direction`: 用户选择的方向（前端/后端/架构/调试）
+  - `codebase_summary`: explore agent 的代码库理解摘要（如有）
+
+## 智能分析逻辑
+
+### 第一步：分析产出信号
+
+分析 output_summary：
+- 文件数 > 10          → 推荐 deep-executor 而非 executor
+- 含 "security"/"auth" → 触发 security-reviewer 分支
+- 含 "architecture"    → 推荐 architect 而非 planner
+- 含 "performance"     → 触发 performance-reviewer 分支
+- 含 "API change"      → 推荐 api-reviewer
+- 文件数 1-3           → 推荐 executor（轻量）
+- 含 "UI"/"component"/"frontend" → 推荐 frontend-ui-ux skill
+- 含 "research"/"analysis"       → 推荐 sciomc skill
+- 含 "external"/"reference"      → 推荐 external-context skill
+- 首次初始化代码库                → 推荐 deepinit skill
+
+### 第二步：结合用户上下文
+
+full_context.user_direction:
+- "frontend"  → 优先 frontend-ui-ux skill → designer agent
+- "backend"   → 优先 executor agent
+- "debug"     → 优先 debugger agent
+- "architect" → 优先 architect agent
+- "research"  → 优先 sciomc skill → external-context skill
+
+### 第三步：查路由映射表
+
+根据 current_skill + stage 组合查完整路由映射表，得到：
+- 主推 agent/skill（置信度 60-95%）
+- 备选 agent/skill（置信度 30-60%）
+- 推荐理由
+
+## 完整路由映射表
+
+### 阶段0：探索（强制前置）
+
+| current_skill | stage | 主推 | 备选 |
+|---|---|---|---|
+| explore | codebase_understood (AGENTS.md 已存在) | brainstorming | systematic-debugging |
+| explore | codebase_understood (AGENTS.md 不存在) | deepinit | brainstorming |
+| deepinit | agents_md_generated | brainstorming | sciomc |
+| explore | codebase_understood (需深度研究) | sciomc | brainstorming |
+| sciomc | analysis_report_complete | brainstorming | external-context |
+| external-context | external_context_gathered | brainstorming | sciomc |
+
+### 阶段1：探索与设计
+
+| current_skill | stage | 主推 | 备选 |
+|---|---|---|---|
+| using-superpowers | explore_complete | brainstorming | systematic-debugging |
+| brainstorming | design_approved | writing-plans | architect |
+| brainstorming | ui_design_needed | frontend-ui-ux | designer |
+| ralplan | consensus_reached | writing-plans | architect |
+| frontend-ui-ux | ui_design_approved | writing-plans | brainstorming |
+
+### 阶段2：规划与隔离
+
+| current_skill | stage | 主推 | 备选 |
+|---|---|---|---|
+| writing-plans | plan_committed | using-git-worktrees | subagent-driven-development |
+| using-git-worktrees | worktree_ready | subagent-driven-development | executing-plans |
+
+### 阶段3：实现
+
+| current_skill | stage | 主推 | 备选 |
+|---|---|---|---|
+| writing-plans | plan_committed (多组件) | team | ralph |
+| subagent-driven-development | subagent_task_complete | requesting-code-review | quality-reviewer |
+| executing-plans | batch_complete | requesting-code-review | verification-before-completion |
+| dispatching-parallel-agents | all_results_returned | verifier | quality-reviewer |
+
+### 阶段3b：调试支路
+
+| current_skill | stage | 主推 | 备选 |
+|---|---|---|---|
+| systematic-debugging | root_cause_confirmed | test-driven-development | executor |
+| test-driven-development | green_complete | requesting-code-review | verification-before-completion |
+
+### 阶段4：审查
+
+| current_skill | stage | 主推 | 备选 |
+|---|---|---|---|
+| requesting-code-review | review_returned | receiving-code-review | executor |
+| receiving-code-review | review_addressed | verification-before-completion | finishing-a-development-branch |
+
+### 阶段5：验证
+
+| current_skill | stage | 主推 | 备选 |
+|---|---|---|---|
+| verification-before-completion | verification_passed | build-fixer | finishing-a-development-branch |
+
+### 阶段6：部署测试
+
+| current_skill | stage | 主推 | 备选 |
+|---|---|---|---|
+| qa-tester | tests_failed | ultraqa | executor |
+| qa-tester | tests_passed | test-engineer | product-manager |
+| ultraqa | all_tests_passed | test-engineer | product-manager |
+
+### 阶段7：产品验收
+
+| current_skill | stage | 主推 | 备选 |
+|---|---|---|---|
+| product-manager | prd_accepted | ux-researcher | finishing-a-development-branch |
+| ux-researcher | ux_audit_complete | finishing-a-development-branch | executor |
+
+### 阶段8：收尾与发布
+
+| current_skill | stage | 主推 | 备选 |
+|---|---|---|---|
+| finishing-a-development-branch | merge_strategy_confirmed | git-master | verifier |
+| git-master | pr_merged | release | — |
+
+## 输出格式
+
+用 AskUserQuestion 呈现（最多4个选项）：
+
+选项1: [主推] agent/skill 名称
+  理由: 基于[信号]，置信度[X]%
+选项2: [备选] agent/skill 名称
+  理由: [简短说明]
+选项3: 跳过，我自己决定
+选项4: 查看完整路由映射表（展示上方完整路由映射表）
+
+## 用户确认后的处理
+
+用户选择主推或备选后：
+1. 调用 `notepad_write_working` 记录本次路由决策（current_skill、stage、选定目标、置信度）
+2. 调用 `notepad_read` 获取完整 `full_context`，传递给选定 agent/skill
+3. 在传递时附加本次路由决策记录（用于后续追溯）
+
+用户选择"跳过，我自己决定"时：
+1. 调用 `notepad_write_working` 保留当前 `full_context`（不丢失上下文）
+2. 不触发任何 agent/skill，等待用户下一条消息
+
+## 错误处理路由
+
+| 失败类型 | 路由到 | 说明 |
+|---|---|---|
+| executor 超时/崩溃 | debugger agent | 分析失败原因，再决定是否重试 |
+| build-fixer 无法修复 | 上报用户 + notepad 记录 | 超出自动修复能力，需人工介入 |
+| verifier 无法验证 | quality-reviewer agent | 换角度验证 |
+| 任意 agent 连续失败2次 | 上报用户 | 避免无限循环，保留上下文供用户决策 |

package/skills/note/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: note
+description: 将笔记保存到 notepad.md 以防对话压缩丢失
+---
+
+# Note Skill
+
+将重要上下文保存到 `.omc/notepad.md`，在对话压缩后仍可保留。
+
+## 用法
+
+| 命令 | 操作 |
+|---------|--------|
+| `/ultrapower:note <内容>` | 带时间戳添加到工作记忆 |
+| `/ultrapower:note --priority <内容>` | 添加到优先上下文（始终加载） |
+| `/ultrapower:note --manual <内容>` | 添加到 MANUAL 区块（永不清除） |
+| `/ultrapower:note --show` | 显示当前笔记本内容 |
+| `/ultrapower:note --prune` | 删除 7 天前的条目 |
+| `/ultrapower:note --clear` | 清除工作记忆（保留优先上下文和 MANUAL） |
+
+## 区块说明
+
+### 优先上下文（500 字符限制）
+- **始终**在会话开始时注入
+- 用于关键事实：如"项目使用 pnpm"、"API 在 src/api/client.ts"
+- 保持简短——这会占用你的上下文预算
+
+### 工作记忆
+- 带时间戳的会话笔记
+- 7 天后自动清除
+- 适合：调试线索、临时发现
+
+### MANUAL
+- 永不自动清除
+- 用户控制的永久笔记
+- 适合：团队联系方式、部署信息
+
+## 示例
+
+```
+/ultrapower:note Found auth bug in UserContext - missing useEffect dependency
+/ultrapower:note --priority Project uses TypeScript strict mode, all files in src/
+/ultrapower:note --manual Contact: api-team@company.com for backend questions
+/ultrapower:note --show
+/ultrapower:note --prune
+```
+
+## 行为
+
+1. 如果 `.omc/notepad.md` 不存在则创建
+2. 解析参数以确定目标区块
+3. 追加内容并附带时间戳（工作记忆）
+4. 如果优先上下文超过 500 字符则发出警告
+5. 确认已保存的内容
+
+## 集成
+
+笔记本内容在会话开始时自动加载：
+- 优先上下文：始终加载
+- 工作记忆：如有近期条目则加载
+
+这有助于在对话压缩后不丢失关键上下文。

package/skills/omc-doctor/SKILL.md

@@ -0,0 +1,188 @@
+---
+name: omc-doctor
+description: 诊断并修复 ultrapower 安装问题
+---
+
+# Doctor Skill
+
+注意：本指南中所有 `~/.claude/...` 路径在设置了 `CLAUDE_CONFIG_DIR` 环境变量时均遵循该变量。
+
+## 任务：运行安装诊断
+
+你是 OMC Doctor——负责诊断并修复安装问题。
+
+### 第一步：检查插件版本
+
+```bash
+# 获取已安装版本和最新版本（跨平台）
+node -e "const p=require('path'),f=require('fs'),h=require('os').homedir(),d=process.env.CLAUDE_CONFIG_DIR||p.join(h,'.claude'),b=p.join(d,'plugins','cache','omc','ultrapower');try{const v=f.readdirSync(b).filter(x=>/^\d/.test(x)).sort((a,c)=>a.localeCompare(c,void 0,{numeric:true}));console.log('Installed:',v.length?v[v.length-1]:'(none)')}catch{console.log('Installed: (none)')}"
+npm view oh-my-claude-sisyphus version 2>/dev/null || echo "Latest: (unavailable)"
+```
+
+**诊断**：
+- 未安装版本：严重错误——插件未安装
+- 已安装版本 != 最新版本：警告——插件已过时
+- 存在多个版本：警告——缓存陈旧
+
+### 第二步：检查 settings.json 中的旧版 hook
+
+读取 `~/.claude/settings.json`（用户级）和 `./.claude/settings.json`（项目级），检查是否存在包含以下条目的 `"hooks"` 键：
+- `bash $HOME/.claude/hooks/keyword-detector.sh`
+- `bash $HOME/.claude/hooks/persistent-mode.sh`
+- `bash $HOME/.claude/hooks/session-start.sh`
+
+**诊断**：
+- 如果找到：严重错误——旧版 hook 导致重复执行
+
+### 第三步：检查旧版 Bash hook 脚本
+
+```bash
+ls -la ~/.claude/hooks/*.sh 2>/dev/null
+```
+
+**诊断**：
+- 如果存在 `keyword-detector.sh`、`persistent-mode.sh`、`session-start.sh` 或 `stop-continuation.sh`：警告——旧版脚本（可能引起混乱）
+
+### 第四步：检查 CLAUDE.md
+
+```bash
+# 检查 CLAUDE.md 是否存在
+ls -la ~/.claude/CLAUDE.md 2>/dev/null
+
+# 检查 OMC 标记
+grep -q "ultrapower Multi-Agent System" ~/.claude/CLAUDE.md 2>/dev/null && echo "Has OMC config" || echo "Missing OMC config"
+```
+
+**诊断**：
+- 缺失：严重错误——CLAUDE.md 未配置
+- 缺少 OMC 标记：警告——CLAUDE.md 已过时
+
+### 第五步：检查陈旧的插件缓存
+
+```bash
+# 统计缓存中的版本数（跨平台）
+node -e "const p=require('path'),f=require('fs'),h=require('os').homedir(),d=process.env.CLAUDE_CONFIG_DIR||p.join(h,'.claude'),b=p.join(d,'plugins','cache','omc','ultrapower');try{const v=f.readdirSync(b).filter(x=>/^\d/.test(x));console.log(v.length+' version(s):',v.join(', '))}catch{console.log('0 versions')}"
+```
+
+**诊断**：
+- 超过 1 个版本：警告——存在多个缓存版本（建议清理）
+
+### 第六步：检查旧版 curl 安装内容
+
+检查通过 curl 安装的旧版 agent、命令和 skill（插件系统之前的方式）：
+
+```bash
+# 检查旧版 agents 目录
+ls -la ~/.claude/agents/ 2>/dev/null
+
+# 检查旧版 commands 目录
+ls -la ~/.claude/commands/ 2>/dev/null
+
+# 检查旧版 skills 目录
+ls -la ~/.claude/skills/ 2>/dev/null
+```
+
+**诊断**：
+- `~/.claude/agents/` 存在且含 ultrapower 相关文件：警告——旧版 agent（现由插件提供）
+- `~/.claude/commands/` 存在且含 ultrapower 相关文件：警告——旧版命令（现由插件提供）
+- `~/.claude/skills/` 存在且含 ultrapower 相关文件：警告——旧版 skill（现由插件提供）
+
+查找以下文件：
+- agents/ 中的 `architect.md`、`document-specialist.md`、`explore.md`、`executor.md` 等
+- commands/ 中的 `ultrawork.md`、`deepsearch.md` 等
+- skills/ 中任何 ultrapower 相关的 `.md` 文件
+
+---
+
+## 报告格式
+
+运行所有检查后，输出报告：
+
+```
+## OMC Doctor 报告
+
+### 摘要
+[健康 / 发现问题]
+
+### 检查项
+
+| 检查项 | 状态 | 详情 |
+|-------|--------|---------|
+| 插件版本 | OK/WARN/CRITICAL | ... |
+| 旧版 Hook (settings.json) | OK/CRITICAL | ... |
+| 旧版脚本 (~/.claude/hooks/) | OK/WARN | ... |
+| CLAUDE.md | OK/WARN/CRITICAL | ... |
+| 插件缓存 | OK/WARN | ... |
+| 旧版 Agent (~/.claude/agents/) | OK/WARN | ... |
+| 旧版命令 (~/.claude/commands/) | OK/WARN | ... |
+| 旧版 Skill (~/.claude/skills/) | OK/WARN | ... |
+
+### 发现的问题
+1. [问题描述]
+2. [问题描述]
+
+### 建议修复方案
+[根据问题列出修复方案]
+```
+
+---
+
+## 自动修复（用户确认后）
+
+如果发现问题，询问用户："是否希望我自动修复这些问题？"
+
+如果同意，执行修复：
+
+### 修复：settings.json 中的旧版 Hook
+从 `~/.claude/settings.json` 中删除 `"hooks"` 部分（保留其他设置）
+
+### 修复：旧版 Bash 脚本
+```bash
+rm -f ~/.claude/hooks/keyword-detector.sh
+rm -f ~/.claude/hooks/persistent-mode.sh
+rm -f ~/.claude/hooks/session-start.sh
+rm -f ~/.claude/hooks/stop-continuation.sh
+```
+
+### 修复：过时的插件
+```bash
+# 清除插件缓存（跨平台）
+node -e "const p=require('path'),f=require('fs'),d=process.env.CLAUDE_CONFIG_DIR||p.join(require('os').homedir(),'.claude'),b=p.join(d,'plugins','cache','omc','ultrapower');try{f.rmSync(b,{recursive:true,force:true});console.log('Plugin cache cleared. Restart Claude Code to fetch latest version.')}catch{console.log('No plugin cache found')}"
+```
+
+### 修复：陈旧缓存（多个版本）
+```bash
+# 仅保留最新版本（跨平台）
+node -e "const p=require('path'),f=require('fs'),h=require('os').homedir(),d=process.env.CLAUDE_CONFIG_DIR||p.join(h,'.claude'),b=p.join(d,'plugins','cache','omc','ultrapower');try{const v=f.readdirSync(b).filter(x=>/^\d/.test(x)).sort((a,c)=>a.localeCompare(c,void 0,{numeric:true}));v.slice(0,-1).forEach(x=>f.rmSync(p.join(b,x),{recursive:true,force:true}));console.log('Removed',v.length-1,'old version(s)')}catch(e){console.log('No cache to clean')}"
+```
+
+### 修复：缺失/过时的 CLAUDE.md
+从 GitHub 获取最新版本并写入 `~/.claude/CLAUDE.md`：
+```
+WebFetch(url: "https://raw.githubusercontent.com/Yeachan-Heo/ultrapower/main/docs/CLAUDE.md", prompt: "Return the complete raw markdown content exactly as-is")
+```
+
+### 修复：旧版 curl 安装内容
+
+删除旧版 agent、命令和 skill 目录（现由插件提供）：
+
+```bash
+# 可选先备份（询问用户）
+# mv ~/.claude/agents ~/.claude/agents.bak
+# mv ~/.claude/commands ~/.claude/commands.bak
+# mv ~/.claude/skills ~/.claude/skills.bak
+
+# 或直接删除
+rm -rf ~/.claude/agents
+rm -rf ~/.claude/commands
+rm -rf ~/.claude/skills
+```
+
+**注意**：仅在这些目录包含 ultrapower 相关文件时才删除。如果用户有自定义 agent/命令/skill，请先警告并询问。
+
+---
+
+## 修复后
+
+应用修复后，告知用户：
+> 修复已应用。**重启 Claude Code** 使更改生效。

package/skills/omc-help/SKILL.md

@@ -0,0 +1,192 @@
+---
+name: omc-help
+description: ultrapower 插件使用指南
+---
+
+# OMC 工作原理
+
+**你不需要学习任何命令！** OMC 为 Claude Code 增加了智能行为，这些行为会自动激活。
+
+## 自动发生的事情
+
+| 当你... | 我会自动... |
+|-------------|-------------------|
+| 给我一个复杂任务 | 并行化并委托给专业 agent |
+| 让我规划某事 | 启动规划访谈 |
+| 需要彻底完成某事 | 持续执行直到验证完成 |
+| 处理 UI/前端工作 | 激活设计感知 |
+| 说"stop"或"cancel" | 智能停止当前操作 |
+
+## 魔法关键词（可选快捷方式）
+
+你可以在请求中自然地包含这些词来进行显式控制：
+
+| 关键词 | 效果 | 示例 |
+|---------|--------|---------|
+| **ralph** | 持久化模式 | "ralph: fix all the bugs" |
+| **ralplan** | 迭代规划 | "ralplan this feature" |
+| **ulw** | 最大并行度 | "ulw refactor the API" |
+| **plan** | 规划访谈 | "plan the new endpoints" |
+
+**ralph 包含 ultrawork：** 激活 ralph 模式时，它会自动包含 ultrawork 的并行执行。无需组合关键词。
+
+## 停止操作
+
+直接说：
+- "stop"
+- "cancel"
+- "abort"
+
+我会根据上下文判断停止什么。
+
+## 首次设置
+
+如果你还没有配置 OMC：
+
+```
+/ultrapower:omc-setup
+```
+
+这是**唯一需要记住的命令**。它会下载配置，然后就完成了。
+
+## 2.x 版本用户
+
+你的旧命令仍然有效！`/ralph`、`/ultrawork`、`/plan` 等功能与之前完全相同。
+
+但现在你不再**需要**它们——一切都是自动的。
+
+---
+
+## 使用分析
+
+分析你的 ultrapower 使用情况，获取个性化建议以改善工作流。
+
+> 注意：此功能替代了原来的 `/ultrapower:learn-about-omc` skill。
+
+### 功能说明
+
+1. 从 `~/.omc/state/token-tracking.jsonl` 读取 token 追踪数据
+2. 从 `.omc/state/session-history.json` 读取会话历史
+3. 分析 agent 使用模式
+4. 识别未充分利用的功能
+5. 推荐配置更改
+
+### 第一步：收集数据
+
+```bash
+# 检查 token 追踪数据
+TOKEN_FILE="$HOME/.omc/state/token-tracking.jsonl"
+SESSION_FILE=".omc/state/session-history.json"
+CONFIG_FILE="$HOME/.claude/.omc-config.json"
+
+echo "Analyzing OMC Usage..."
+echo ""
+
+# 检查可用数据
+HAS_TOKENS=false
+HAS_SESSIONS=false
+HAS_CONFIG=false
+
+if [[ -f "$TOKEN_FILE" ]]; then
+  HAS_TOKENS=true
+  TOKEN_COUNT=$(wc -l < "$TOKEN_FILE")
+  echo "Token records found: $TOKEN_COUNT"
+fi
+
+if [[ -f "$SESSION_FILE" ]]; then
+  HAS_SESSIONS=true
+  SESSION_COUNT=$(cat "$SESSION_FILE" | jq '.sessions | length' 2>/dev/null || echo "0")
+  echo "Sessions found: $SESSION_COUNT"
+fi
+
+if [[ -f "$CONFIG_FILE" ]]; then
+  HAS_CONFIG=true
+  DEFAULT_MODE=$(cat "$CONFIG_FILE" | jq -r '.defaultExecutionMode // "not set"')
+  echo "Default execution mode: $DEFAULT_MODE"
+fi
+```
+
+### 第二步：分析 Agent 使用情况（如有 token 数据）
+
+```bash
+if [[ "$HAS_TOKENS" == "true" ]]; then
+  echo ""
+  echo "TOP AGENTS BY USAGE:"
+  cat "$TOKEN_FILE" | jq -r '.agentName // "main"' | sort | uniq -c | sort -rn | head -10
+
+  echo ""
+  echo "MODEL DISTRIBUTION:"
+  cat "$TOKEN_FILE" | jq -r '.modelName' | sort | uniq -c | sort -rn
+fi
+```
+
+### 第三步：生成建议
+
+根据发现的模式输出建议：
+
+**如果 Opus 使用率高（>40%）且无相应配置：**
+- "考虑对常规任务使用更低级别模型以节省 token"
+
+**如果未使用 pipeline：**
+- "尝试 /pipeline 用于代码审查工作流"
+
+**如果未使用 security-reviewer：**
+- "在 auth/API 更改后使用 security-reviewer"
+
+**如果未设置 defaultExecutionMode：**
+- "在 /omc-setup 中设置 defaultExecutionMode 以获得一致行为"
+
+### 第四步：输出报告
+
+格式化摘要，包含：
+- Token 摘要（总计、按模型分类）
+- 最常用的 agent
+- 未充分利用的功能
+- 个性化建议
+
+### 示例输出
+
+```
+📊 你的 OMC 使用分析
+
+TOKEN 摘要：
+- 总记录数：1,234
+- 按模型：opus 45%，sonnet 40%，haiku 15%
+
+最常用 AGENT：
+1. executor（234 次）
+2. architect（89 次）
+3. explore（67 次）
+
+未充分利用的功能：
+- 低级别模型：0 次使用（可节省约 30% 常规任务费用）
+- pipeline：0 次使用（非常适合审查工作流）
+
+建议：
+1. 设置 defaultExecutionMode 以节省 token
+2. 尝试 /pipeline review 进行 PR 审查
+3. 在 architect 之前使用 explore agent 以节省上下文
+```
+
+### 优雅降级
+
+如果未找到数据：
+
+```
+📊 可用使用数据有限
+
+未找到 token 追踪数据。要启用追踪：
+1. 确保 ~/.omc/state/ 目录存在
+2. 运行任意 OMC 命令开始追踪
+
+提示：运行 /omc-setup 正确配置 OMC。
+```
+
+## 需要更多帮助？
+
+- **README**：https://github.com/Yeachan-Heo/ultrapower
+- **Issues**：https://github.com/Yeachan-Heo/ultrapower/issues
+
+---
+
+*版本：4.2.3*