@liangjie559567/ultrapower 5.6.6 → 5.6.8

package/docs/MIGRATION.md

@@ -6,15 +6,23 @@
 
 ## 目录
 
-- [v5.0.3 → v5.0.9: HUD 英文化 + 5 个新 Agent + MCP 扩展](#v503--v509-hud-英文化--5-个新-agent--mcp-扩展)
-- [v5.0.2 → v5.0.3: Axiom 专家 Agent 扩展](#v502--v503-axiom-专家-agent-扩展)
-- [v5.0 → v5.0.2: Axiom 框架深度融合](#v50--v502-axiom-框架深度融合)
-- [v4.x → v5.0: ultrapower 集成与功能扩展](#v4x--v50-ultrapower-集成与功能扩展)
-- [v3.5.3 → v3.5.5: Test Fixes & Cleanup](#v353--v355-test-fixes--cleanup)
-- [v3.5.2 → v3.5.3: Skill Consolidation](#v352--v353-skill-consolidation)
-- [v2.x → v3.0: Package Rename & Auto-Activation](#v2x--v30-package-rename--auto-activation)
-- [v3.0 → v3.1: Notepad Wisdom & Enhanced Features](#v30--v31-notepad-wisdom--enhanced-features)
-- [v3.x → v4.0: Major Architecture Overhaul](#v3x--v40-major-architecture-overhaul)
+* [v5.0.3 → v5.0.9: HUD 英文化 + 5 个新 Agent + MCP 扩展](#v503--v509-hud-英文化--5-个新-agent--mcp-扩展)
+
+* [v5.0.2 → v5.0.3: Axiom 专家 Agent 扩展](#v502--v503-axiom-专家-agent-扩展)
+
+* [v5.0 → v5.0.2: Axiom 框架深度融合](#v50--v502-axiom-框架深度融合)
+
+* [v4.x → v5.0: ultrapower 集成与功能扩展](#v4x--v50-ultrapower-集成与功能扩展)
+
+* [v3.5.3 → v3.5.5: Test Fixes & Cleanup](#v353--v355-test-fixes--cleanup)
+
+* [v3.5.2 → v3.5.3: Skill Consolidation](#v352--v353-skill-consolidation)
+
+* [v2.x → v3.0: Package Rename & Auto-Activation](#v2x--v30-package-rename--auto-activation)
+
+* [v3.0 → v3.1: Notepad Wisdom & Enhanced Features](#v30--v31-notepad-wisdom--enhanced-features)
+
+* [v3.x → v4.0: Major Architecture Overhaul](#v3x--v40-major-architecture-overhaul)
 
 ---
 
@@ -26,27 +34,41 @@ v5.0.9 修复了 HUD 标签英文化问题，新增 5 个领域专家 Agent 和
 
 ### 修复
 
-- **HUD 标签英文化**：所有 HUD 元素标签恢复为英文（`行` → `lines`、`有更新` → `omc update`、`仓库:` → `repo:` 等）
-- **HUD autoCompact 无限循环**：修复 context-warning 在上下文恢复正常后仍持续触发 compact 的 bug
-- **DEFAULT_HUD_CONFIG 默认值**：`maxOutputLines: 6` → `4`，`gitBranch/model` 默认关闭
-- **MINGW64 兼容性**：修复 Git Bash 下 `!` 字符转义问题
+* **HUD 标签英文化**：所有 HUD 元素标签恢复为英文（`行` → `lines`、`有更新` → `omc update`、`仓库:` → `repo:` 等）
+
+* **HUD autoCompact 无限循环**：修复 context-warning 在上下文恢复正常后仍持续触发 compact 的 bug
+
+* **DEFAULT_HUD_CONFIG 默认值**：`maxOutputLines: 6` → `4`，`gitBranch/model` 默认关闭
+
+* **MINGW64 兼容性**：修复 Git Bash 下 `!` 字符转义问题
 
 ### 新增功能
 
 **49 个专业 Agent**（新增 5 个领域专家）：
-- `database-expert`：数据库 schema 设计、查询优化、索引策略和迁移方案
-- `devops-engineer`：CI/CD 流水线、Docker/Kubernetes 容器化、基础设施即代码
-- `i18n-specialist`：国际化架构、本地化工作流、多语言文本管理
-- `accessibility-auditor`：WCAG 2.1/2.2 合规审查、键盘导航、屏幕阅读器兼容
-- `api-designer`：REST/GraphQL API 设计、OpenAPI 规范、版本策略
+
+* `database-expert`：数据库 schema 设计、查询优化、索引策略和迁移方案
+
+* `devops-engineer`：CI/CD 流水线、Docker/Kubernetes 容器化、基础设施即代码
+
+* `i18n-specialist`：国际化架构、本地化工作流、多语言文本管理
+
+* `accessibility-auditor`：WCAG 2.1/2.2 合规审查、键盘导航、屏幕阅读器兼容
+
+* `api-designer`：REST/GraphQL API 设计、OpenAPI 规范、版本策略
 
 **MCP 集成扩展**（`skills/mcp-setup`）：
-- Slack：Bot Token 配置，支持频道消息发送
-- Jira/Linear：项目管理和 issue 追踪集成
-- PostgreSQL：直接数据库查询支持
-- Playwright：浏览器自动化和 Web 测试
-- Sequential Thinking：结构化逐步推理，复杂问题分解
-- Software Planning Tool：任务规划与分解，依赖图和执行追踪
+
+* Slack：Bot Token 配置，支持频道消息发送
+
+* Jira/Linear：项目管理和 issue 追踪集成
+
+* PostgreSQL：直接数据库查询支持
+
+* Playwright：浏览器自动化和 Web 测试
+
+* Sequential Thinking：结构化逐步推理，复杂问题分解
+
+* Software Planning Tool：任务规划与分解，依赖图和执行追踪
 
 ### 破坏性变更
 
@@ -75,19 +97,28 @@ v5.0.3 在 v5.0.2 的 Axiom 基础上新增 6 个专家评审 Agent、2 个 Skil
 ### 新增功能
 
 **44 个专业 Agent**（新增 6 个 Axiom 专家 agents）：
-- `axiom-ux-director`：UX/体验专家评审，输出 review_ux.md
-- `axiom-product-director`：产品战略专家评审，输出 review_product.md
-- `axiom-domain-expert`：领域知识专家评审，输出 review_domain.md
-- `axiom-tech-lead`：技术可行性评审，输出 review_tech.md
-- `axiom-critic`：安全/质量/逻辑评审，输出 review_critic.md
-- `axiom-sub-prd-writer`：将 Manifest 任务拆解为可执行 Sub-PRD
+
+* `axiom-ux-director`：UX/体验专家评审，输出 review_ux.md
+
+* `axiom-product-director`：产品战略专家评审，输出 review_product.md
+
+* `axiom-domain-expert`：领域知识专家评审，输出 review_domain.md
+
+* `axiom-tech-lead`：技术可行性评审，输出 review_tech.md
+
+* `axiom-critic`：安全/质量/逻辑评审，输出 review_critic.md
+
+* `axiom-sub-prd-writer`：将 Manifest 任务拆解为可执行 Sub-PRD
 
 **70 个 Skills**（新增 2 个）：
-- `ax-knowledge`：查询 Axiom 知识库
-- `ax-export`：导出 Axiom 工作流产物
+
+* `ax-knowledge`：查询 Axiom 知识库
+
+* `ax-export`：导出 Axiom 工作流产物
 
 **37 个 Hooks**（新增 1 个）：
-- `axiom-guards`：Axiom CI 门禁，确保代码变更通过编译和测试
+
+* `axiom-guards`：Axiom CI 门禁，确保代码变更通过编译和测试
 
 ### 破坏性变更
 
@@ -102,7 +133,9 @@ v5.0.3 在 v5.0.2 的 Axiom 基础上新增 6 个专家评审 Agent、2 个 Skil
 ### 验证
 
 ```bash
+
 # 在 Claude Code 中验证
+
 /ultrapower:omc-help
 /ultrapower:ax-status
 ```
@@ -118,31 +151,48 @@ v5.0.2 将 Axiom 框架深度融合进 ultrapower，将 Agent 数量从 31 扩
 ### 新增功能
 
 **38 个专业 Agent**（新增 8 个 Axiom agents）：
-- `axiom-requirement-analyst`：需求分析三态门（PASS/CLARIFY/REJECT）
-- `axiom-product-designer`：Draft PRD 生成，含 Mermaid 流程图
-- `axiom-review-aggregator`：5 专家并行审查聚合与冲突仲裁
-- `axiom-prd-crafter`：工程级 PRD，含门控验证
-- `axiom-system-architect`：原子任务 DAG 与 Manifest 生成
-- `axiom-evolution-engine`：知识收割、模式检测、工作流优化
-- `axiom-context-manager`：7 操作记忆系统（读/写/状态/检查点）
-- `axiom-worker`：PM→Worker 协议，三态输出（QUESTION/COMPLETE/BLOCKED）
+
+* `axiom-requirement-analyst`：需求分析三态门（PASS/CLARIFY/REJECT）
+
+* `axiom-product-designer`：Draft PRD 生成，含 Mermaid 流程图
+
+* `axiom-review-aggregator`：5 专家并行审查聚合与冲突仲裁
+
+* `axiom-prd-crafter`：工程级 PRD，含门控验证
+
+* `axiom-system-architect`：原子任务 DAG 与 Manifest 生成
+
+* `axiom-evolution-engine`：知识收割、模式检测、工作流优化
+
+* `axiom-context-manager`：7 操作记忆系统（读/写/状态/检查点）
+
+* `axiom-worker`：PM→Worker 协议，三态输出（QUESTION/COMPLETE/BLOCKED）
 
 **67 个 Skills**（新增 12 个 Axiom skills）：
-- `ax-analyze-error`、`ax-context`、`ax-decompose`、`ax-draft`
-- `ax-evolution`、`ax-evolve`、`ax-implement`、`ax-reflect`
-- `ax-review`、`ax-rollback`、`ax-status`、`ax-suspend`
+
+* `ax-analyze-error`、`ax-context`、`ax-decompose`、`ax-draft`
+
+* `ax-evolution`、`ax-evolve`、`ax-implement`、`ax-reflect`
+
+* `ax-review`、`ax-rollback`、`ax-status`、`ax-suspend`
 
 **新增 TypeScript Hooks：**
-- `axiom-boot`：会话启动时自动加载 Axiom 上下文
-- `axiom-guards`：工作流守卫，防止无效状态转换
+
+* `axiom-boot`：会话启动时自动加载 Axiom 上下文
+
+* `axiom-guards`：工作流守卫，防止无效状态转换
 
 **记忆系统（`.omc/axiom/`）：**
-- `memory.json`：持久化知识库
-- `patterns.json`：检测到的工作流模式
-- `evolution-log.json`：演化历史
+
+* `memory.json`：持久化知识库
+
+* `patterns.json`：检测到的工作流模式
+
+* `evolution-log.json`：演化历史
 
 **AI 工具适配器：**
-- `.codex/`、`.gemini/`、`.kiro/`、`.opencode/`、`.cursorrules`、`.github/`
+
+* `.codex/`、`.gemini/`、`.kiro/`、`.opencode/`、`.cursorrules`、`.github/`
 
 ### 破坏性变更
 
@@ -157,7 +207,9 @@ v5.0.2 将 Axiom 框架深度融合进 ultrapower，将 Agent 数量从 31 扩
 ### 验证
 
 ```bash
+
 # 在 Claude Code 中验证
+
 /ultrapower:omc-help
 /ultrapower:ax-status
 ```
@@ -175,31 +227,40 @@ v5.0 集成了 superpowers skill 系统，将 Agent 数量从 28 扩展至 31，
 **Agent 重命名（向后兼容别名保留）：**
 
 | 旧名称 | 新名称 | 别名保留 |
-|--------|--------|----------|
+| -------- | -------- | ---------- |
 | `tdd-guide` | `test-engineer` | 是 |
 | `researcher` | `document-specialist` | 是 |
 
 **模式路由变更：**
 
 | 旧行为 | 新行为 |
-|--------|--------|
+| -------- | -------- |
 | `swarm` 直接执行 | `swarm` 路由到 Team（兼容外观） |
 | `ultrapilot` 直接执行 | `ultrapilot` 路由到 Team（兼容外观） |
 
 ### 新增功能
 
 **31 个专业 Agent**（新增 3 个）：
-- `build-fixer`：构建/工具链/类型错误修复
-- `qa-tester`：交互式 CLI/服务运行时验证
-- `scientist`：数据/统计分析
+
+* `build-fixer`：构建/工具链/类型错误修复
+
+* `qa-tester`：交互式 CLI/服务运行时验证
+
+* `scientist`：数据/统计分析
 
 **55 个 Skills**（新增 21 个），包括 superpowers skill 系统：
-- `brainstorming`、`systematic-debugging`、`test-driven-development`
-- `writing-plans`、`executing-plans`、`dispatching-parallel-agents`
-- `verification-before-completion`、`requesting-code-review`、`receiving-code-review`
-- `finishing-a-development-branch`、`using-git-worktrees`、`using-superpowers`
-- `subagent-driven-development`、`writer-memory`、`writing-skills`
-- `project-session-manager` (psm)：支持 GitHub/GitLab/Bitbucket/Jira/Gitea/Azure DevOps
+
+* `brainstorming`、`systematic-debugging`、`test-driven-development`
+
+* `writing-plans`、`executing-plans`、`dispatching-parallel-agents`
+
+* `verification-before-completion`、`requesting-code-review`、`receiving-code-review`
+
+* `finishing-a-development-branch`、`using-git-worktrees`、`using-superpowers`
+
+* `subagent-driven-development`、`writer-memory`、`writing-skills`
+
+* `project-session-manager` (psm)：支持 GitHub/GitLab/Bitbucket/Jira/Gitea/Azure DevOps
 
 **Team 模式（默认多 Agent 编排器）：**
 
@@ -210,13 +271,20 @@ v5.0 集成了 superpowers skill 系统，将 Agent 数量从 28 扩展至 31，
 ```
 
 **新工具集成：**
-- LSP 工具（12 个）：`lsp_hover`、`lsp_goto_definition`、`lsp_find_references` 等
-- AST 工具：`ast_grep_search`、`ast_grep_replace`
-- Python REPL：`python_repl`
-- 速率限制等待守护进程
-- 自动更新系统
-- 分析/成本追踪系统
-- MCP 后台任务管理（SQLite 持久化）
+
+* LSP 工具（12 个）：`lsp_hover`、`lsp_goto_definition`、`lsp_find_references` 等
+
+* AST 工具：`ast_grep_search`、`ast_grep_replace`
+
+* Python REPL：`python_repl`
+
+* 速率限制等待守护进程
+
+* 自动更新系统
+
+* 分析/成本追踪系统
+
+* MCP 后台任务管理（SQLite 持久化）
 
 ### 迁移步骤
 
@@ -224,15 +292,18 @@ v5.0 集成了 superpowers skill 系统，将 Agent 数量从 28 扩展至 31，
 2. **更新脚本中的 Agent 引用**（可选，推荐）：
    - `tdd-guide` → `test-engineer`
    - `researcher` → `document-specialist`
-3. **重新运行 `/omc-setup`** 以获取新的 CLAUDE.md 配置（包含 31 个 Agent 和 55 个 Skills）
+1. **重新运行 `/omc-setup`** 以获取新的 CLAUDE.md 配置（包含 31 个 Agent 和 55 个 Skills）
 
 ### 验证
 
 ```bash
+
 # 验证安装
+
 npm list -g ultrapower
 
 # 在 Claude Code 中验证
+
 /ultrapower:omc-help
 ```
 
@@ -247,14 +318,20 @@ npm list -g ultrapower
 ### 变更内容
 
 **测试修复：**
-- Delegation-enforcer 测试标记为跳过（实现待定）
-- 修正 agent 归因的分析预期
-- 所有剩余测试现在均可干净通过
+
+* Delegation-enforcer 测试标记为跳过（实现待定）
+
+* 修正 agent 归因的分析预期
+
+* 所有剩余测试现在均可干净通过
 
 **Skill 整合：**
-- 延续 v3.5.3 的清理工作
-- 移除已废弃的 `cancel-*` skill（改用 `/cancel`）
-- 最终 skill 数量：37 个核心 skill
+
+* 延续 v3.5.3 的清理工作
+
+* 移除已废弃的 `cancel-*` skill（改用 `/cancel`）
+
+* 最终 skill 数量：37 个核心 skill
 
 ### 迁移步骤
 
@@ -279,7 +356,7 @@ npm list -g ultrapower
 以下 skill 在 v3.5.3 中已**完全移除**：
 
 | 已移除的 Skill | 替代方案 |
-|---------------|-------------|
+| --------------- | ------------- |
 | `cancel-autopilot` | `/ultrapower:cancel` |
 | `cancel-ralph` | `/ultrapower:cancel` |
 | `cancel-ultrawork` | `/ultrapower:cancel` |
@@ -307,9 +384,12 @@ npm list -g ultrapower
 ### 新功能
 
 **新 skill：`/learn-about-omc`**
-- 分析您的 OMC 使用模式
-- 提供个性化建议
-- 识别未充分利用的功能
+
+* 分析您的 OMC 使用模式
+
+* 提供个性化建议
+
+* 识别未充分利用的功能
 
 **plan skill 现在支持共识模式：**
 ```bash
@@ -325,8 +405,9 @@ npm list -g ultrapower
 
 ### Skill 数量
 
-- v3.5：42 个 skill
-- v3.5.3：37 个 skill（移除 8 个，新增 3 个）
+* v3.5：42 个 skill
+
+* v3.5.3：37 个 skill（移除 8 个，新增 3 个）
 
 ---
 
@@ -344,8 +425,9 @@ npm list -g ultrapower
 
 项目进行了品牌重塑，以更好地反映其用途并提高可发现性。
 
-- **项目/品牌名称**：`ultrapower`（GitHub 仓库、插件名称、命令）
-- **npm 包名称**：`@liangjie559567/ultrapower`
+* **项目/品牌名称**：`ultrapower`（GitHub 仓库、插件名称、命令）
+
+* **npm 包名称**：`@liangjie559567/ultrapower`
 
 #### NPM 安装命令
 
@@ -360,7 +442,9 @@ npm install -g @liangjie559567/ultrapower
 您必须记住并为每种模式显式调用特定命令：
 
 ```bash
+
 # 2.x 工作流：多个命令，需要记忆很多
+
 /ultrapower:ralph "implement user authentication"       # 持久模式
 /ultrapower:ultrawork "refactor the API layer"          # 最大并行度
 /ultrapower:planner "plan the new dashboard"            # 规划访谈
@@ -375,7 +459,9 @@ npm install -g @liangjie559567/ultrapower
 自然地工作。Claude 检测意图并自动激活行为：
 
 ```bash
+
 # 3.0 工作流：自然交流或使用可选关键词
+
 "don't stop until user auth is done"                # Auto-activates ralph-loop
 "fast: refactor the entire API layer"               # Auto-activates ultrawork
 "plan: design the new dashboard"                    # Auto-activates planning
@@ -389,7 +475,7 @@ npm install -g @liangjie559567/ultrapower
 所有 agent 名称已从希腊神话引用更新为直观的描述性名称：
 
 | 旧名称（希腊语） | 新名称（直观） |
-|------------------|----------------------|
+| ------------------ | ---------------------- |
 | prometheus | planner |
 | momus | critic |
 | oracle | architect |
@@ -409,27 +495,35 @@ npm install -g @liangjie559567/ultrapower
 目录结构已重命名以与新包名保持一致：
 
 #### 本地项目目录
-- **旧**：`.sisyphus/`
-- **新**：`.omc/`
+
+* **旧**：`.sisyphus/`
+
+* **新**：`.omc/`
 
 #### 全局目录
-- **旧**：`~/.sisyphus/`
-- **新**：`~/.omc/`
+
+* **旧**：`~/.sisyphus/`
+
+* **新**：`~/.omc/`
 
 #### Skills 目录
-- **旧**：`~/.claude/skills/sisyphus-learned/`
-- **新**：`~/.claude/skills/omc-learned/`
+
+* **旧**：`~/.claude/skills/sisyphus-learned/`
+
+* **新**：`~/.claude/skills/omc-learned/`
 
 #### 配置文件
-- **旧**：`~/.claude/sisyphus/mnemosyne.json`
-- **新**：`~/.claude/omc/learner.json`
+
+* **旧**：`~/.claude/sisyphus/mnemosyne.json`
+
+* **新**：`~/.claude/omc/learner.json`
 
 ### 环境变量
 
 所有环境变量已从 `SISYPHUS_*` 重命名为 `OMC_*`：
 
 | 旧 | 新 |
-|-----|-----|
+| ----- | ----- |
 | SISYPHUS_USE_NODE_HOOKS | OMC_USE_NODE_HOOKS |
 | SISYPHUS_USE_BASH_HOOKS | OMC_USE_BASH_HOOKS |
 | SISYPHUS_PARALLEL_EXECUTION | OMC_PARALLEL_EXECUTION |
@@ -445,7 +539,7 @@ npm install -g @liangjie559567/ultrapower
 所有 2.x 命令继续有效。以下是变更内容：
 
 | 2.x 命令 | 3.0 等效方式 | 是否有效？ |
-|-------------|----------------|--------|
+| ------------- | ---------------- | -------- |
 | `/ultrapower:ralph "task"` | 说 "don't stop until done" 或使用 `ralph` 关键词 | ✅ 是（两种方式均可） |
 | `/ultrapower:ultrawork "task"` | 说 "fast" 或 "parallel" 或使用 `ulw` 关键词 | ✅ 是（两种方式均可） |
 | `/ultrapower:ultrawork-ralph` | 说 "ralph ulw:" 前缀 | ✅ 是（关键词组合） |
@@ -467,7 +561,7 @@ npm install -g @liangjie559567/ultrapower
 在消息中任意位置包含这些关键词可显式激活行为。当您需要显式控制时使用关键词（可选）：
 
 | 关键词 | 效果 | 示例 |
-|---------|--------|---------|
+| --------- | -------- | --------- |
 | `ralph` | 持久模式 - 完成前不会停止 | "ralph: refactor the auth system" |
 | `ralplan` | 带共识的迭代规划 | "ralplan: add OAuth support" |
 | `ulw` / `ultrawork` | 最大并行执行 | "ulw: fix all type errors" |
@@ -490,12 +584,18 @@ Persistence (won't stop) + Ultrawork (maximum parallelism) built-in
 ### 自然取消
 
 说以下任意一句即可停止：
-- "stop"
-- "cancel"
-- "abort"
-- "nevermind"
-- "enough"
-- "halt"
+
+* "stop"
+
+* "cancel"
+
+* "abort"
+
+* "nevermind"
+
+* "enough"
+
+* "halt"
 
 Claude 会智能判断要停止的内容：
 
@@ -521,8 +621,10 @@ npm uninstall -g @liangjie559567/ultrapower
 #### 2. 通过插件系统安装（必须）
 
 ```bash
+
 # In Claude Code:
-/plugin marketplace add https://github.com/liangjie559567/ultrapower
+
+/plugin marketplace add <https://github.com/liangjie559567/ultrapower>
 /plugin install omc@ultrapower
 ```
 
@@ -533,20 +635,26 @@ npm uninstall -g @liangjie559567/ultrapower
 如果您有使用旧目录结构的现有项目：
 
 ```bash
+
 # In each project directory
+
 mv .sisyphus .omc
 ```
 
 #### 4. 重命名全局目录
 
 ```bash
+
 # Global configuration directory
+
 mv ~/.sisyphus ~/.omc
 
 # Skills directory
+
 mv ~/.claude/skills/sisyphus-learned ~/.claude/skills/omc-learned
 
 # Config directory
+
 mv ~/.claude/sisyphus ~/.claude/omc
 ```
 
@@ -555,30 +663,44 @@ mv ~/.claude/sisyphus ~/.claude/omc
 更新您的 shell 配置文件（`.bashrc`、`.zshrc` 等）：
 
 ```bash
+
 # Replace all SISYPHUS_* variables with OMC_*
+
 # Example:
+
 # OLD: export SISYPHUS_ROUTING_ENABLED=true
+
 # NEW: export OMC_ROUTING_ENABLED=true
+
 ```
 
 #### 6. 更新脚本和配置
 
 搜索并更新所有引用：
-- 包名：`oh-my-claude-sisyphus` → `@liangjie559567/ultrapower`
-- Agent 名称：使用上方的映射表
-- 命令：使用新的 slash 命令
-- 目录路径：将 `.sisyphus` 更新为 `.omc`
+
+* 包名：`oh-my-claude-sisyphus` → `@liangjie559567/ultrapower`
+
+* Agent 名称：使用上方的映射表
+
+* 命令：使用新的 slash 命令
+
+* 目录路径：将 `.sisyphus` 更新为 `.omc`
 
 #### 7. 运行一次性设置
 
 在 Claude Code 中，只需说 "setup omc"、"omc setup" 或任何自然语言等效表达。
 
 这将：
-- 下载最新的 CLAUDE.md
-- 配置 32 个 agent
-- 启用自动行为检测
-- 激活续行强制
-- 设置 skill 组合
+
+* 下载最新的 CLAUDE.md
+
+* 配置 32 个 agent
+
+* 启用自动行为检测
+
+* 激活续行强制
+
+* 设置 skill 组合
 
 ### 验证
 
@@ -589,13 +711,13 @@ mv ~/.claude/sisyphus ~/.claude/omc
    npm list -g @liangjie559567/ultrapower
    ```
 
-2. **验证目录存在**：
+1. **验证目录存在**：
    ```bash
    ls -la .omc/  # In project directory
    ls -la ~/.omc/  # Global directory
    ```
 
-3. **测试简单命令**：
+1. **测试简单命令**：
    在 Claude Code 中运行 `/ultrapower:omc-help`，确保插件已正确加载。
 
 ### 3.0 新功能
@@ -632,7 +754,9 @@ Your request              Claude's action
 从问题解决中提取可复用的洞察：
 
 ```bash
+
 # After solving a tricky bug:
+
 "Extract this as a skill"
     ↓
 Claude learns the pattern and stores it
@@ -641,8 +765,10 @@ Next time keywords match → Solution auto-injects
 ```
 
 存储位置：
-- **项目级**：`.omc/skills/`（版本控制）
-- **用户级**：`~/.claude/skills/omc-learned/`（可移植）
+
+* **项目级**：`.omc/skills/`（版本控制）
+
+* **用户级**：`~/.claude/skills/omc-learned/`（可移植）
 
 #### 4. HUD 状态栏（实时编排）
 
@@ -721,27 +847,34 @@ Version 3.1 是一个小版本，在保持与 v3.0 完全向后兼容的同时
 **位置：** `.omc/notepads/{plan-name}/`
 
 | 文件 | 用途 |
-|------|---------|
+| ------ | --------- |
 | `learnings.md` | 技术发现和模式 |
 | `decisions.md` | 架构和设计决策 |
 | `issues.md` | 已知问题和解决方案 |
 | `problems.md` | 阻塞项和挑战 |
 
 **API：**
-- `initPlanNotepad()` - 为计划初始化 notepad
-- `addLearning()` - 记录技术发现
-- `addDecision()` - 记录架构选择
-- `addIssue()` - 记录已知问题
-- `addProblem()` - 记录阻塞项
-- `getWisdomSummary()` - 获取所有知识摘要
-- `readPlanWisdom()` - 读取完整知识以获取上下文
+
+* `initPlanNotepad()` - 为计划初始化 notepad
+
+* `addLearning()` - 记录技术发现
+
+* `addDecision()` - 记录架构选择
+
+* `addIssue()` - 记录已知问题
+
+* `addProblem()` - 记录阻塞项
+
+* `getWisdomSummary()` - 获取所有知识摘要
+
+* `readPlanWisdom()` - 读取完整知识以获取上下文
 
 #### 2. Delegation Categories
 
 语义任务分类，自动映射到模型层级、温度和思考预算。
 
 | Category | Tier | Temperature | Thinking | 适用场景 |
-|----------|------|-------------|----------|---------|
+| ---------- | ------ | ------------- | ---------- | --------- |
 | `visual-engineering` | HIGH | 0.7 | high | UI/UX、前端、设计系统 |
 | `ultrabrain` | HIGH | 0.3 | max | 复杂推理、架构、深度调试 |
 | `artistry` | MEDIUM | 0.9 | medium | 创意方案、头脑风暴 |
@@ -755,9 +888,12 @@ Version 3.1 是一个小版本，在保持与 v3.0 完全向后兼容的同时
 通过 `lsp_diagnostics_directory` 工具进行项目级类型检查。
 
 **策略：**
-- `auto`（默认）- 自动选择最佳策略，存在 tsconfig.json 时优先使用 tsc
-- `tsc` - 快速，使用 TypeScript 编译器
-- `lsp` - 回退方案，通过 Language Server 逐文件检查
+
+* `auto`（默认）- 自动选择最佳策略，存在 tsconfig.json 时优先使用 tsc
+
+* `tsc` - 快速，使用 TypeScript 编译器
+
+* `lsp` - 回退方案，通过 Language Server 逐文件检查
 
 **用途：** 在提交前或重构后检查整个项目的错误。
 
@@ -778,10 +914,14 @@ npm update -g @liangjie559567/ultrapower
 ### 新增可用工具
 
 升级后，agent 自动获得以下访问权限：
-- Notepad wisdom API（执行期间读写知识）
-- Delegation categories（自动分类）
-- Directory diagnostics（项目级类型检查）
-- Session resume（恢复后台 agent 状态）
+
+* Notepad wisdom API（执行期间读写知识）
+
+* Delegation categories（自动分类）
+
+* Directory diagnostics（项目级类型检查）
+
+* Session resume（恢复后台 agent 状态）
 
 ---
 
@@ -802,10 +942,14 @@ Version 3.4.0 在保持与 v3.3.x 完全向后兼容的同时，引入了强大
 ```
 
 **主要特性：**
-- 自动将任务分解为可并行的子任务
-- 文件所有权协调以防止冲突
-- 带智能协调的并行执行
-- 状态文件：`.omc/state/ultrapilot-state.json`、`.omc/state/ultrapilot-ownership.json`
+
+* 自动将任务分解为可并行的子任务
+
+* 文件所有权协调以防止冲突
+
+* 带智能协调的并行执行
+
+* 状态文件：`.omc/state/ultrapilot-state.json`、`.omc/state/ultrapilot-ownership.json`
 
 **最适合：** 多组件系统、全栈应用、大型重构
 
@@ -818,10 +962,14 @@ N 个协调 agent，具有原子任务认领：
 ```
 
 **主要特性：**
-- 带原子认领的共享任务池（防止重复工作）
-- 每个任务 5 分钟超时并自动释放
-- 可扩展至 2 到 10 个 worker
-- 所有任务完成后干净退出
+
+* 带原子认领的共享任务池（防止重复工作）
+
+* 每个任务 5 分钟超时并自动释放
+
+* 可扩展至 2 到 10 个 worker
+
+* 所有任务完成后干净退出
 
 #### 3. Pipeline: Sequential Agent Chaining
 
@@ -832,12 +980,18 @@ N 个协调 agent，具有原子任务认领：
 ```
 
 **内置预设：**
-- `review` - explore → architect → critic → executor
-- `implement` - planner → executor → test-engineer
-- `debug` - explore → architect → build-fixer
-- `research` - parallel(document-specialist, explore) → architect → writer
-- `refactor` - explore → architect-medium → executor-high → qa-tester
-- `security` - explore → security-reviewer → executor → security-reviewer-low
+
+* `review` - explore → architect → critic → executor
+
+* `implement` - planner → executor → test-engineer
+
+* `debug` - explore → architect → build-fixer
+
+* `research` - parallel(document-specialist, explore) → architect → writer
+
+* `refactor` - explore → architect-medium → executor-high → qa-tester
+
+* `security` - explore → security-reviewer → executor → security-reviewer-low
 
 #### 4. 统一取消命令
 
@@ -845,17 +999,23 @@ N 个协调 agent，具有原子任务认领：
 
 ```bash
 /ultrapower:cancel
+
 # Or just say: "stop", "cancel", "abort"
+
 ```
 
 **自动检测并取消：** autopilot、ultrapilot、ralph、ultrawork、ultraqa、swarm、pipeline
 
 **废弃通知：**
 单独的取消命令已废弃但仍可使用：
-- `/ultrapower:cancel-ralph`（已废弃）
-- `/ultrapower:cancel-ultraqa`（已废弃）
-- `/ultrapower:cancel-ultrawork`（已废弃）
-- `/ultrapower:cancel-autopilot`（已废弃）
+
+* `/ultrapower:cancel-ralph`（已废弃）
+
+* `/ultrapower:cancel-ultraqa`（已废弃）
+
+* `/ultrapower:cancel-ultrawork`（已废弃）
+
+* `/ultrapower:cancel-autopilot`（已废弃）
 
 请改用 `/ultrapower:cancel`。
 
@@ -876,8 +1036,10 @@ Task(subagent_type="ultrapower:explore-high",
 状态文件现在使用标准化路径：
 
 **标准路径：**
-- 本地：`.omc/state/{name}.json`
-- 全局：`~/.omc/state/{name}.json`
+
+* 本地：`.omc/state/{name}.json`
+
+* 全局：`~/.omc/state/{name}.json`
 
 旧版位置在读取时自动迁移。
 
@@ -887,7 +1049,7 @@ Task(subagent_type="ultrapower:explore-high",
 
 **冲突解决优先级：**
 | 优先级 | 条件 | 结果 |
-|----------|-----------|--------|
+| ---------- | ----------- | -------- |
 | 1（最高） | 单个显式关键词 | 该模式获胜 |
 | 2 | 仅通用 "fast"/"parallel" | 从配置读取（`defaultExecutionMode`） |
 | 3（最低） | 无配置文件 | 默认为 `ultrawork` |
@@ -928,18 +1090,23 @@ npm update -g @liangjie559567/ultrapower
 ### 新增可用工具
 
 升级后，您自动获得以下访问权限：
-- Ultrapilot（并行 autopilot）
-- Swarm 协调
-- Pipeline 工作流
-- 统一取消命令
-- Explore-high agent
+
+* Ultrapilot（并行 autopilot）
+
+* Swarm 协调
+
+* Pipeline 工作流
+
+* 统一取消命令
+
+* Explore-high agent
 
 ### v3.4.0 最佳实践
 
 #### 各模式使用场景
 
 | 场景 | 推荐模式 | 原因 |
-|----------|------------------|-----|
+| ---------- | ------------------ | ----- |
 | 多组件系统 | `ultrapilot` | 并行 worker 处理独立组件 |
 | 大量小修复 | `swarm` | 原子任务认领防止重复工作 |
 | 顺序依赖 | `pipeline` | 数据在各阶段间传递 |
@@ -970,17 +1137,17 @@ npm update -g @liangjie559567/ultrapower
    npm list -g @liangjie559567/ultrapower
    ```
 
-2. **测试 ultrapilot**：
+1. **测试 ultrapilot**：
    ```bash
    /ultrapower:ultrapilot "create a simple React component"
    ```
 
-3. **测试统一取消**：
+1. **测试统一取消**：
    ```bash
    /ultrapower:cancel
    ```
 
-4. **检查状态目录**：
+1. **检查状态目录**：
    ```bash
    ls -la .omc/state/  # Should see ultrapilot-state.json after running ultrapilot
    ```
@@ -1015,8 +1182,9 @@ Task(subagent_type="ultrapower:architect", model="opus", ...)
 
 ### 保持更新
 
-- 查看 [CHANGELOG.md](../CHANGELOG.md) 了解详细发布说明
-- 参与 [GitHub Issues](https://github.com/liangjie559567/ultrapower/issues) 讨论
+* 查看 [CHANGELOG.md](../CHANGELOG.md) 了解详细发布说明
+
+* 参与 [GitHub Issues](https://github.com/liangjie559567/ultrapower/issues) 讨论
 
 ---
 
@@ -1138,11 +1306,15 @@ A：关键词是显式快捷方式。自然语言触发自动检测。两者均
 
 ## 需要帮助？
 
-- **诊断问题**：运行 `/ultrapower:omc-doctor`
-- **查看所有命令**：运行 `/ultrapower:omc-help`
-- **查看实时状态**：运行 `/ultrapower:hud setup`
-- **查看详细变更日志**：参见 [CHANGELOG.md](../CHANGELOG.md)
-- **报告 bug**：[GitHub Issues](https://github.com/liangjie559567/ultrapower/issues)
+* **诊断问题**：运行 `/ultrapower:omc-doctor`
+
+* **查看所有命令**：运行 `/ultrapower:omc-help`
+
+* **查看实时状态**：运行 `/ultrapower:hud setup`
+
+* **查看详细变更日志**：参见 [CHANGELOG.md](../CHANGELOG.md)
+
+* **报告 bug**：[GitHub Issues](https://github.com/liangjie559567/ultrapower/issues)
 
 ---