@liangjie559567/ultrapower 5.6.6 → 5.6.8

package/docs/FEATURES.md

@@ -34,7 +34,7 @@ notepad_read(section?: 'all' | 'priority' | 'working' | 'manual'): string
 ```
 
 | 章节 | 描述 |
-|------|------|
+| ------ | ------ |
 | `all` | 读取全部内容（默认） |
 | `priority` | 仅读取优先上下文（会话启动时自动加载） |
 | `working` | 读取工作记忆（带时间戳，7 天后自动清理） |
@@ -100,14 +100,18 @@ notepad_stats(): {
 
 ```markdown
 <!-- .omc/notepad.md -->
+
 ## priority
+
 [最多 500 字符的优先上下文]
 
 ## working
+
 <!-- ts: 2026-03-02T10:00:00Z -->
 [工作记忆条目]
 
 ## manual
+
 [永久手动记录]
 ```
 
@@ -168,7 +172,7 @@ state_get_status(mode?: ExecutionMode): StatusSummary | Record<ExecutionMode, St
 ### 支持的执行模式
 
 | 模式 | 状态文件路径 | 描述 |
-|------|------------|------|
+| ------ | ------------ | ------ |
 | `autopilot` | `.omc/state/autopilot-state.json` | 全自主执行状态 |
 | `ultrapilot` | `.omc/state/ultrapilot-state.json` | 并行 autopilot 状态 |
 | `team` | `.omc/state/team-state.json` | 团队协调状态 |
@@ -219,7 +223,7 @@ project_memory_read(section?: MemorySection): ProjectMemory | SectionData
 ```
 
 | 章节 | 描述 |
-|------|------|
+| ------ | ------ |
 | `techStack` | 技术栈信息（语言、框架、工具版本） |
 | `build` | 构建命令和配置 |
 | `conventions` | 代码规范和命名约定 |
@@ -308,7 +312,7 @@ ultrapower 通过 Language Server Protocol、AST-grep 和 Python REPL 提供类
 通过语言服务器协议实现跨语言代码分析。
 
 | 工具 | 描述 |
-|------|------|
+| ------ | ------ |
 | `lsp_hover` | 获取光标位置的类型信息和文档注释 |
 | `lsp_goto_definition` | 跳转到符号的定义位置 |
 | `lsp_find_references` | 查找符号在整个代码库中的所有引用 |
@@ -364,9 +368,11 @@ ast_grep_search(pattern: string, language: SupportedLanguage, path?: string): Ma
 
 **元变量语法：**
 
-- `$NAME`：匹配单个语法节点（标识符、表达式等）
-- `$$$ARGS`：匹配多个节点（函数参数列表等）
-- `$_`：匹配任意节点（不捕获）
+* `$NAME`：匹配单个语法节点（标识符、表达式等）
+
+* `$$$ARGS`：匹配多个节点（函数参数列表等）
+
+* `$_`：匹配任意节点（不捕获）
 
 **示例：**
 
@@ -417,10 +423,14 @@ python_repl(code: string): { stdout: string; stderr: string; result: any }
 **内置可用库：** `pandas`、`numpy`、`matplotlib`、`json`、`os`、`sys`、`re`
 
 **适用场景：**
-- CSV/JSON 数据分析
-- 统计计算
-- 文件内容转换
-- 快速原型验证
+
+* CSV/JSON 数据分析
+
+* 统计计算
+
+* 文件内容转换
+
+* 快速原型验证
 
 ### 工具禁用
 
@@ -458,7 +468,7 @@ async function processPreToolUse(input: ToolInput): Promise<ToolInput> {
 ### 模型路由规则
 
 | Agent 类型 | 自动注入模型 | 说明 |
-|-----------|------------|------|
+| ----------- | ------------ | ------ |
 | `explore` | `haiku` | 代码库发现，轻量扫描 |
 | `style-reviewer` | `haiku` | 格式检查，低复杂度 |
 | `writer` | `haiku` | 文档生成，简单任务 |
@@ -517,7 +527,7 @@ ultrapower 深度融合 Axiom 智能体编排框架，提供从需求起草到
 #### 需求与设计通道（5 个）
 
 | Agent | 模型 | 职责 |
-|-------|------|------|
+| ------- | ------ | ------ |
 | `axiom-requirement-analyst` | sonnet | 需求三态门：PASS（直接进入 PRD）/ CLARIFY（提问澄清）/ REJECT（拒绝） |
 | `axiom-product-designer` | sonnet | 生成 Draft PRD，含 Mermaid 流程图和用户旅程 |
 | `axiom-review-aggregator` | sonnet | 聚合 5 个专家并行评审结果，执行冲突仲裁 |
@@ -527,7 +537,7 @@ ultrapower 深度融合 Axiom 智能体编排框架，提供从需求起草到
 #### 进化与记忆通道（3 个）
 
 | Agent | 模型 | 职责 |
-|-------|------|------|
+| ------- | ------ | ------ |
 | `axiom-evolution-engine` | sonnet | 知识收割、模式检测（出现 ≥3 次提升）、工作流优化 |
 | `axiom-context-manager` | sonnet | 7 种记忆操作：读/写/状态/检查点/恢复/清除/压缩 |
 | `axiom-worker` | sonnet | 接收 PM 分配的原子任务，输出三态结果 |
@@ -535,7 +545,7 @@ ultrapower 深度融合 Axiom 智能体编排框架，提供从需求起草到
 #### 评审专家通道（5 个）
 
 | Agent | 模型 | 职责 | 输出文件 |
-|-------|------|------|---------|
+| ------- | ------ | ------ | --------- |
 | `axiom-ux-director` | sonnet | UX/体验专家评审 | `review_ux.md` |
 | `axiom-product-director` | sonnet | 产品战略专家评审 | `review_product.md` |
 | `axiom-domain-expert` | sonnet | 领域知识专家评审 | `review_domain.md` |
@@ -545,7 +555,7 @@ ultrapower 深度融合 Axiom 智能体编排框架，提供从需求起草到
 #### 任务拆解通道（1 个）
 
 | Agent | 模型 | 职责 |
-|-------|------|------|
+| ------- | ------ | ------ |
 | `axiom-sub-prd-writer` | sonnet | 将 Manifest 任务拆解为可执行的 Sub-PRD 文件 |
 
 ### Axiom Worker 规范
@@ -553,20 +563,26 @@ ultrapower 深度融合 Axiom 智能体编排框架，提供从需求起草到
 Worker agent 采用 PM→Worker 协议，执行原子任务后输出三种格式之一：
 
 ```markdown
+
 ## QUESTION
+
 问题: [具体需要澄清的内容]
 原因: [为什么需要这个信息才能继续]
 ```
 
 ```markdown
+
 ## COMPLETE
+
 完成: [任务描述]
 变更: [修改的文件列表]
 验证: [CI 命令输出，例如 tsc --noEmit 结果]
 ```
 
 ```markdown
+
 ## BLOCKED
+
 原因: [阻塞原因详述]
 已尝试: [已经尝试过的方法，最多 3 次]
 需要: [需要什么外部帮助]
@@ -579,7 +595,7 @@ Worker agent 采用 PM→Worker 协议，执行原子任务后输出三种格式
 #### 核心工作流 Skills
 
 | Skill | 命令 | 用途 |
-|-------|------|------|
+| ------- | ------ | ------ |
 | `ax-draft` | `/ax-draft` | 需求澄清 → Draft PRD → 用户确认（触发 User Gate） |
 | `ax-review` | `/ax-review` | 5 专家并行评审 → 聚合仲裁 → Rough PRD |
 | `ax-decompose` | `/ax-decompose` | Rough PRD → 系统架构设计 → 原子任务 DAG |
@@ -589,7 +605,7 @@ Worker agent 采用 PM→Worker 协议，执行原子任务后输出三种格式
 #### 进化与管理 Skills
 
 | Skill | 命令 | 用途 |
-|-------|------|------|
+| ------- | ------ | ------ |
 | `ax-reflect` | `/ax-reflect` | 会话反思 → 经验提取 → Action Items |
 | `ax-evolve` | `/ax-evolve` | 处理学习队列 → 更新知识库 → 模式检测 |
 | `ax-rollback` | `/ax-rollback` | 回滚到最近检查点（需用户明确确认） |
@@ -599,7 +615,7 @@ Worker agent 采用 PM→Worker 协议，执行原子任务后输出三种格式
 #### 高级工具 Skills
 
 | Skill | 命令 | 用途 |
-|-------|------|------|
+| ------- | ------ | ------ |
 | `ax-context` | `/ax-context` | 直接操作 Axiom 记忆系统（读/写/状态/检查点） |
 | `ax-evolution` | `/ax-evolution [subcommand]` | 进化引擎统一入口（evolve/reflect/knowledge/patterns） |
 | `ax-knowledge` | `/ax-knowledge [query]` | 语义查询 Axiom 知识库 |
@@ -614,11 +630,16 @@ Worker agent 采用 PM→Worker 协议，执行原子任务后输出三种格式
 **触发时机：** 会话启动时（PreToolUse，首次工具调用前）
 
 **功能：**
-- 检测 `.omc/axiom/` 目录是否存在
-- 读取 `active_context.md` 恢复当前任务状态
-- 读取 `project_decisions.md` 加载架构约束
-- 读取 `user_preferences.md` 加载用户偏好
-- 根据状态决定行为：
+
+* 检测 `.omc/axiom/` 目录是否存在
+
+* 读取 `active_context.md` 恢复当前任务状态
+
+* 读取 `project_decisions.md` 加载架构约束
+
+* 读取 `user_preferences.md` 加载用户偏好
+
+* 根据状态决定行为：
   - `IDLE`：系统就绪，等待指令
   - `EXECUTING`：检测到中断任务，询问用户是否继续
   - `BLOCKED`：上次任务遇到问题，提示需要人工介入
@@ -632,7 +653,7 @@ Worker agent 采用 PM→Worker 协议，执行原子任务后输出三种格式
 **门禁规则：**
 
 | 门禁 | 触发条件 | 强制动作 |
-|------|---------|---------|
+| ------ | --------- | --------- |
 | Expert Gate | 所有新功能需求 | 必须经过 `/ax-draft` → `/ax-review` 流程 |
 | User Gate | PRD 终稿生成完成 | 必须显示确认提示，等待用户 Yes/No |
 | CI Gate | 代码修改完成 | 必须执行 `tsc --noEmit && npm run build && npm test` |
@@ -661,7 +682,7 @@ IDLE → PLANNING → CONFIRMING → EXECUTING → AUTO_FIX → BLOCKED → ARCH
 ```
 
 | 状态 | 描述 | 可转换到 |
-|------|------|---------|
+| ------ | ------ | --------- |
 | `IDLE` | 系统就绪，等待指令 | `PLANNING` |
 | `PLANNING` | 正在生成 PRD 或任务计划 | `CONFIRMING`, `IDLE` |
 | `CONFIRMING` | 等待用户确认 PRD | `EXECUTING`, `PLANNING` |
@@ -673,7 +694,7 @@ IDLE → PLANNING → CONFIRMING → EXECUTING → AUTO_FIX → BLOCKED → ARCH
 ### 进化引擎自动行为
 
 | 触发事件 | 自动行为 |
-|---------|---------|
+| --------- | --------- |
 | 任务完成 | 将代码变更加入 `learning_queue.md` |
 | 错误修复成功 | 将修复模式加入学习队列（P1 优先级） |
 | 工作流完成 | 更新 `workflow_metrics.md` |
@@ -685,7 +706,7 @@ IDLE → PLANNING → CONFIRMING → EXECUTING → AUTO_FIX → BLOCKED → ARCH
 Axiom 配置可跨多个 AI 工具复用：
 
 | 适配器文件 | 目标工具 |
-|-----------|---------|
+| ----------- | --------- |
 | `.kiro/steering/axiom.md` | Kiro |
 | `.cursorrules` | Cursor |
 | `.gemini/GEMINI.md` | Gemini |
@@ -762,16 +783,24 @@ interface AutopilotConfig {
 **描述：** 最大并行度的 agent 编排，适用于可并行分解的大型任务。
 
 **核心机制：**
-- 将任务分解为独立子任务，最大化并行执行
-- 使用 `run_in_background: true` 实现非阻塞并发（最多 20 个并发）
-- 子任务完成后自动聚合结果
-- 冲突检测：避免多个 agent 同时修改同一文件
+
+* 将任务分解为独立子任务，最大化并行执行
+
+* 使用 `run_in_background: true` 实现非阻塞并发（最多 20 个并发）
+
+* 子任务完成后自动聚合结果
+
+* 冲突检测：避免多个 agent 同时修改同一文件
 
 **适用场景：**
-- 多模块重构（每个模块由独立 executor 处理）
-- 批量文件转换
-- 并行测试生成
-- 多服务代码审查
+
+* 多模块重构（每个模块由独立 executor 处理）
+
+* 批量文件转换
+
+* 并行测试生成
+
+* 多服务代码审查
 
 ---
 
@@ -821,10 +850,14 @@ verifier 评估
 **描述：** Team 的兼容性外观，保留 `/swarm` 语法，路由到 Team 分阶段流水线。
 
 **任务协调机制：**
-- 使用 `better-sqlite3` 实现 SQLite 任务认领
-- N 个并发 executor 竞争认领任务队列中的任务
-- 通过数据库锁防止重复执行
-- 每个 executor 独立处理已认领任务
+
+* 使用 `better-sqlite3` 实现 SQLite 任务认领
+
+* N 个并发 executor 竞争认领任务队列中的任务
+
+* 通过数据库锁防止重复执行
+
+* 每个 executor 独立处理已认领任务
 
 **适用场景：** 大量同质化任务（如批量代码审查、批量测试生成）。
 
@@ -856,7 +889,7 @@ interface PipelineStage {
 ### 模式优先级与冲突解决
 
 | 情况 | 行为 |
-|------|------|
+| ------ | ------ |
 | 同时检测到 `ulw` 和 `ultrawork` | 显式模式关键词覆盖通用词 |
 | 通用词 "fast"/"parallel" | 读取 `~/.claude/.omc-config.json` → `defaultExecutionMode` |
 | `team` + `ralph` 同时触发 | 两者都激活，状态文件相互关联 |
@@ -872,7 +905,7 @@ team-plan → team-prd → team-exec → team-verify → team-fix（循环）
 ```
 
 | 阶段 | 主要 Agent | 可选 Agent |
-|------|-----------|-----------|
+| ------ | ----------- | ----------- |
 | `team-plan` | explore (haiku) + planner (opus) | analyst, architect |
 | `team-prd` | analyst (opus) | product-manager, critic |
 | `team-exec` | executor (sonnet) | designer, build-fixer, writer, test-engineer, deep-executor |
@@ -890,7 +923,7 @@ ultrapower 通过 hooks 在工具调用的生命周期各节点插入自定义
 hooks 监听以下 15 类事件：
 
 | 事件 | 时机 | 常见用途 |
-|------|------|---------|
+| ------ | ------ | --------- |
 | `PreToolUse` | 工具调用前 | 输入验证、模型注入、门禁检查 |
 | `PostToolUse` | 工具调用后 | 结果记录、状态更新、学习触发 |
 | `SessionStart` | 会话启动 | 记忆加载、上下文恢复 |
@@ -957,7 +990,7 @@ OMC_SKIP_HOOKS=axiom-boot,ralph     # 按名称跳过特定 hooks
 ### 关键 Hook 列表
 
 | Hook | 位置 | 功能 |
-|------|------|------|
+| ------ | ------ | ------ |
 | `autopilot` | `src/hooks/autopilot/` | 全自主执行阶段管理 |
 | `ralph` | `src/hooks/ralph/` | 持续执行循环控制 |
 | `ultrawork` | `src/hooks/ultrawork/` | 并行执行协调 |
@@ -1060,7 +1093,7 @@ const uri = pathToFileURL(filePath).toString();
 ### v5.5.x 其他改进
 
 | 版本 | 改进项 |
-|------|-------|
+| ------ | ------- |
 | v5.5.1 | PowerShell 默认 shell 检测 |
 | v5.5.1 | Windows 行尾符（CRLF）处理 |
 | v5.5.2 | 文件路径比较使用 `path.normalize()` 确保一致性 |
@@ -1090,7 +1123,7 @@ ultrapower 通过 MCP（Model Context Protocol）集成外部 AI 提供商，实
 ### 提供商概览
 
 | 提供商 | 工具前缀 | 模型 | 特长 |
-|--------|---------|------|------|
+| -------- | --------- | ------ | ------ |
 | Codex (GPT) | `mcp__x__ask_codex` | gpt-5.3-codex | 代码分析、架构审查、批判性分析 |
 | Gemini | `mcp__g__ask_gemini` | gemini-3-pro-preview | 大上下文（1M token）、UI/UX、视觉分析 |
 
@@ -1116,7 +1149,7 @@ ToolSearch("ask_gemini")  // 发现 Gemini 工具
 **最适合角色：**
 
 | 角色 | 适用场景 |
-|------|---------|
+| ------ | --------- |
 | `architect` | 系统设计评审、接口设计建议 |
 | `planner` | 执行计划验证、任务排序 |
 | `critic` | 批判性分析、计划缺陷发现 |
@@ -1142,7 +1175,7 @@ mcp__x__ask_codex({
 **最适合角色：**
 
 | 角色 | 适用场景 |
-|------|---------|
+| ------ | --------- |
 | `designer` | UI/UX 设计审查、组件设计建议 |
 | `writer` | 文档生成、迁移指南、用户手册 |
 | `vision` | 截图分析、图表解读、UI 元素识别 |
@@ -1182,7 +1215,7 @@ const result = await wait_for_job(jobId)
 ### 路由决策准则
 
 | 任务类型 | 推荐路由 | 原因 |
-|---------|---------|------|
+| --------- | --------- | ------ |
 | 架构审查 | Codex (`architect`) | 代码分析能力强 |
 | 规划验证 | Codex (`planner`) | 批判性分析准确 |
 | 安全审查 | Codex (`security-reviewer`) | 漏洞识别专项优化 |
@@ -1196,23 +1229,32 @@ const result = await wait_for_job(jobId)
 
 以下 agents 需要 Claude 的工具访问权限，无法通过 MCP 提供商替代：
 
-- `executor`、`deep-executor`：需要文件编辑工具
-- `explore`：需要 Glob/Grep/Read 工具
-- `debugger`、`verifier`：需要运行构建和测试命令
-- `dependency-expert`：需要联网工具
-- `scientist`：需要 Python REPL 工具
-- `build-fixer`：需要文件编辑和构建工具
-- `qa-tester`：需要进程启动工具
-- `git-master`：需要 git 命令执行
-- 所有审查通道 agents（review lane）
-- 所有产品通道 agents（product lane）
+* `executor`、`deep-executor`：需要文件编辑工具
+
+* `explore`：需要 Glob/Grep/Read 工具
+
+* `debugger`、`verifier`：需要运行构建和测试命令
+
+* `dependency-expert`：需要联网工具
+
+* `scientist`：需要 Python REPL 工具
+
+* `build-fixer`：需要文件编辑和构建工具
+
+* `qa-tester`：需要进程启动工具
+
+* `git-master`：需要 git 命令执行
+
+* 所有审查通道 agents（review lane）
+
+* 所有产品通道 agents（product lane）
 
 ### 本地 MCP 工具
 
 通过 `claude mcp add` 配置的本地工具，无需 API key：
 
 | 工具 | 适用场景 |
-|------|---------|
+| ------ | --------- |
 | `sequential-thinking` | 架构决策分析、根因排查、多步骤规划 |
 | `software-planning-tool` | 需求拆解、sprint 规划、技术方案评估 |
 
@@ -1220,19 +1262,28 @@ const result = await wait_for_job(jobId)
 
 MCP 输出被包装为不可信内容，应用以下约束：
 
-- `prompt_file` 和 `output_file` 路径相对于 `working_directory` 解析
-- 受 `OMC_MCP_OUTPUT_PATH_POLICY` 控制：`strict`（默认）或 `redirect_output`
-- MCP 输出是建议性的，验证（测试、类型检查）必须由 Claude agent 执行
-- 未配置的 MCP 服务器静默失败，回退到等效 Claude agent
+* `prompt_file` 和 `output_file` 路径相对于 `working_directory` 解析
+
+* 受 `OMC_MCP_OUTPUT_PATH_POLICY` 控制：`strict`（默认）或 `redirect_output`
+
+* MCP 输出是建议性的，验证（测试、类型检查）必须由 Claude agent 执行
+
+* 未配置的 MCP 服务器静默失败，回退到等效 Claude agent
 
 ---
 
 ## 参见
 
-- [CHANGELOG.md](../CHANGELOG.md) — 版本历史和发布说明
-- [ARCHITECTURE.md](./ARCHITECTURE.md) — 系统架构设计
-- [REFERENCE.md](./REFERENCE.md) — 完整 API 参考（agents/skills/hooks 列表）
-- [MIGRATION.md](./MIGRATION.md) — 版本迁移指南
-- [COMPATIBILITY.md](./COMPATIBILITY.md) — 兼容性要求
-- [Agent Definitions](../src/agents/definitions.ts) — Agent 规范配置
-- [Hook Bridge](../src/hooks/bridge.ts) — Delegation Enforcer 实现
+* [CHANGELOG.md](../CHANGELOG.md) — 版本历史和发布说明
+
+* [ARCHITECTURE.md](./ARCHITECTURE.md) — 系统架构设计
+
+* [REFERENCE.md](./REFERENCE.md) — 完整 API 参考（agents/skills/hooks 列表）
+
+* [MIGRATION.md](./MIGRATION.md) — 版本迁移指南
+
+* [COMPATIBILITY.md](./COMPATIBILITY.md) — 兼容性要求
+
+* [Agent Definitions](../src/agents/definitions.ts) — Agent 规范配置
+
+* [Hook Bridge](../src/hooks/bridge.ts) — Delegation Enforcer 实现