@liangjie559567/ultrapower 5.6.8 → 5.6.9

package/README.md

@@ -1,486 +1,486 @@
-# ultrapower
-
-ultrapower 是 Claude Code 的智能多 Agent 编排层（OMC），在 superpowers 工作流基础上深度融合了 Axiom 框架，提供 **49 个专业 agents**、**71 个 skills** 和完整的 TypeScript hooks 系统。
-
-## 核心能力
-
-* **多 Agent 编排**：Team、ultrawork、ralph、autopilot 等多种执行模式
-
-* **Axiom 框架集成**：LSP/AST 代码智能、持久记忆、MCP 路由
-
-* **完整工作流**：从头脑风暴到代码审查的端到端开发流程
-
-* **自动触发**：Skills 根据上下文自动激活，无需手动调用
-
-## 快速开始（10 分钟上手）
-
-**新用户？** 查看 [📖 5 分钟快速入门指南](docs/QUICKSTART.md)
-
-### 前置条件
-
-* Node.js >= 18
-
-* Claude Code >= v1.0.0
-
-* Git（用于插件安装）
-
-### 安装步骤
-
-**方式 1：通过 Claude Code 插件（推荐）**
-
-在 Claude Code 会话中运行：
-
-```bash
-
-# 1. 添加 marketplace 并安装
-
-/plugin marketplace add <<https://github.com/liangjie559567/ultrapower>>
-/plugin install omc@ultrapower
-
-# 2. 运行安装向导
-
-/ultrapower:omc-setup
-```
-
-**方式 2：通过 npm 全局安装**
-
-```bash
-npm install -g @liangjie559567/ultrapower
-```
-
-### 验证安装
-
-```bash
-
-# 验证安装
-
-/ultrapower:omc-doctor
-```
-
-### 第一个示例
-
-```bash
-
-# 使用 autopilot 模式构建一个简单功能
-
-autopilot "创建一个 hello world 函数"
-```
-
-### 故障排查
-
-遇到问题？查看 [故障排查指南](docs/TROUBLESHOOTING.md)
-
----
-
-## 基础工作流
-
-1. **brainstorming** — 代码前必须先设计。通过对话细化需求，探索 2-3 种方案，呈现设计并获批准，保存设计文档。
-
-1. **using-git-worktrees** — 设计批准后创建隔离工作区，新建分支，运行项目初始化，验证测试基线。
-
-1. **writing-plans** — 将工作拆解为 2-5 分钟的原子任务。每个任务包含精确文件路径、完整代码、验证步骤。
-
-1. **subagent-driven-development** / **executing-plans** — 每个任务派发独立 subagent，两阶段审查（规格合规 + 代码质量），或批量执行带检查点。
-
-1. **test-driven-development** — RED-GREEN-REFACTOR：先写失败测试，再写最小实现，再重构。
-
-1. **requesting-code-review** — 任务间审查，按严重程度报告问题，关键问题阻塞进度。
-
-1. **finishing-a-development-branch** — 验证测试，呈现选项（merge/PR/保留/丢弃），清理 worktree。
-
----
-
-## Agents（50 个）
-
-### 构建/分析通道
-
-| Agent | 模型 | 用途 |
-| ------- | ------ | ------ |
-| `explore` | haiku | 代码库发现、符号/文件映射 |
-| `analyst` | opus | 需求澄清、验收标准 |
-| `planner` | opus | 任务排序、执行计划 |
-| `architect` | opus | 系统设计、接口、长期权衡 |
-| `debugger` | sonnet | 根因分析、回归隔离 |
-| `executor` | sonnet | 代码实现、重构、功能开发 |
-| `deep-executor` | opus | 复杂自主目标导向任务 |
-| `verifier` | sonnet | 完成证据、声明验证 |
-
-### 审查通道
-
-| Agent | 模型 | 用途 |
-| ------- | ------ | ------ |
-| `style-reviewer` | haiku | 格式、命名、惯用法 |
-| `quality-reviewer` | sonnet | 逻辑缺陷、可维护性 |
-| `api-reviewer` | sonnet | API 契约、版本控制 |
-| `security-reviewer` | sonnet | 漏洞、信任边界 |
-| `performance-reviewer` | sonnet | 热点、复杂度优化 |
-| `code-reviewer` | opus | 跨关注点综合审查 |
-
-### 领域专家
-
-| Agent | 模型 | 用途 |
-| ------- | ------ | ------ |
-| `dependency-expert` | sonnet | 外部 SDK/API/包评估 |
-| `test-engineer` | sonnet | 测试策略、覆盖率 |
-| `quality-strategist` | sonnet | 质量策略、发布就绪性 |
-| `build-fixer` | sonnet | 构建/工具链/类型失败 |
-| `designer` | sonnet | UX/UI 架构、交互设计 |
-| `writer` | haiku | 文档、迁移说明 |
-| `qa-tester` | sonnet | 交互式 CLI/服务验证 |
-| `scientist` | sonnet | 数据/统计分析 |
-| `document-specialist` | sonnet | 外部文档查找 |
-| `git-master` | sonnet | 提交策略、历史整洁 |
-| `database-expert` | sonnet | 数据库设计、查询优化和迁移 |
-| `devops-engineer` | sonnet | CI/CD、容器化、基础设施即代码 |
-| `i18n-specialist` | sonnet | 国际化、本地化和多语言支持 |
-| `accessibility-auditor` | sonnet | Web 无障碍审查和 WCAG 合规 |
-| `api-designer` | sonnet | REST/GraphQL API 设计和契约定义 |
-
-### 产品通道
-
-| Agent | 模型 | 用途 |
-| ------- | ------ | ------ |
-| `product-manager` | sonnet | 问题定义、PRD |
-| `ux-researcher` | sonnet | 启发式审计、可用性 |
-| `information-architect` | sonnet | 分类、导航 |
-| `product-analyst` | sonnet | 产品指标、漏斗分析 |
-
-### 协调
-
-| Agent | 模型 | 用途 |
-| ------- | ------ | ------ |
-| `critic` | opus | 计划/设计批判性挑战 |
-| `vision` | sonnet | 图片/截图/图表分析 |
-
-### Axiom Agents
-
-| Agent | 模型 | 用途 |
-| ------- | ------ | ------ |
-| `axiom-requirement-analyst` | sonnet | 需求分析三态门（PASS/CLARIFY/REJECT） |
-| `axiom-product-designer` | sonnet | Draft PRD 生成，含 Mermaid 流程图 |
-| `axiom-review-aggregator` | sonnet | 5 专家并行审查聚合与冲突仲裁 |
-| `axiom-prd-crafter` | sonnet | 工程级 PRD，含门控验证 |
-| `axiom-system-architect` | sonnet | 原子任务 DAG 与 Manifest 生成 |
-| `axiom-evolution-engine` | sonnet | 知识收割、模式检测、工作流优化 |
-| `axiom-context-manager` | sonnet | 7 操作记忆系统（读/写/状态/检查点） |
-| `axiom-worker` | sonnet | PM→Worker 协议，三态输出 |
-| `axiom-ux-director` | sonnet | UX/体验专家评审 |
-| `axiom-product-director` | sonnet | 产品战略专家评审 |
-| `axiom-domain-expert` | sonnet | 领域知识专家评审 |
-| `axiom-tech-lead` | sonnet | 技术可行性评审 |
-| `axiom-critic` | sonnet | 安全/质量/逻辑评审 |
-| `axiom-sub-prd-writer` | sonnet | 将 Manifest 任务拆解为可执行 Sub-PRD |
-
----
-
-## Skills（70 个）
-
-### 工作流 Skills
-
-| Skill | 触发词 | 用途 |
-| ------- | -------- | ------ |
-| `autopilot` | "autopilot", "build me" | 从想法到可运行代码的全自主执行 |
-| `ralph` | "ralph", "don't stop" | 带 verifier 验证的自引用循环 |
-| `ultrawork` | "ulw", "ultrawork" | 并行 agent 编排最大并行度 |
-| `team` | "team", "coordinated team" | N 个协调 agents，阶段感知路由 |
-| `ultrapilot` | "ultrapilot", "parallel build" | 带文件所有权分区的并行 autopilot |
-| `pipeline` | "pipeline", "chain agents" | 带数据传递的顺序 agent 链 |
-| `ultraqa` | 由 autopilot 激活 | QA 循环：测试、验证、修复、重复 |
-| `plan` | "plan this", "plan the" | 战略规划，支持 `--consensus`/`--review` |
-| `ralplan` | "ralplan", "consensus plan" | 与 Planner/Architect/Critic 迭代规划 |
-| `swarm` | "swarm" | Team 的兼容性外观 |
-
-### 开发工作流 Skills
-
-| Skill | 用途 |
-| ------- | ------ |
-| `brainstorming` | 设计对话，代码前必须先设计 |
-| `writing-plans` | 详细实现计划，原子任务 |
-| `executing-plans` | 带检查点的批量执行 |
-| `subagent-driven-development` | 每任务独立 subagent + 两阶段审查 |
-| `test-driven-development` | RED-GREEN-REFACTOR 循环 |
-| `systematic-debugging` | 4 阶段根因分析 |
-| `verification-before-completion` | 完成前验证 |
-| `requesting-code-review` | 代码审查前检查清单 |
-| `receiving-code-review` | 响应审查反馈 |
-| `using-git-worktrees` | 并行开发分支 |
-| `finishing-a-development-branch` | 合并/PR 决策工作流 |
-| `next-step-router` | 关键节点推荐最优下一步 |
-
-### Axiom Skills
-
-| Skill | 用途 |
-| ------- | ------ |
-| `ax-draft` | 需求澄清 → Draft PRD → 用户确认 |
-| `ax-review` | 5 专家并行评审 → 聚合 → Rough PRD |
-| `ax-decompose` | Rough PRD → 系统架构 → 原子任务 DAG |
-| `ax-implement` | 按 Manifest 执行任务，CI 门禁，自动修复 |
-| `ax-analyze-error` | 根因诊断 → 自动修复 → 知识队列 |
-| `ax-reflect` | 会话反思 → 经验提取 → Action Items |
-| `ax-evolve` | 处理学习队列 → 更新知识库 → 模式检测 |
-| `ax-status` | 完整系统状态仪表盘 |
-| `ax-rollback` | 回滚到最近检查点（需用户确认） |
-| `ax-suspend` | 保存会话状态，安全退出 |
-| `ax-context` | 直接操作 Axiom 记忆系统 |
-| `ax-evolution` | 进化引擎统一入口（evolve/reflect/knowledge/patterns） |
-| `ax-knowledge` | 查询 Axiom 知识库 |
-| `ax-export` | 导出 Axiom 工作流产物 |
-
-### 增强 Skills
-
-| Skill | 用途 |
-| ------- | ------ |
-| `deepinit` | 分层 AGENTS.md 代码库文档化 |
-| `deepsearch` | 多策略深度代码库搜索 |
-| `analyze` | 深度分析与调查（debugger 别名） |
-| `sciomc` | 并行 scientist 编排 |
-| `external-context` | 并行 document-specialist 网络搜索 |
-| `ccg` | Claude-Codex-Gemini 三模型并行编排 |
-| `frontend-ui-ux` | UI/UX 专业能力（静默激活） |
-| `git-master` | Git 专家，原子提交和历史管理（静默激活） |
-| `build-fix` | 修复构建和 TypeScript 错误 |
-| `code-review` | 全面代码审查 |
-| `security-review` | 安全漏洞检测 |
-| `trace` | 显示 agent 流程追踪时间线 |
-| `learn-about-omc` | 了解 OMC 使用模式并获取建议 |
-| `dispatching-parallel-agents` | 并行分发独立任务给多个 agents |
-
-### 工具类 Skills
-
-| Skill | 用途 |
-| ------- | ------ |
-| `cancel` | 统一取消所有执行模式 |
-| `note` | 保存笔记到抗压缩 notepad |
-| `learner` | 从会话中提取可复用 skill |
-| `omc-setup` | 一次性安装向导 |
-| `mcp-setup` | 配置 MCP 服务器 |
-| `hud` | 配置 HUD 状态栏 |
-| `omc-doctor` | 诊断并修复安装问题 |
-| `omc-help` | 显示 OMC 使用指南 |
-| `release` | 自动化发布工作流 |
-| `ralph-init` | 初始化 PRD 以进行结构化任务跟踪 |
-| `review` | 用 critic 审查工作计划 |
-| `writer-memory` | 面向写作者的 agent 记忆系统 |
-| `project-session-manager` | 管理隔离开发环境（git worktrees + tmux） |
-| `psm` | project-session-manager 别名 |
-| `skill` | 管理本地 skills（列出、添加、删除、搜索、编辑） |
-| `wizard` | 交互式配置向导 |
-| `writing-skills` | 创建/编辑/验证 skills |
-| `configure-discord` | 配置 Discord webhook/bot 通知 |
-| `configure-telegram` | 配置 Telegram bot 通知 |
-| `using-superpowers` | 建立 skill 使用规则 |
-
----
-
-## 执行模式
-
-### Team 流水线（默认多 Agent 编排器）
-
-```
-team-plan → team-prd → team-exec → team-verify → team-fix（循环）
-```
-
-* **team-plan**：`explore` + `planner`，可选 `analyst`/`architect`
-
-* **team-prd**：`analyst`，可选 `product-manager`/`critic`
-
-* **team-exec**：`executor` + 任务适配专家
-
-* **team-verify**：`verifier` + 按需审查 agents
-
-* **team-fix**：根据缺陷类型路由到 `executor`/`build-fixer`/`debugger`
-
-### MCP 路由
-
-对只读分析任务优先使用 MCP 工具（更快更经济）：
-
-* **Codex**（`mcp__x__ask_codex`）：架构审查、规划验证、代码审查
-
-* **Gemini**（`mcp__g__ask_gemini`）：UI/UX 设计、大上下文任务（1M tokens）
-
-### Axiom 代码智能
-
-* **LSP**：hover、goto definition、find references、diagnostics、rename
-
-* **AST**：`ast_grep_search`（结构化模式搜索）、`ast_grep_replace`（结构化转换）
-
-* **Python REPL**：持久数据分析环境
-
----
-
-## Axiom 自我进化系统
-
-ultrapower 内置 Axiom 自我进化引擎，让 AI 工作流随使用不断优化。
-
-### 核心机制
-
-| 机制 | 说明 |
-| ------ | ------ |
-| 知识收割 | 每次任务完成后自动提取经验教训，存入知识库 |
-| 模式检测 | 识别重复代码模式，达到阈值（出现 ≥3 次）后提升为最佳实践 |
-| 工作流优化 | 分析执行指标，发现瓶颈并生成优化建议 |
-| 跨会话记忆 | 知识库和模式库跨会话持久化，越用越聪明 |
-
-### 快速开始
-
-```bash
-
-# 1. 安装插件
-
-/plugin marketplace add <<https://github.com/liangjie559567/ultrapower>>
-/plugin install omc@ultrapower
-
-# 2. 初始化 Axiom 系统
-
-/ultrapower:ax-context init
-
-# 3. 查看系统状态
-
-/ax-status
-```
-
-### 进化工作流
-
-```
-需求 → /ax-draft → /ax-review → /ax-decompose → /ax-implement
-                                                      ↓
-                                                 任务完成
-                                                      ↓
-                                             /ax-reflect（反思）
-                                                      ↓
-                                             /ax-evolve（进化）
-                                                      ↓
-                                        知识库更新 + 模式库更新
-```
-
-详细文档请参阅 [docs/EVOLUTION.md](docs/EVOLUTION.md)。
-
----
-
-## MCP 服务器
-
-ultrapower 提供完整的 MCP（Model Context Protocol）服务器，暴露 35 个自定义工具供 Claude Desktop 和 Cursor 使用。
-
-### 快速开始
-
-```bash
-
-# 启动 MCP 服务器
-
-node bridge/mcp-server.cjs
-
-# 或使用 npm
-
-npm run mcp:start
-```
-
-### 配置 Claude Desktop
-
-编辑 `~/.claude/claude_desktop_config.json`：
-
-```json
-{
-  "mcpServers": {
-    "ultrapower": {
-      "command": "node",
-      "args": ["/path/to/ultrapower/bridge/mcp-server.cjs"],
-      "env": {
-        "OMC_LOG_LEVEL": "info"
-      }
-    }
-  }
-}
-```
-
-### 配置 Cursor
-
-在项目根目录创建 `.cursor/mcp.json`：
-
-```json
-{
-  "mcpServers": {
-    "ultrapower": {
-      "command": "node",
-      "args": ["/path/to/ultrapower/bridge/mcp-server.cjs"],
-      "env": {
-        "OMC_LOG_LEVEL": "info"
-      }
-    }
-  }
-}
-```
-
-### 可用工具（35 个）
-
-* **LSP 工具（12 个）**：代码导航、诊断、重构
-
-* **AST 工具（2 个）**：结构化模式匹配和替换
-
-* **Python REPL（1 个）**：持久数据分析环境
-
-* **Notepad 工具（6 个）**：会话记忆管理
-
-* **State 工具（5 个）**：模式状态管理
-
-* **Project Memory 工具（4 个）**：项目级持久记忆
-
-* **Trace 工具（2 个）**：Agent 流程追踪分析
-
-* **Skills 工具（3 个）**：Skill 加载和管理
-
-详见 [docs/guides/mcp-server-usage.md](docs/guides/mcp-server-usage.md)。
-
----
-
-## 哲学
-
-* **测试驱动开发** — 始终先写测试
-
-* **系统化而非临时** — 流程优于猜测
-
-* **复杂度降低** — 简洁是首要目标
-
-* **证据优于声明** — 声明成功前先验证
-
----
-
-## 赞助
-
-如果 ultrapower 帮助你完成了有价值的工作，欢迎[赞助开源工作](https://github.com/sponsors/liangjie559567)。
-
-## 贡献
-
-Skills 直接存放在本仓库中。贡献方式：
-
-1. Fork 仓库
-2. 为你的 skill 创建分支
-3. 遵循 `writing-skills` skill 创建和测试新 skill
-4. 提交 PR
-
-详见 `skills/writing-skills/SKILL.md`。
-
-## 更新
-
-```bash
-/plugin update omc@ultrapower
-```
-
-## 许可证
-
-MIT License — 详见 LICENSE 文件
-
-## 支持
-
-* **Issues**: <<https://github.com/liangjie559567/ultrapower/issues>>
-
-* **Marketplace**: <<https://github.com/liangjie559567/ultrapower>>
-
-* **安装部署教程**: [docs/INSTALL.md](docs/INSTALL.md)
-
-* **完整参考文档**: [docs/REFERENCE.md](docs/REFERENCE.md)
-
-* **进化系统文档**: [docs/EVOLUTION.md](docs/EVOLUTION.md)
-
-* **主动进化系统**: [docs/NEXUS.md](docs/NEXUS.md)
-
-* **迁移指南**: [docs/MIGRATION.md](docs/MIGRATION.md)
+# ultrapower
+
+ultrapower 是 Claude Code 的智能多 Agent 编排层（OMC），在 superpowers 工作流基础上深度融合了 Axiom 框架，提供 **49 个专业 agents**、**71 个 skills** 和完整的 TypeScript hooks 系统。
+
+## 核心能力
+
+* **多 Agent 编排**：Team、ultrawork、ralph、autopilot 等多种执行模式
+
+* **Axiom 框架集成**：LSP/AST 代码智能、持久记忆、MCP 路由
+
+* **完整工作流**：从头脑风暴到代码审查的端到端开发流程
+
+* **自动触发**：Skills 根据上下文自动激活，无需手动调用
+
+## 快速开始（10 分钟上手）
+
+**新用户？** 查看 [📖 5 分钟快速入门指南](docs/QUICKSTART.md)
+
+### 前置条件
+
+* Node.js >= 18
+
+* Claude Code >= v1.0.0
+
+* Git（用于插件安装）
+
+### 安装步骤
+
+**方式 1：通过 Claude Code 插件（推荐）**
+
+在 Claude Code 会话中运行：
+
+```bash
+
+# 1. 添加 marketplace 并安装
+
+/plugin marketplace add <<https://github.com/liangjie559567/ultrapower>>
+/plugin install omc@ultrapower
+
+# 2. 运行安装向导
+
+/ultrapower:omc-setup
+```
+
+**方式 2：通过 npm 全局安装**
+
+```bash
+npm install -g @liangjie559567/ultrapower
+```
+
+### 验证安装
+
+```bash
+
+# 验证安装
+
+/ultrapower:omc-doctor
+```
+
+### 第一个示例
+
+```bash
+
+# 使用 autopilot 模式构建一个简单功能
+
+autopilot "创建一个 hello world 函数"
+```
+
+### 故障排查
+
+遇到问题？查看 [故障排查指南](docs/TROUBLESHOOTING.md)
+
+---
+
+## 基础工作流
+
+1. **brainstorming** — 代码前必须先设计。通过对话细化需求，探索 2-3 种方案，呈现设计并获批准，保存设计文档。
+
+1. **using-git-worktrees** — 设计批准后创建隔离工作区，新建分支，运行项目初始化，验证测试基线。
+
+1. **writing-plans** — 将工作拆解为 2-5 分钟的原子任务。每个任务包含精确文件路径、完整代码、验证步骤。
+
+1. **subagent-driven-development** / **executing-plans** — 每个任务派发独立 subagent，两阶段审查（规格合规 + 代码质量），或批量执行带检查点。
+
+1. **test-driven-development** — RED-GREEN-REFACTOR：先写失败测试，再写最小实现，再重构。
+
+1. **requesting-code-review** — 任务间审查，按严重程度报告问题，关键问题阻塞进度。
+
+1. **finishing-a-development-branch** — 验证测试，呈现选项（merge/PR/保留/丢弃），清理 worktree。
+
+---
+
+## Agents（50 个）
+
+### 构建/分析通道
+
+| Agent | 模型 | 用途 |
+| ------- | ------ | ------ |
+| `explore` | haiku | 代码库发现、符号/文件映射 |
+| `analyst` | opus | 需求澄清、验收标准 |
+| `planner` | opus | 任务排序、执行计划 |
+| `architect` | opus | 系统设计、接口、长期权衡 |
+| `debugger` | sonnet | 根因分析、回归隔离 |
+| `executor` | sonnet | 代码实现、重构、功能开发 |
+| `deep-executor` | opus | 复杂自主目标导向任务 |
+| `verifier` | sonnet | 完成证据、声明验证 |
+
+### 审查通道
+
+| Agent | 模型 | 用途 |
+| ------- | ------ | ------ |
+| `style-reviewer` | haiku | 格式、命名、惯用法 |
+| `quality-reviewer` | sonnet | 逻辑缺陷、可维护性 |
+| `api-reviewer` | sonnet | API 契约、版本控制 |
+| `security-reviewer` | sonnet | 漏洞、信任边界 |
+| `performance-reviewer` | sonnet | 热点、复杂度优化 |
+| `code-reviewer` | opus | 跨关注点综合审查 |
+
+### 领域专家
+
+| Agent | 模型 | 用途 |
+| ------- | ------ | ------ |
+| `dependency-expert` | sonnet | 外部 SDK/API/包评估 |
+| `test-engineer` | sonnet | 测试策略、覆盖率 |
+| `quality-strategist` | sonnet | 质量策略、发布就绪性 |
+| `build-fixer` | sonnet | 构建/工具链/类型失败 |
+| `designer` | sonnet | UX/UI 架构、交互设计 |
+| `writer` | haiku | 文档、迁移说明 |
+| `qa-tester` | sonnet | 交互式 CLI/服务验证 |
+| `scientist` | sonnet | 数据/统计分析 |
+| `document-specialist` | sonnet | 外部文档查找 |
+| `git-master` | sonnet | 提交策略、历史整洁 |
+| `database-expert` | sonnet | 数据库设计、查询优化和迁移 |
+| `devops-engineer` | sonnet | CI/CD、容器化、基础设施即代码 |
+| `i18n-specialist` | sonnet | 国际化、本地化和多语言支持 |
+| `accessibility-auditor` | sonnet | Web 无障碍审查和 WCAG 合规 |
+| `api-designer` | sonnet | REST/GraphQL API 设计和契约定义 |
+
+### 产品通道
+
+| Agent | 模型 | 用途 |
+| ------- | ------ | ------ |
+| `product-manager` | sonnet | 问题定义、PRD |
+| `ux-researcher` | sonnet | 启发式审计、可用性 |
+| `information-architect` | sonnet | 分类、导航 |
+| `product-analyst` | sonnet | 产品指标、漏斗分析 |
+
+### 协调
+
+| Agent | 模型 | 用途 |
+| ------- | ------ | ------ |
+| `critic` | opus | 计划/设计批判性挑战 |
+| `vision` | sonnet | 图片/截图/图表分析 |
+
+### Axiom Agents
+
+| Agent | 模型 | 用途 |
+| ------- | ------ | ------ |
+| `axiom-requirement-analyst` | sonnet | 需求分析三态门（PASS/CLARIFY/REJECT） |
+| `axiom-product-designer` | sonnet | Draft PRD 生成，含 Mermaid 流程图 |
+| `axiom-review-aggregator` | sonnet | 5 专家并行审查聚合与冲突仲裁 |
+| `axiom-prd-crafter` | sonnet | 工程级 PRD，含门控验证 |
+| `axiom-system-architect` | sonnet | 原子任务 DAG 与 Manifest 生成 |
+| `axiom-evolution-engine` | sonnet | 知识收割、模式检测、工作流优化 |
+| `axiom-context-manager` | sonnet | 7 操作记忆系统（读/写/状态/检查点） |
+| `axiom-worker` | sonnet | PM→Worker 协议，三态输出 |
+| `axiom-ux-director` | sonnet | UX/体验专家评审 |
+| `axiom-product-director` | sonnet | 产品战略专家评审 |
+| `axiom-domain-expert` | sonnet | 领域知识专家评审 |
+| `axiom-tech-lead` | sonnet | 技术可行性评审 |
+| `axiom-critic` | sonnet | 安全/质量/逻辑评审 |
+| `axiom-sub-prd-writer` | sonnet | 将 Manifest 任务拆解为可执行 Sub-PRD |
+
+---
+
+## Skills（70 个）
+
+### 工作流 Skills
+
+| Skill | 触发词 | 用途 |
+| ------- | -------- | ------ |
+| `autopilot` | "autopilot", "build me" | 从想法到可运行代码的全自主执行 |
+| `ralph` | "ralph", "don't stop" | 带 verifier 验证的自引用循环 |
+| `ultrawork` | "ulw", "ultrawork" | 并行 agent 编排最大并行度 |
+| `team` | "team", "coordinated team" | N 个协调 agents，阶段感知路由 |
+| `ultrapilot` | "ultrapilot", "parallel build" | 带文件所有权分区的并行 autopilot |
+| `pipeline` | "pipeline", "chain agents" | 带数据传递的顺序 agent 链 |
+| `ultraqa` | 由 autopilot 激活 | QA 循环：测试、验证、修复、重复 |
+| `plan` | "plan this", "plan the" | 战略规划，支持 `--consensus`/`--review` |
+| `ralplan` | "ralplan", "consensus plan" | 与 Planner/Architect/Critic 迭代规划 |
+| `swarm` | "swarm" | Team 的兼容性外观 |
+
+### 开发工作流 Skills
+
+| Skill | 用途 |
+| ------- | ------ |
+| `brainstorming` | 设计对话，代码前必须先设计 |
+| `writing-plans` | 详细实现计划，原子任务 |
+| `executing-plans` | 带检查点的批量执行 |
+| `subagent-driven-development` | 每任务独立 subagent + 两阶段审查 |
+| `test-driven-development` | RED-GREEN-REFACTOR 循环 |
+| `systematic-debugging` | 4 阶段根因分析 |
+| `verification-before-completion` | 完成前验证 |
+| `requesting-code-review` | 代码审查前检查清单 |
+| `receiving-code-review` | 响应审查反馈 |
+| `using-git-worktrees` | 并行开发分支 |
+| `finishing-a-development-branch` | 合并/PR 决策工作流 |
+| `next-step-router` | 关键节点推荐最优下一步 |
+
+### Axiom Skills
+
+| Skill | 用途 |
+| ------- | ------ |
+| `ax-draft` | 需求澄清 → Draft PRD → 用户确认 |
+| `ax-review` | 5 专家并行评审 → 聚合 → Rough PRD |
+| `ax-decompose` | Rough PRD → 系统架构 → 原子任务 DAG |
+| `ax-implement` | 按 Manifest 执行任务，CI 门禁，自动修复 |
+| `ax-analyze-error` | 根因诊断 → 自动修复 → 知识队列 |
+| `ax-reflect` | 会话反思 → 经验提取 → Action Items |
+| `ax-evolve` | 处理学习队列 → 更新知识库 → 模式检测 |
+| `ax-status` | 完整系统状态仪表盘 |
+| `ax-rollback` | 回滚到最近检查点（需用户确认） |
+| `ax-suspend` | 保存会话状态，安全退出 |
+| `ax-context` | 直接操作 Axiom 记忆系统 |
+| `ax-evolution` | 进化引擎统一入口（evolve/reflect/knowledge/patterns） |
+| `ax-knowledge` | 查询 Axiom 知识库 |
+| `ax-export` | 导出 Axiom 工作流产物 |
+
+### 增强 Skills
+
+| Skill | 用途 |
+| ------- | ------ |
+| `deepinit` | 分层 AGENTS.md 代码库文档化 |
+| `deepsearch` | 多策略深度代码库搜索 |
+| `analyze` | 深度分析与调查（debugger 别名） |
+| `sciomc` | 并行 scientist 编排 |
+| `external-context` | 并行 document-specialist 网络搜索 |
+| `ccg` | Claude-Codex-Gemini 三模型并行编排 |
+| `frontend-ui-ux` | UI/UX 专业能力（静默激活） |
+| `git-master` | Git 专家，原子提交和历史管理（静默激活） |
+| `build-fix` | 修复构建和 TypeScript 错误 |
+| `code-review` | 全面代码审查 |
+| `security-review` | 安全漏洞检测 |
+| `trace` | 显示 agent 流程追踪时间线 |
+| `learn-about-omc` | 了解 OMC 使用模式并获取建议 |
+| `dispatching-parallel-agents` | 并行分发独立任务给多个 agents |
+
+### 工具类 Skills
+
+| Skill | 用途 |
+| ------- | ------ |
+| `cancel` | 统一取消所有执行模式 |
+| `note` | 保存笔记到抗压缩 notepad |
+| `learner` | 从会话中提取可复用 skill |
+| `omc-setup` | 一次性安装向导 |
+| `mcp-setup` | 配置 MCP 服务器 |
+| `hud` | 配置 HUD 状态栏 |
+| `omc-doctor` | 诊断并修复安装问题 |
+| `omc-help` | 显示 OMC 使用指南 |
+| `release` | 自动化发布工作流 |
+| `ralph-init` | 初始化 PRD 以进行结构化任务跟踪 |
+| `review` | 用 critic 审查工作计划 |
+| `writer-memory` | 面向写作者的 agent 记忆系统 |
+| `project-session-manager` | 管理隔离开发环境（git worktrees + tmux） |
+| `psm` | project-session-manager 别名 |
+| `skill` | 管理本地 skills（列出、添加、删除、搜索、编辑） |
+| `wizard` | 交互式配置向导 |
+| `writing-skills` | 创建/编辑/验证 skills |
+| `configure-discord` | 配置 Discord webhook/bot 通知 |
+| `configure-telegram` | 配置 Telegram bot 通知 |
+| `using-superpowers` | 建立 skill 使用规则 |
+
+---
+
+## 执行模式
+
+### Team 流水线（默认多 Agent 编排器）
+
+```
+team-plan → team-prd → team-exec → team-verify → team-fix（循环）
+```
+
+* **team-plan**：`explore` + `planner`，可选 `analyst`/`architect`
+
+* **team-prd**：`analyst`，可选 `product-manager`/`critic`
+
+* **team-exec**：`executor` + 任务适配专家
+
+* **team-verify**：`verifier` + 按需审查 agents
+
+* **team-fix**：根据缺陷类型路由到 `executor`/`build-fixer`/`debugger`
+
+### MCP 路由
+
+对只读分析任务优先使用 MCP 工具（更快更经济）：
+
+* **Codex**（`mcp__x__ask_codex`）：架构审查、规划验证、代码审查
+
+* **Gemini**（`mcp__g__ask_gemini`）：UI/UX 设计、大上下文任务（1M tokens）
+
+### Axiom 代码智能
+
+* **LSP**：hover、goto definition、find references、diagnostics、rename
+
+* **AST**：`ast_grep_search`（结构化模式搜索）、`ast_grep_replace`（结构化转换）
+
+* **Python REPL**：持久数据分析环境
+
+---
+
+## Axiom 自我进化系统
+
+ultrapower 内置 Axiom 自我进化引擎，让 AI 工作流随使用不断优化。
+
+### 核心机制
+
+| 机制 | 说明 |
+| ------ | ------ |
+| 知识收割 | 每次任务完成后自动提取经验教训，存入知识库 |
+| 模式检测 | 识别重复代码模式，达到阈值（出现 ≥3 次）后提升为最佳实践 |
+| 工作流优化 | 分析执行指标，发现瓶颈并生成优化建议 |
+| 跨会话记忆 | 知识库和模式库跨会话持久化，越用越聪明 |
+
+### 快速开始
+
+```bash
+
+# 1. 安装插件
+
+/plugin marketplace add <<https://github.com/liangjie559567/ultrapower>>
+/plugin install omc@ultrapower
+
+# 2. 初始化 Axiom 系统
+
+/ultrapower:ax-context init
+
+# 3. 查看系统状态
+
+/ax-status
+```
+
+### 进化工作流
+
+```
+需求 → /ax-draft → /ax-review → /ax-decompose → /ax-implement
+                                                      ↓
+                                                 任务完成
+                                                      ↓
+                                             /ax-reflect（反思）
+                                                      ↓
+                                             /ax-evolve（进化）
+                                                      ↓
+                                        知识库更新 + 模式库更新
+```
+
+详细文档请参阅 [docs/EVOLUTION.md](docs/EVOLUTION.md)。
+
+---
+
+## MCP 服务器
+
+ultrapower 提供完整的 MCP（Model Context Protocol）服务器，暴露 35 个自定义工具供 Claude Desktop 和 Cursor 使用。
+
+### 快速开始
+
+```bash
+
+# 启动 MCP 服务器
+
+node bridge/mcp-server.cjs
+
+# 或使用 npm
+
+npm run mcp:start
+```
+
+### 配置 Claude Desktop
+
+编辑 `~/.claude/claude_desktop_config.json`：
+
+```json
+{
+  "mcpServers": {
+    "ultrapower": {
+      "command": "node",
+      "args": ["/path/to/ultrapower/bridge/mcp-server.cjs"],
+      "env": {
+        "OMC_LOG_LEVEL": "info"
+      }
+    }
+  }
+}
+```
+
+### 配置 Cursor
+
+在项目根目录创建 `.cursor/mcp.json`：
+
+```json
+{
+  "mcpServers": {
+    "ultrapower": {
+      "command": "node",
+      "args": ["/path/to/ultrapower/bridge/mcp-server.cjs"],
+      "env": {
+        "OMC_LOG_LEVEL": "info"
+      }
+    }
+  }
+}
+```
+
+### 可用工具（35 个）
+
+* **LSP 工具（12 个）**：代码导航、诊断、重构
+
+* **AST 工具（2 个）**：结构化模式匹配和替换
+
+* **Python REPL（1 个）**：持久数据分析环境
+
+* **Notepad 工具（6 个）**：会话记忆管理
+
+* **State 工具（5 个）**：模式状态管理
+
+* **Project Memory 工具（4 个）**：项目级持久记忆
+
+* **Trace 工具（2 个）**：Agent 流程追踪分析
+
+* **Skills 工具（3 个）**：Skill 加载和管理
+
+详见 [docs/guides/mcp-server-usage.md](docs/guides/mcp-server-usage.md)。
+
+---
+
+## 哲学
+
+* **测试驱动开发** — 始终先写测试
+
+* **系统化而非临时** — 流程优于猜测
+
+* **复杂度降低** — 简洁是首要目标
+
+* **证据优于声明** — 声明成功前先验证
+
+---
+
+## 赞助
+
+如果 ultrapower 帮助你完成了有价值的工作，欢迎[赞助开源工作](https://github.com/sponsors/liangjie559567)。
+
+## 贡献
+
+Skills 直接存放在本仓库中。贡献方式：
+
+1. Fork 仓库
+2. 为你的 skill 创建分支
+3. 遵循 `writing-skills` skill 创建和测试新 skill
+4. 提交 PR
+
+详见 `skills/writing-skills/SKILL.md`。
+
+## 更新
+
+```bash
+/plugin update omc@ultrapower
+```
+
+## 许可证
+
+MIT License — 详见 LICENSE 文件
+
+## 支持
+
+* **Issues**: <<https://github.com/liangjie559567/ultrapower/issues>>
+
+* **Marketplace**: <<https://github.com/liangjie559567/ultrapower>>
+
+* **安装部署教程**: [docs/INSTALL.md](docs/INSTALL.md)
+
+* **完整参考文档**: [docs/REFERENCE.md](docs/REFERENCE.md)
+
+* **进化系统文档**: [docs/EVOLUTION.md](docs/EVOLUTION.md)
+
+* **主动进化系统**: [docs/NEXUS.md](docs/NEXUS.md)
+
+* **迁移指南**: [docs/MIGRATION.md](docs/MIGRATION.md)