@liangjie559567/ultrapower 5.6.6 → 5.6.8

package/docs/USER_GUIDE.md

@@ -25,15 +25,22 @@
 ultrapower 是 Claude Code 的多 agent 编排层，提供 50 个专业 agents、70 个 skills、35 个 hooks 和 35 个自定义工具。
 
 **主要特性**:
-- 多 agent 协作编排
-- 自动化工作流
-- 自我进化系统（Axiom）
-- MCP 集成
+
+* 多 agent 协作编排
+
+* 自动化工作流
+
+* 自我进化系统（Axiom）
+
+* MCP 集成
 
 **适用人群**:
-- Claude Code 用户
-- AI 辅助开发工具用户
-- 企业开发团队
+
+* Claude Code 用户
+
+* AI 辅助开发工具用户
+
+* 企业开发团队
 
 ---
 
@@ -42,10 +49,14 @@ ultrapower 是 Claude Code 的多 agent 编排层，提供 50 个专业 agents
 > 详细安装步骤请参考 [README.md](../README.md#快速开始)
 
 **本章节内容**:
-- 前置条件检查
-- 两种安装方式
-- 验证安装
-- 常见安装问题
+
+* 前置条件检查
+
+* 两种安装方式
+
+* 验证安装
+
+* 常见安装问题
 
 *（待补充）*
 
@@ -56,9 +67,12 @@ ultrapower 是 Claude Code 的多 agent 编排层，提供 50 个专业 agents
 理解 ultrapower 的核心概念：Agent、Skill、Hook、Tool。
 
 **本章节内容**:
-- Agent vs Skill vs Hook vs Tool
-- 执行模式（autopilot/ralph/ultrawork/team）
-- 决策树：何时用哪个？
+
+* Agent vs Skill vs Hook vs Tool
+
+* 执行模式（autopilot/ralph/ultrawork/team）
+
+* 决策树：何时用哪个？
 
 *（待补充）*
 
@@ -72,10 +86,13 @@ ultrapower 是 Claude Code 的多 agent 编排层，提供 50 个专业 agents
 
 在开始前，请确认：
 
-- ✅ Node.js >= 18（运行 `node --version` 检查）
-- ✅ Claude Code >= v1.0.0（运行 `claude --version` 检查）
-- ✅ Git 已安装（用于插件安装）
-- ✅ 有稳定的网络连接
+* ✅ Node.js >= 18（运行 `node --version` 检查）
+
+* ✅ Claude Code >= v1.0.0（运行 `claude --version` 检查）
+
+* ✅ Git 已安装（用于插件安装）
+
+* ✅ 有稳定的网络连接
 
 **检查命令**:
 ```bash
@@ -90,15 +107,15 @@ git --version  # 应显示 git version 2.x.x
 
 1. **添加 marketplace**:
    ```
-   /plugin marketplace add https://github.com/liangjie559567/ultrapower
+   /plugin marketplace add <https://github.com/liangjie559567/ultrapower>
    ```
 
-2. **安装插件**:
+1. **安装插件**:
    ```
    /plugin install omc@ultrapower
    ```
 
-3. **运行安装向导**:
+1. **运行安装向导**:
    ```
    /ultrapower:omc-setup
    ```
@@ -125,10 +142,14 @@ autopilot "创建一个 hello world 函数"
 ```
 
 **预期输出**:
-- ultrapower 会自动分析需求
-- 调用 executor agent 生成代码
-- 运行测试验证
-- 返回完整实现
+
+* ultrapower 会自动分析需求
+
+* 调用 executor agent 生成代码
+
+* 运行测试验证
+
+* 返回完整实现
 
 **示例代码**（自动生成）:
 ```typescript
@@ -138,9 +159,12 @@ export function helloWorld(): string {
 ```
 
 **下一步尝试**:
-- `ralph "添加单元测试"` - 持续执行直到测试通过
-- `team "重构这个函数"` - 使用多 agent 协作
-- `/ultrapower:analyze` - 分析代码质量
+
+* `ralph "添加单元测试"` - 持续执行直到测试通过
+
+* `team "重构这个函数"` - 使用多 agent 协作
+
+* `/ultrapower:analyze` - 分析代码质量
 
 ### 4.4 常见安装问题
 
@@ -150,10 +174,13 @@ export function helloWorld(): string {
 
 **解决**:
 ```bash
+
 # 检查 Claude Code 是否安装
+
 which claude
 
 # 如果未找到，重新安装 Claude Code
+
 ```
 
 #### 问题 2: "marketplace not found"
@@ -162,10 +189,13 @@ which claude
 
 **解决**:
 ```
+
 # 确认 URL 正确
-/plugin marketplace add https://github.com/liangjie559567/ultrapower
+
+/plugin marketplace add <https://github.com/liangjie559567/ultrapower>
 
 # 检查网络连接
+
 ping github.com
 ```
 
@@ -175,10 +205,13 @@ ping github.com
 
 **解决**:
 ```bash
+
 # 检查 Node.js 版本
+
 node --version  # 应 >= 18
 
 # 清除缓存重试
+
 rm -rf ~/.claude/plugins/cache/omc
 /plugin install omc@ultrapower --force
 ```
@@ -196,7 +229,7 @@ rm -rf ~/.claude/plugins/cache/omc
 ultrapower 提供 4 种主要执行模式：
 
 | 模式 | 触发词 | 特点 | 适用场景 |
-|------|--------|------|---------|
+| ------ | -------- | ------ | --------- |
 | **Team** | "team", "coordinated team" | 多 agent 协作，分阶段流水线 | 复杂功能开发、多文件重构 |
 | **Autopilot** | "autopilot", "build me" | 全自主执行，从想法到代码 | 快速原型、单一功能实现 |
 | **Ralph** | "ralph", "don't stop" | 持续执行直到验证通过 | 需要多次迭代的任务 |
@@ -229,9 +262,12 @@ team-plan → team-prd → team-exec → team-verify → team-fix (循环)
 **负责 agents**: `explore` (haiku) + `planner` (opus)
 
 **任务**:
-- 代码库探索，识别相关文件
-- 任务分解，生成执行计划
-- 依赖分析，确定执行顺序
+
+* 代码库探索，识别相关文件
+
+* 任务分解，生成执行计划
+
+* 依赖分析，确定执行顺序
 
 **示例**:
 ```
@@ -245,9 +281,12 @@ team "重构用户认证模块"
 **负责 agents**: `analyst` (opus)
 
 **任务**:
-- 澄清需求，确认验收标准
-- 识别边界情况
-- 生成 PRD 文档
+
+* 澄清需求，确认验收标准
+
+* 识别边界情况
+
+* 生成 PRD 文档
 
 **输出**: 验收标准 + 范围定义
 
@@ -256,11 +295,16 @@ team "重构用户认证模块"
 **负责 agents**: `executor` (sonnet) + 任务适配专家
 
 **任务适配路由**:
-- UI/组件 → `designer`
-- 构建错误 → `build-fixer`
-- 文档 → `writer`
-- 测试 → `test-engineer`
-- 复杂任务 → `deep-executor`
+
+* UI/组件 → `designer`
+
+* 构建错误 → `build-fixer`
+
+* 文档 → `writer`
+
+* 测试 → `test-engineer`
+
+* 复杂任务 → `deep-executor`
 
 **示例**:
 ```typescript
@@ -277,11 +321,16 @@ export class AuthService {
 **负责 agents**: `verifier` (sonnet) + 专项审查
 
 **验证项**:
-- [ ] 功能完整性（所有任务完成）
-- [ ] 测试通过（单元测试 + 集成测试）
-- [ ] 代码质量（`quality-reviewer`）
-- [ ] 安全性（`security-reviewer`，按需）
-- [ ] 性能（`performance-reviewer`，按需）
+
+* [ ] 功能完整性（所有任务完成）
+
+* [ ] 测试通过（单元测试 + 集成测试）
+
+* [ ] 代码质量（`quality-reviewer`）
+
+* [ ] 安全性（`security-reviewer`，按需）
+
+* [ ] 性能（`performance-reviewer`，按需）
 
 **输出**: 验证报告 + 缺陷清单
 
@@ -290,9 +339,12 @@ export class AuthService {
 **负责 agents**: 根据缺陷类型路由
 
 **修复路由**:
-- 构建错误 → `build-fixer`
-- 逻辑错误 → `executor`
-- 性能问题 → `debugger`
+
+* 构建错误 → `build-fixer`
+
+* 逻辑错误 → `executor`
+
+* 性能问题 → `debugger`
 
 **循环控制**: 最多 3 次修复尝试，超出则转为 `failed` 状态
 
@@ -348,9 +400,12 @@ ultrawork "并行重构 3 个模块"
 ```
 
 **流程**:
-- 识别独立任务
-- 并行启动多个 agents
-- 等待所有任务完成
+
+* 识别独立任务
+
+* 并行启动多个 agents
+
+* 等待所有任务完成
 
 **适用**: 独立任务并行执行
 
@@ -361,12 +416,18 @@ ultrawork "并行重构 3 个模块"
 Hooks 提供事件驱动的自动化。
 
 **Hook 类型**（15 种）:
-- `PreToolUse` - 工具调用前
-- `PostToolUse` - 工具调用后
-- `SessionStart` - 会话开始
-- `SessionEnd` - 会话结束
-- `PermissionRequest` - 权限请求
-- 等等...
+
+* `PreToolUse` - 工具调用前
+
+* `PostToolUse` - 工具调用后
+
+* `SessionStart` - 会话开始
+
+* `SessionEnd` - 会话结束
+
+* `PermissionRequest` - 权限请求
+
+* 等等...
 
 **配置示例**:
 ```json
@@ -380,9 +441,12 @@ Hooks 提供事件驱动的自动化。
 ```
 
 **常见用例**:
-- 代码保存时自动格式化
-- 提交前运行测试
-- 会话开始时加载项目上下文
+
+* 代码保存时自动格式化
+
+* 提交前运行测试
+
+* 会话开始时加载项目上下文
 
 ---
 
@@ -391,8 +455,10 @@ Hooks 提供事件驱动的自动化。
 MCP（Model Context Protocol）提供外部工具集成。
 
 **可用提供商**:
-- **Codex** (OpenAI gpt-5.3-codex) - 代码分析、规划验证
-- **Gemini** (Google gemini-3-pro-preview) - 大上下文任务（1M token）
+
+* **Codex** (OpenAI gpt-5.3-codex) - 代码分析、规划验证
+
+* **Gemini** (Google gemini-3-pro-preview) - 大上下文任务（1M token）
 
 **使用示例**:
 ```
@@ -417,10 +483,14 @@ ask codex "审查这个架构设计"
 Axiom 提供自我学习和工作流优化能力。
 
 **核心功能**:
-- **知识收割**: 从任务执行中提取经验
-- **模式检测**: 识别重复模式并优化
-- **工作流优化**: 自动改进执行策略
-- **跨会话记忆**: 持久化项目知识
+
+* **知识收割**: 从任务执行中提取经验
+
+* **模式检测**: 识别重复模式并优化
+
+* **工作流优化**: 自动改进执行策略
+
+* **跨会话记忆**: 持久化项目知识
 
 **Axiom 工作流**:
 ```
@@ -447,6 +517,7 @@ ultrapower 提供 50 个专业 agents，按通道分类。
 #### 6.1.1 Build/Analysis Lane（构建/分析通道）
 
 ##### explore (haiku)
+
 代码库发现、符号/文件映射
 
 **使用示例**:
@@ -457,6 +528,7 @@ Task(subagent_type="ultrapower:explore", prompt="找到所有认证相关的文
 **适用场景**: 不熟悉的代码库、快速定位文件
 
 ##### analyst (opus)
+
 需求澄清、验收标准、隐性约束识别
 
 **使用示例**:
@@ -467,6 +539,7 @@ Task(subagent_type="ultrapower:analyst", prompt="分析用户登录需求")
 **适用场景**: 需求模糊、需要明确验收标准
 
 ##### planner (opus)
+
 任务排序、执行计划、风险标记
 
 **使用示例**:
@@ -477,6 +550,7 @@ Task(subagent_type="ultrapower:planner", prompt="规划重构认证模块")
 **适用场景**: 复杂任务分解、多步骤规划
 
 ##### architect (opus)
+
 系统设计、边界定义、接口设计、长期权衡
 
 **使用示例**:
@@ -487,6 +561,7 @@ Task(subagent_type="ultrapower:architect", prompt="设计微服务架构")
 **适用场景**: 架构决策、系统设计
 
 ##### debugger (sonnet)
+
 根因分析、回归隔离、故障诊断
 
 **使用示例**:
@@ -497,6 +572,7 @@ Task(subagent_type="ultrapower:debugger", prompt="分析登录失败原因")
 **适用场景**: Bug 调查、性能问题排查
 
 ##### executor (sonnet)
+
 代码实现、重构、功能开发
 
 **使用示例**:
@@ -507,6 +583,7 @@ Task(subagent_type="ultrapower:executor", prompt="实现用户登录功能")
 **适用场景**: 标准代码实现、多文件修改
 
 ##### deep-executor (opus)
+
 复杂自主目标导向任务
 
 **使用示例**:
@@ -517,6 +594,7 @@ Task(subagent_type="ultrapower:deep-executor", prompt="重构整个认证系统"
 **适用场景**: 复杂重构、跨模块变更
 
 ##### verifier (sonnet)
+
 完成证据收集、声明验证、测试充分性检查
 
 **使用示例**:
@@ -529,6 +607,7 @@ Task(subagent_type="ultrapower:verifier", prompt="验证登录功能完整性")
 #### 6.1.2 Review Lane（审查通道）
 
 ##### style-reviewer (haiku)
+
 格式、命名、惯用法、lint 规范检查
 
 **使用示例**:
@@ -539,6 +618,7 @@ Task(subagent_type="ultrapower:style-reviewer", prompt="审查代码风格")
 **适用场景**: 代码规范检查、格式化验证
 
 ##### quality-reviewer (sonnet)
+
 逻辑缺陷、可维护性、反模式识别
 
 **使用示例**:
@@ -549,6 +629,7 @@ Task(subagent_type="ultrapower:quality-reviewer", prompt="审查代码质量")
 **适用场景**: 代码质量评估、重构建议
 
 ##### api-reviewer (sonnet)
+
 API 契约、版本控制、向后兼容性
 
 **使用示例**:
@@ -559,6 +640,7 @@ Task(subagent_type="ultrapower:api-reviewer", prompt="审查 API 设计")
 **适用场景**: API 设计审查、接口变更评估
 
 ##### security-reviewer (sonnet)
+
 漏洞、信任边界、认证/授权检查
 
 **使用示例**:
@@ -569,6 +651,7 @@ Task(subagent_type="ultrapower:security-reviewer", prompt="安全审查")
 **适用场景**: 安全漏洞扫描、权限检查
 
 ##### performance-reviewer (sonnet)
+
 热点、复杂度、内存/延迟优化
 
 **使用示例**:
@@ -579,6 +662,7 @@ Task(subagent_type="ultrapower:performance-reviewer", prompt="性能审查")
 **适用场景**: 性能瓶颈识别、优化建议
 
 ##### code-reviewer (opus)
+
 跨关注点的综合审查
 
 **使用示例**:
@@ -591,6 +675,7 @@ Task(subagent_type="ultrapower:code-reviewer", prompt="全面代码审查")
 #### 6.1.3 Domain Specialists（领域专家）
 
 ##### dependency-expert (sonnet)
+
 外部 SDK/API/包评估
 
 **使用示例**:
@@ -601,6 +686,7 @@ Task(subagent_type="ultrapower:dependency-expert", prompt="评估 React Query
 **适用场景**: 第三方库选型、API 集成
 
 ##### test-engineer (sonnet)
+
 测试策略、覆盖率、不稳定测试加固
 
 **使用示例**:
@@ -611,6 +697,7 @@ Task(subagent_type="ultrapower:test-engineer", prompt="设计测试策略")
 **适用场景**: 测试设计、TDD 实践
 
 ##### quality-strategist (sonnet)
+
 质量策略、发布就绪性、风险评估
 
 **使用示例**:
@@ -621,6 +708,7 @@ Task(subagent_type="ultrapower:quality-strategist", prompt="评估发布风险")
 **适用场景**: 发布决策、质量门禁
 
 ##### build-fixer (sonnet)
+
 构建/工具链/类型失败修复
 
 **使用示例**:
@@ -631,6 +719,7 @@ Task(subagent_type="ultrapower:build-fixer", prompt="修复 TypeScript 错误")
 **适用场景**: 构建失败、类型错误
 
 ##### designer (sonnet)
+
 UX/UI 架构、交互设计
 
 **使用示例**:
@@ -641,6 +730,7 @@ Task(subagent_type="ultrapower:designer", prompt="设计登录界面")
 **适用场景**: UI 设计、用户体验优化
 
 ##### writer (haiku)
+
 文档、迁移说明、用户指南
 
 **使用示例**:
@@ -651,6 +741,7 @@ Task(subagent_type="ultrapower:writer", prompt="编写 API 文档")
 **适用场景**: 文档编写、README 更新
 
 ##### qa-tester (sonnet)
+
 交互式 CLI/服务运行时验证
 
 **使用示例**:
@@ -661,6 +752,7 @@ Task(subagent_type="ultrapower:qa-tester", prompt="测试 CLI 命令")
 **适用场景**: 手动测试、集成测试
 
 ##### scientist (sonnet)
+
 数据/统计分析
 
 **使用示例**:
@@ -671,6 +763,7 @@ Task(subagent_type="ultrapower:scientist", prompt="分析用户行为数据")
 **适用场景**: 数据分析、实验评估
 
 ##### document-specialist (sonnet)
+
 外部文档和参考查找
 
 **使用示例**:
@@ -681,6 +774,7 @@ Task(subagent_type="ultrapower:document-specialist", prompt="查找 React 最佳
 **适用场景**: 技术调研、文档搜索
 
 ##### git-master (sonnet)
+
 提交策略、历史整洁
 
 **使用示例**:
@@ -691,6 +785,7 @@ Task(subagent_type="ultrapower:git-master", prompt="整理提交历史")
 **适用场景**: Git 操作、提交优化
 
 ##### database-expert (sonnet)
+
 数据库设计、查询优化和迁移
 
 **使用示例**:
@@ -701,6 +796,7 @@ Task(subagent_type="ultrapower:database-expert", prompt="优化 SQL 查询")
 **适用场景**: 数据库设计、性能优化
 
 ##### devops-engineer (sonnet)
+
 CI/CD、容器化、基础设施即代码
 
 **使用示例**:
@@ -711,6 +807,7 @@ Task(subagent_type="ultrapower:devops-engineer", prompt="配置 GitHub Actions")
 **适用场景**: CI/CD 配置、部署自动化
 
 ##### i18n-specialist (sonnet)
+
 国际化、本地化和多语言支持
 
 **使用示例**:
@@ -721,6 +818,7 @@ Task(subagent_type="ultrapower:i18n-specialist", prompt="添加多语言支持")
 **适用场景**: 国际化实现、翻译管理
 
 ##### accessibility-auditor (sonnet)
+
 Web 无障碍审查和 WCAG 合规
 
 **使用示例**:
@@ -731,6 +829,7 @@ Task(subagent_type="ultrapower:accessibility-auditor", prompt="审查无障碍
 **适用场景**: 无障碍审查、WCAG 合规
 
 ##### api-designer (sonnet)
+
 REST/GraphQL API 设计和契约定义
 
 **使用示例**:
@@ -743,6 +842,7 @@ Task(subagent_type="ultrapower:api-designer", prompt="设计 RESTful API")
 #### 6.1.4 Product Lane（产品通道）
 
 ##### product-manager (sonnet)
+
 问题定义、用户画像/JTBD、PRD
 
 **使用示例**:
@@ -753,6 +853,7 @@ Task(subagent_type="ultrapower:product-manager", prompt="编写功能 PRD")
 **适用场景**: 需求定义、产品规划
 
 ##### ux-researcher (sonnet)
+
 启发式审计、可用性、无障碍
 
 **使用示例**:
@@ -763,6 +864,7 @@ Task(subagent_type="ultrapower:ux-researcher", prompt="用户体验审计")
 **适用场景**: UX 评估、可用性测试
 
 ##### information-architect (sonnet)
+
 分类、导航、可发现性
 
 **使用示例**:
@@ -773,6 +875,7 @@ Task(subagent_type="ultrapower:information-architect", prompt="设计信息架
 **适用场景**: 信息架构、导航设计
 
 ##### product-analyst (sonnet)
+
 产品指标、漏斗分析、实验
 
 **使用示例**:
@@ -785,6 +888,7 @@ Task(subagent_type="ultrapower:product-analyst", prompt="分析转化率")
 #### 6.1.5 Coordination（协调）
 
 ##### critic (opus)
+
 计划/设计批判性挑战
 
 **使用示例**:
@@ -795,6 +899,7 @@ Task(subagent_type="ultrapower:critic", prompt="挑战架构设计")
 **适用场景**: 设计评审、风险识别
 
 ##### vision (sonnet)
+
 图片/截图/图表分析
 
 **使用示例**:
@@ -807,6 +912,7 @@ Task(subagent_type="ultrapower:vision", prompt="分析 UI 截图")
 #### 6.1.6 Axiom Lane（Axiom 通道）
 
 ##### ax-drafter (sonnet)
+
 Draft PRD 生成
 
 **使用示例**:
@@ -817,6 +923,7 @@ Draft PRD 生成
 **适用场景**: 快速需求草稿
 
 ##### ax-domain-expert (opus)
+
 领域专家评审
 
 **使用示例**:
@@ -827,6 +934,7 @@ Draft PRD 生成
 **适用场景**: 技术可行性评审
 
 ##### ax-product-expert (opus)
+
 产品专家评审
 
 **使用示例**:
@@ -837,6 +945,7 @@ Draft PRD 生成
 **适用场景**: 产品价值评审
 
 ##### ax-ux-expert (opus)
+
 UX 专家评审
 
 **使用示例**:
@@ -847,6 +956,7 @@ UX 专家评审
 **适用场景**: 用户体验评审
 
 ##### ax-critic (opus)
+
 批判性评审
 
 **使用示例**:
@@ -857,6 +967,7 @@ UX 专家评审
 **适用场景**: 全面挑战评审
 
 ##### ax-decomposer (opus)
+
 任务拆解
 
 **使用示例**:
@@ -867,6 +978,7 @@ UX 专家评审
 **适用场景**: 复杂任务分解
 
 ##### ax-implementer (sonnet)
+
 自动实施
 
 **使用示例**:
@@ -877,6 +989,7 @@ UX 专家评审
 **适用场景**: 按 manifest 执行
 
 ##### ax-error-analyzer (sonnet)
+
 错误分析
 
 **使用示例**:
@@ -887,6 +1000,7 @@ UX 专家评审
 **适用场景**: 错误诊断、修复建议
 
 ##### ax-reflector (opus)
+
 反思总结
 
 **使用示例**:
@@ -897,6 +1011,7 @@ UX 专家评审
 **适用场景**: 知识收割、经验总结
 
 ##### ax-knowledge-curator (sonnet)
+
 知识库管理
 
 **使用示例**:
@@ -907,6 +1022,7 @@ UX 专家评审
 **适用场景**: 知识管理、经验沉淀
 
 ##### ax-pattern-detector (sonnet)
+
 模式检测
 
 **使用示例**:
@@ -917,6 +1033,7 @@ UX 专家评审
 **适用场景**: 重复模式识别
 
 ##### ax-workflow-optimizer (opus)
+
 工作流优化
 
 **使用示例**:
@@ -927,6 +1044,7 @@ UX 专家评审
 **适用场景**: 流程改进
 
 ##### ax-context-manager (haiku)
+
 上下文管理
 
 **使用示例**:
@@ -937,6 +1055,7 @@ UX 专家评审
 **适用场景**: 状态查询、上下文切换
 
 ##### ax-gate-keeper (haiku)
+
 门禁检查
 
 **使用示例**:
@@ -954,6 +1073,7 @@ ultrapower 提供 70 个 skills，按类型分类。
 #### 6.2.1 Workflow Skills（工作流 Skills）
 
 ##### autopilot
+
 **触发词**: "autopilot", "build me", "I want a"
 
 **描述**: 全自主执行，从想法到可运行代码
@@ -964,6 +1084,7 @@ autopilot "创建一个 REST API"
 ```
 
 ##### ralph
+
 **触发词**: "ralph", "don't stop", "must complete"
 
 **描述**: 持续执行直到 verifier 验证通过
@@ -974,6 +1095,7 @@ ralph "修复所有类型错误"
 ```
 
 ##### ultrawork
+
 **触发词**: "ulw", "ultrawork"
 
 **描述**: 最大并行度 agent 编排
@@ -984,6 +1106,7 @@ ultrawork "并行重构 3 个模块"
 ```
 
 ##### team
+
 **触发词**: "team", "coordinated team", "team ralph"
 
 **描述**: 多 agent 协作，分阶段流水线
@@ -994,6 +1117,7 @@ team "重构用户认证模块"
 ```
 
 ##### pipeline
+
 **触发词**: "pipeline", "chain agents"
 
 **描述**: 顺序 agent 链式执行
@@ -1004,6 +1128,7 @@ pipeline "分析 -> 设计 -> 实现"
 ```
 
 ##### ultraqa
+
 **触发词**: 由 autopilot 自动激活
 
 **描述**: QA 循环——测试、验证、修复、重复
@@ -1014,6 +1139,7 @@ ultraqa "验证登录功能"
 ```
 
 ##### plan
+
 **触发词**: "plan this", "plan the"
 
 **描述**: 战略规划，支持 --consensus 和 --review 模式
@@ -1025,6 +1151,7 @@ plan --consensus "架构设计"
 ```
 
 ##### ralplan
+
 **触发词**: "ralplan", "consensus plan"
 
 **描述**: 与 Planner、Architect、Critic 迭代规划直至达成共识
@@ -1035,6 +1162,7 @@ ralplan "微服务架构"
 ```
 
 ##### sciomc
+
 **触发词**: "sciomc"
 
 **描述**: 并行 scientist agents 进行全面分析
@@ -1045,6 +1173,7 @@ sciomc "分析用户行为数据"
 ```
 
 ##### external-context
+
 **触发词**: 手动调用
 
 **描述**: 并行 document-specialist agents 进行网络搜索
@@ -1055,6 +1184,7 @@ sciomc "分析用户行为数据"
 ```
 
 ##### deepinit
+
 **触发词**: "deepinit"
 
 **描述**: 使用分层 AGENTS.md 进行深度代码库初始化
@@ -1065,6 +1195,7 @@ deepinit
 ```
 
 ##### next-step-router
+
 **触发词**: 手动调用
 
 **描述**: 分析产出，推荐最优下一步 agent/skill
@@ -1077,6 +1208,7 @@ deepinit
 #### 6.2.2 Axiom Skills（Axiom 工作流）
 
 ##### ax-draft
+
 **触发词**: 手动调用
 
 **描述**: 生成 Draft PRD
@@ -1087,6 +1219,7 @@ deepinit
 ```
 
 ##### ax-review
+
 **触发词**: 手动调用
 
 **描述**: 专家评审（domain/product/ux/critic）
@@ -1098,6 +1231,7 @@ deepinit
 ```
 
 ##### ax-decompose
+
 **触发词**: 手动调用
 
 **描述**: 任务拆解，生成 manifest.md
@@ -1108,6 +1242,7 @@ deepinit
 ```
 
 ##### ax-implement
+
 **触发词**: 手动调用
 
 **描述**: 按 manifest 自动实施
@@ -1118,6 +1253,7 @@ deepinit
 ```
 
 ##### ax-analyze-error
+
 **触发词**: 手动调用
 
 **描述**: 错误分析和修复建议
@@ -1128,6 +1264,7 @@ deepinit
 ```
 
 ##### ax-reflect
+
 **触发词**: 手动调用
 
 **描述**: 反思总结，知识收割
@@ -1138,6 +1275,7 @@ deepinit
 ```
 
 ##### ax-status
+
 **触发词**: 手动调用
 
 **描述**: 查看 Axiom 状态
@@ -1148,6 +1286,7 @@ deepinit
 ```
 
 ##### ax-suspend
+
 **触发词**: 手动调用
 
 **描述**: 保存状态并退出
@@ -1158,6 +1297,7 @@ deepinit
 ```
 
 ##### ax-rollback
+
 **触发词**: 手动调用
 
 **描述**: 回滚到上一个状态
@@ -1168,6 +1308,7 @@ deepinit
 ```
 
 ##### ax-evolution
+
 **触发词**: 手动调用
 
 **描述**: 知识库/模式库管理
@@ -1179,6 +1320,7 @@ deepinit
 ```
 
 ##### ax-knowledge
+
 **触发词**: 手动调用
 
 **描述**: 知识库管理
@@ -1189,6 +1331,7 @@ deepinit
 ```
 
 ##### ax-export
+
 **触发词**: 手动调用
 
 **描述**: 导出工作流
@@ -1201,6 +1344,7 @@ deepinit
 #### 6.2.3 Agent Shortcuts（Agent 快捷方式）
 
 ##### analyze
+
 **触发词**: "analyze", "debug", "investigate"
 
 **描述**: 调用 debugger agent
@@ -1211,6 +1355,7 @@ analyze "登录失败原因"
 ```
 
 ##### deepsearch
+
 **触发词**: "search", "find in codebase"
 
 **描述**: 调用 explore agent
@@ -1221,6 +1366,7 @@ deepsearch "认证相关文件"
 ```
 
 ##### tdd
+
 **触发词**: "tdd", "test first", "red green"
 
 **描述**: 调用 test-engineer agent
@@ -1231,6 +1377,7 @@ tdd "登录功能"
 ```
 
 ##### build-fix
+
 **触发词**: "fix build", "type errors"
 
 **描述**: 调用 build-fixer agent
@@ -1241,6 +1388,7 @@ build-fix
 ```
 
 ##### code-review
+
 **触发词**: "review code"
 
 **描述**: 调用 code-reviewer agent
@@ -1251,6 +1399,7 @@ code-review
 ```
 
 ##### security-review
+
 **触发词**: "security review"
 
 **描述**: 调用 security-reviewer agent
@@ -1261,6 +1410,7 @@ security-review
 ```
 
 ##### frontend-ui-ux
+
 **触发词**: 自动检测 UI/组件/样式工作
 
 **描述**: 调用 designer agent
@@ -1271,6 +1421,7 @@ frontend-ui-ux "设计登录界面"
 ```
 
 ##### git-master
+
 **触发词**: 自动检测 git/提交工作
 
 **描述**: 调用 git-master agent
@@ -1281,6 +1432,7 @@ git-master "整理提交历史"
 ```
 
 ##### review
+
 **触发词**: "review plan", "critique plan"
 
 **描述**: 调用 plan --review
@@ -1293,6 +1445,7 @@ review "架构设计"
 #### 6.2.4 MCP 委派 Skills
 
 ##### ask-codex
+
 **触发词**: "ask codex", "use codex", "delegate to codex"
 
 **描述**: 委派给 OpenAI Codex（gpt-5.3-codex）
@@ -1303,6 +1456,7 @@ ask codex "审查架构设计"
 ```
 
 ##### ask-gpt
+
 **触发词**: "ask gpt", "use gpt", "delegate to gpt"
 
 **描述**: 委派给 OpenAI GPT（映射到 Codex）
@@ -1313,6 +1467,7 @@ ask gpt "代码审查"
 ```
 
 ##### ask-gemini
+
 **触发词**: "ask gemini", "use gemini", "delegate to gemini"
 
 **描述**: 委派给 Google Gemini（1M 上下文）
@@ -1325,6 +1480,7 @@ ask gemini "分析大型代码库"
 #### 6.2.5 Utility Skills（工具类）
 
 ##### cancel
+
 **触发词**: 手动调用
 
 **描述**: 取消执行模式
@@ -1336,6 +1492,7 @@ ask gemini "分析大型代码库"
 ```
 
 ##### note
+
 **触发词**: 手动调用
 
 **描述**: 添加笔记到 notepad
@@ -1346,6 +1503,7 @@ ask gemini "分析大型代码库"
 ```
 
 ##### learner
+
 **触发词**: 手动调用
 
 **描述**: 学习模式
@@ -1356,6 +1514,7 @@ ask gemini "分析大型代码库"
 ```
 
 ##### omc-setup
+
 **触发词**: "setup omc"
 
 **描述**: 安装向导
@@ -1366,6 +1525,7 @@ ask gemini "分析大型代码库"
 ```
 
 ##### mcp-setup
+
 **触发词**: 手动调用
 
 **描述**: MCP 配置向导
@@ -1376,6 +1536,7 @@ ask gemini "分析大型代码库"
 ```
 
 ##### hud
+
 **触发词**: 手动调用
 
 **描述**: 显示状态面板
@@ -1386,6 +1547,7 @@ ask gemini "分析大型代码库"
 ```
 
 ##### omc-doctor
+
 **触发词**: 手动调用
 
 **描述**: 诊断工具
@@ -1396,6 +1558,7 @@ ask gemini "分析大型代码库"
 ```
 
 ##### omc-help
+
 **触发词**: 手动调用
 
 **描述**: 帮助文档
@@ -1406,6 +1569,7 @@ ask gemini "分析大型代码库"
 ```
 
 ##### trace
+
 **触发词**: 手动调用
 
 **描述**: 追踪执行日志
@@ -1416,6 +1580,7 @@ ask gemini "分析大型代码库"
 ```
 
 ##### release
+
 **触发词**: 手动调用
 
 **描述**: 发布管理
@@ -1426,6 +1591,7 @@ ask gemini "分析大型代码库"
 ```
 
 ##### project-session-manager (psm)
+
 **触发词**: 手动调用
 
 **描述**: 项目会话管理
@@ -1436,6 +1602,7 @@ ask gemini "分析大型代码库"
 ```
 
 ##### skill
+
 **触发词**: 手动调用
 
 **描述**: Skill 管理
@@ -1446,6 +1613,7 @@ ask gemini "分析大型代码库"
 ```
 
 ##### writer-memory
+
 **触发词**: 手动调用
 
 **描述**: 写作记忆管理
@@ -1456,6 +1624,7 @@ ask gemini "分析大型代码库"
 ```
 
 ##### ralph-init
+
 **触发词**: 手动调用
 
 **描述**: Ralph 初始化
@@ -1466,6 +1635,7 @@ ask gemini "分析大型代码库"
 ```
 
 ##### learn-about-omc
+
 **触发词**: 手动调用
 
 **描述**: 学习 ultrapower
@@ -1476,6 +1646,7 @@ ask gemini "分析大型代码库"
 ```
 
 ##### configure-discord
+
 **触发词**: "configure discord", "setup discord"
 
 **描述**: 配置 Discord 通知
@@ -1486,6 +1657,7 @@ ask gemini "分析大型代码库"
 ```
 
 ##### configure-telegram
+
 **触发词**: "configure telegram", "setup telegram"
 
 **描述**: 配置 Telegram 通知
@@ -1496,6 +1668,7 @@ ask gemini "分析大型代码库"
 ```
 
 ##### swarm
+
 **触发词**: "swarm"
 
 **描述**: Team 的兼容性外观（已废弃，使用 team）
@@ -1506,6 +1679,7 @@ swarm "任务"
 ```
 
 ##### ultrapilot
+
 **触发词**: "ultrapilot", "parallel build"
 
 **描述**: Team 的兼容性外观（已废弃，使用 team）
@@ -1522,6 +1696,7 @@ ultrapilot "任务"
 ultrapower 提供 15 种 Hook 类型。
 
 #### PreToolUse
+
 **触发时机**: 工具调用前
 
 **配置示例**:
@@ -1536,6 +1711,7 @@ ultrapower 提供 15 种 Hook 类型。
 **常见用例**: 代码格式化、权限检查
 
 #### PostToolUse
+
 **触发时机**: 工具调用后
 
 **配置示例**:
@@ -1550,6 +1726,7 @@ ultrapower 提供 15 种 Hook 类型。
 **常见用例**: 自动提交、通知发送
 
 #### SessionStart
+
 **触发时机**: 会话开始
 
 **配置示例**:
@@ -1563,6 +1740,7 @@ ultrapower 提供 15 种 Hook 类型。
 **常见用例**: 加载项目上下文、初始化环境
 
 #### SessionEnd
+
 **触发时机**: 会话结束
 
 **配置示例**:
@@ -1576,6 +1754,7 @@ ultrapower 提供 15 种 Hook 类型。
 **常见用例**: 清理临时文件、保存状态
 
 #### PermissionRequest
+
 **触发时机**: 权限请求时
 
 **配置示例**:
@@ -1590,6 +1769,7 @@ ultrapower 提供 15 种 Hook 类型。
 **常见用例**: 权限审计、安全检查
 
 #### AgentStart
+
 **触发时机**: Agent 启动时
 
 **配置示例**:
@@ -1603,6 +1783,7 @@ ultrapower 提供 15 种 Hook 类型。
 **常见用例**: Agent 监控、日志记录
 
 #### AgentComplete
+
 **触发时机**: Agent 完成时
 
 **配置示例**:
@@ -1616,6 +1797,7 @@ ultrapower 提供 15 种 Hook 类型。
 **常见用例**: 结果通知、指标收集
 
 #### AgentError
+
 **触发时机**: Agent 错误时
 
 **配置示例**:
@@ -1629,6 +1811,7 @@ ultrapower 提供 15 种 Hook 类型。
 **常见用例**: 错误告警、自动重试
 
 #### StateChange
+
 **触发时机**: 状态变更时
 
 **配置示例**:
@@ -1643,6 +1826,7 @@ ultrapower 提供 15 种 Hook 类型。
 **常见用例**: 状态监控、流程控制
 
 #### FileModified
+
 **触发时机**: 文件修改时
 
 **配置示例**:
@@ -1657,6 +1841,7 @@ ultrapower 提供 15 种 Hook 类型。
 **常见用例**: 类型检查、自动测试
 
 #### TestRun
+
 **触发时机**: 测试运行时
 
 **配置示例**:
@@ -1670,6 +1855,7 @@ ultrapower 提供 15 种 Hook 类型。
 **常见用例**: 测试报告、覆盖率收集
 
 #### BuildComplete
+
 **触发时机**: 构建完成时
 
 **配置示例**:
@@ -1683,6 +1869,7 @@ ultrapower 提供 15 种 Hook 类型。
 **常见用例**: 部署触发、通知发送
 
 #### CommitPrepare
+
 **触发时机**: 提交准备时
 
 **配置示例**:
@@ -1696,6 +1883,7 @@ ultrapower 提供 15 种 Hook 类型。
 **常见用例**: Lint 检查、测试运行
 
 #### ErrorDetected
+
 **触发时机**: 错误检测时
 
 **配置示例**:
@@ -1709,6 +1897,7 @@ ultrapower 提供 15 种 Hook 类型。
 **常见用例**: 错误日志、告警通知
 
 #### CustomEvent
+
 **触发时机**: 自定义事件
 
 **配置示例**:
@@ -1736,23 +1925,28 @@ ultrapower 提供 15 种 Hook 类型。
 touch agents/my-custom-agent.md
 ```
 
-2. 定义 agent 提示词
+1. 定义 agent 提示词
 
 ```markdown
+
 # My Custom Agent
 
 你是一个专门处理 X 任务的 agent。
 
 ## 职责
-- 任务 1
-- 任务 2
+
+* 任务 1
+
+* 任务 2
 
 ## 约束
-- 约束 1
-- 约束 2
+
+* 约束 1
+
+* 约束 2
 ```
 
-3. 在 `src/agents/definitions.ts` 注册
+1. 在 `src/agents/definitions.ts` 注册
 
 ```typescript
 export const agentDefinitions = {
@@ -1763,7 +1957,7 @@ export const agentDefinitions = {
 };
 ```
 
-4. 使用自定义 agent
+1. 使用自定义 agent
 
 ```
 Task(subagent_type="ultrapower:my-custom-agent", prompt="执行任务")
@@ -1779,19 +1973,21 @@ Task(subagent_type="ultrapower:my-custom-agent", prompt="执行任务")
 mkdir skills/my-custom-skill
 ```
 
-2. 创建 `SKILL.md` 定义
+1. 创建 `SKILL.md` 定义
 
 ```markdown
+
 # My Custom Skill
 
 触发词: "my-skill"
 
 ## 执行逻辑
+
 1. 步骤 1
 2. 步骤 2
 ```
 
-3. 创建实现文件 `index.ts`
+1. 创建实现文件 `index.ts`
 
 ```typescript
 export async function myCustomSkill(input: string) {
@@ -1799,7 +1995,7 @@ export async function myCustomSkill(input: string) {
 }
 ```
 
-4. 使用自定义 skill
+1. 使用自定义 skill
 
 ```
 /ultrapower:my-custom-skill "参数"
@@ -1815,7 +2011,7 @@ export async function myCustomSkill(input: string) {
 touch .claude/hooks/my-hook.json
 ```
 
-2. 定义触发条件和动作
+1. 定义触发条件和动作
 
 ```json
 {
@@ -1826,34 +2022,47 @@ touch .claude/hooks/my-hook.json
 }
 ```
 
-3. Hook 自动生效（无需重启）
+1. Hook 自动生效（无需重启）
 
 #### 6.4.4 扩展最佳实践
 
 **Agent 扩展**:
-- 明确单一职责
-- 提供清晰的约束
-- 包含使用示例
+
+* 明确单一职责
+
+* 提供清晰的约束
+
+* 包含使用示例
 
 **Skill 扩展**:
-- 定义明确的触发词
-- 避免与现有 skill 冲突
-- 提供错误处理
+
+* 定义明确的触发词
+
+* 避免与现有 skill 冲突
+
+* 提供错误处理
 
 **Hook 扩展**:
-- 使用精确的条件判断
-- 避免阻塞操作
-- 记录执行日志
+
+* 使用精确的条件判断
+
+* 避免阻塞操作
+
+* 记录执行日志
 
 **调试技巧**:
 ```bash
+
 # 查看 agent 日志
+
 cat .omc/logs/agent-*.log
 
 # 查看 hook 执行记录
+
 cat .omc/logs/hook-*.log
 
 # 诊断工具
+
 /ultrapower:omc-doctor
 ```
 
@@ -1864,10 +2073,14 @@ cat .omc/logs/hook-*.log
 配置 ultrapower 以适应你的工作流。
 
 **本章节内容**:
-- MCP 服务器配置
-- Hooks 配置
-- Steering 规则
-- Axiom 系统配置
+
+* MCP 服务器配置
+
+* Hooks 配置
+
+* Steering 规则
+
+* Axiom 系统配置
 
 *（待补充）*
 
@@ -1880,7 +2093,7 @@ cat .omc/logs/hook-*.log
 ### 8.1 常见错误代码
 
 | 错误代码 | 描述 | 解决方案 |
-|---------|------|---------|
+| --------- | ------ | --------- |
 | E001 | 命令未找到 | 检查 Claude Code 安装和 PATH |
 | E002 | Marketplace 未找到 | 验证 URL 和网络连接 |
 | E003 | omc-setup 失败 | 检查 Node.js 版本，清除缓存 |
@@ -1895,31 +2108,41 @@ cat .omc/logs/hook-*.log
 ### 8.2 日志查看指南
 
 ```bash
+
 # Agent 执行日志
+
 cat .omc/logs/agent-execution.log
 
 # Hook 执行日志
+
 cat .omc/logs/hook-execution.log
 
 # Team 状态
+
 cat .omc/state/team-state.json
 
 # 查看所有日志
+
 ls -la .omc/logs/
 ```
 
 ### 8.3 调试工具
 
-- `/ultrapower:omc-doctor` - 系统诊断，检查配置和依赖
-- `/ultrapower:trace timeline` - 执行追踪，查看 agent 调用链
-- `/ultrapower:hud` - 实时状态监控，显示当前执行状态
+* `/ultrapower:omc-doctor` - 系统诊断，检查配置和依赖
+
+* `/ultrapower:trace timeline` - 执行追踪，查看 agent 调用链
+
+* `/ultrapower:hud` - 实时状态监控，显示当前执行状态
 
 ### 8.4 概念澄清
 
 **Agent vs Skill**:
-- **Agent**: 执行单元（如 executor、debugger），专注单一职责
-- **Skill**: 工作流编排（如 autopilot、team），内部调用多个 Agents
-- **关系**: Skill 内部调用多个 Agents 完成复杂任务
+
+* **Agent**: 执行单元（如 executor、debugger），专注单一职责
+
+* **Skill**: 工作流编排（如 autopilot、team），内部调用多个 Agents
+
+* **关系**: Skill 内部调用多个 Agents 完成复杂任务
 
 **决策树**:
 ```
@@ -2022,9 +2245,12 @@ A: 使用并行模式（ultrawork/team）
 如何更新到最新版本。
 
 **本章节内容**:
-- 更新步骤
-- 破坏性变更
-- 迁移指南
+
+* 更新步骤
+
+* 破坏性变更
+
+* 迁移指南
 
 *（待补充）*
 
@@ -2032,11 +2258,15 @@ A: 使用并行模式（ultrawork/team）
 
 ## 相关文档
 
-- [REFERENCE.md](REFERENCE.md) - 完整功能参考
-- [CLAUDE.md](../CLAUDE.md) - 开发规范
-- [ARCHITECTURE.md](ARCHITECTURE.md) - 架构设计
-- [TROUBLESHOOTING.md](TROUBLESHOOTING.md) - 故障排查
-- [FAQ.md](FAQ.md) - 常见问题
+* [REFERENCE.md](REFERENCE.md) - 完整功能参考
+
+* [CLAUDE.md](../CLAUDE.md) - 开发规范
+
+* [ARCHITECTURE.md](ARCHITECTURE.md) - 架构设计
+
+* [TROUBLESHOOTING.md](TROUBLESHOOTING.md) - 故障排查
+
+* [FAQ.md](FAQ.md) - 常见问题
 
 ---