@liangjie559567/ultrapower 5.0.4

package/docs/plans/axiom-migration-plan.md

@@ -0,0 +1,319 @@
+# Axiom → ultrapower 深度融合迁移计划
+
+> 日期：2026-02-24 | 状态：待执行 | 策略：深度融合
+
+## 一、迁移总览
+
+### 目标
+将 Axiom 的全部核心能力（记忆系统、工作流系统、门禁系统、进化引擎、9个适配器）深度融合到 ultrapower 架构中，形成统一的增强型多 Agent 编排系统。
+
+### 架构映射关系
+
+```
+Axiom 组件                    → ultrapower 融合目标
+─────────────────────────────────────────────────────────────
+.agent/config/agent_config.md → .omc/axiom-config.md (Provider 路由配置)
+.agent/adapters/              → .claude/ + AGENTS.md (适配器文件)
+.agent/memory/active_context  → .omc/state/axiom-context.json (StateManager)
+.agent/memory/project_decisions → .omc/project-memory.json (project_memory)
+.agent/memory/evolution/      → .omc/axiom-evolution/ (进化引擎数据)
+.agent/workflows/1-drafting   → skills/axiom-draft/SKILL.md
+.agent/workflows/2-reviewing  → skills/axiom-review/SKILL.md
+.agent/workflows/3-decomposing → skills/axiom-decompose/SKILL.md
+.agent/workflows/4-implementing → skills/axiom-implement/SKILL.md
+.agent/workflows/analyze-error → skills/axiom-analyze-error/SKILL.md
+.agent/workflows/reflect      → skills/axiom-reflect/SKILL.md
+.agent/workflows/evolve       → skills/axiom-evolve/SKILL.md
+.agent/workflows/start        → src/hooks/axiom-boot/index.ts
+.agent/workflows/status       → skills/axiom-status/SKILL.md
+.agent/workflows/rollback     → skills/axiom-rollback/SKILL.md
+.agent/workflows/suspend      → skills/axiom-suspend/SKILL.md
+.agent/guards/                → src/hooks/axiom-guards/index.ts
+.agent/skills/context-manager → skills/axiom-context/SKILL.md + agents/axiom-context-manager.md
+.agent/skills/evolution-engine → skills/axiom-evolution/SKILL.md + agents/axiom-evolution-engine.md
+.agent/skills/requirement-analyst → agents/axiom-requirement-analyst.md
+.agent/skills/product-design-expert → agents/axiom-product-designer.md
+.agent/skills/review-aggregator → agents/axiom-review-aggregator.md
+.agent/skills/system-architect → agents/axiom-system-architect.md
+.agent/skills/prd-crafter-lite → agents/axiom-prd-crafter.md
+AGENTS.md (Worker 规范)       → agents/axiom-worker.md
+```
+
+---
+
+## 二、分阶段实施计划
+
+### Phase 1：基础设施层（无 TypeScript 改动）
+
+**目标**：建立 Axiom 的文件结构骨架，零代码改动即可运行基础功能。
+
+#### Task 1.1 — 创建 Axiom Agent 定义文件（7个）
+
+在 `agents/` 目录创建以下文件，遵循 ultrapower 的 YAML frontmatter + `<Agent_Prompt>` XML 格式：
+
+- `agents/axiom-requirement-analyst.md` — 需求分析师（PASS/CLARIFY/REJECT 三态门禁）
+- `agents/axiom-product-designer.md` — 产品设计专家（Draft PRD + Mermaid 流程图）
+- `agents/axiom-review-aggregator.md` — 评审聚合器（5专家并行 + 冲突仲裁）
+- `agents/axiom-system-architect.md` — 系统架构师（DAG + Manifest 生成）
+- `agents/axiom-prd-crafter.md` — PRD 工程师（工程级 PRD + 架构合规检查）
+- `agents/axiom-context-manager.md` — 上下文管理器（7个操作 + 状态机）
+- `agents/axiom-evolution-engine.md` — 进化引擎（知识收割 + 模式检测 + 反思）
+- `agents/axiom-worker.md` — Worker Agent（PM→Worker 协作规范）
+
+#### Task 1.2 — 创建 Axiom Skill 文件（12个）
+
+在 `skills/` 目录创建以下 SKILL.md 文件：
+
+- `skills/axiom-draft/SKILL.md` — `/axiom-draft` 需求起草工作流
+- `skills/axiom-review/SKILL.md` — `/axiom-review` 专家评审工作流
+- `skills/axiom-decompose/SKILL.md` — `/axiom-decompose` 任务拆解工作流
+- `skills/axiom-implement/SKILL.md` — `/axiom-implement` 实施交付工作流
+- `skills/axiom-analyze-error/SKILL.md` — `/axiom-analyze-error` 错误分析工作流
+- `skills/axiom-reflect/SKILL.md` — `/axiom-reflect` 反思工作流
+- `skills/axiom-evolve/SKILL.md` — `/axiom-evolve` 进化工作流
+- `skills/axiom-status/SKILL.md` — `/axiom-status` 状态仪表盘
+- `skills/axiom-rollback/SKILL.md` — `/axiom-rollback` 回滚工作流
+- `skills/axiom-suspend/SKILL.md` — `/axiom-suspend` 暂停保存工作流
+- `skills/axiom-context/SKILL.md` — `/axiom-context` 上下文管理
+- `skills/axiom-evolution/SKILL.md` — `/axiom-evolution` 进化引擎触发
+
+#### Task 1.3 — 创建记忆系统目录结构
+
+```
+.omc/axiom/
+├── active_context.md          ← 当前任务状态（短期记忆）
+├── project_decisions.md       ← 架构决策记录（长期记忆）
+├── user_preferences.md        ← 用户偏好
+├── state_machine.md           ← 状态机定义
+├── reflection_log.md          ← 反思日志
+└── evolution/
+    ├── knowledge_base.md      ← 知识图谱索引
+    ├── pattern_library.md     ← 代码模式库
+    ├── learning_queue.md      ← 待处理学习素材
+    └── workflow_metrics.md    ← 工作流执行指标
+```
+
+#### Task 1.4 — 迁移 9 个适配器文件
+
+将 Axiom 适配器迁移到 ultrapower 对应位置：
+
+| Axiom 源文件 | ultrapower 目标位置 |
+|-------------|-------------------|
+| `adapters/claude-code/CLAUDE-CODE.md` | 合并到项目 `CLAUDE.md` |
+| `adapters/kiro/KIRO.md` | `.kiro/steering/axiom.md` |
+| `adapters/cursor/.cursorrules` | `.cursorrules` |
+| `adapters/codex/CODEX.md` | `AGENTS.md` (Codex 部分) |
+| `adapters/gemini/GEMINI.md` | `.gemini/GEMINI.md` |
+| `adapters/gemini-cli/GEMINI-CLI.md` | `.gemini/GEMINI-CLI.md` |
+| `adapters/opencode/OPENCODE.md` | `.opencode/OPENCODE.md` |
+| `adapters/copilot/copilot-instructions.md` | `.github/copilot-instructions.md` |
+| `adapters/claude/CLAUDE.md` | 合并到 `~/.claude/CLAUDE.md` |
+
+---
+
+### Phase 2：Hook 集成层（TypeScript 扩展）
+
+**目标**：将 Axiom 的启动协议和门禁系统集成到 ultrapower 的 Hook 事件流中。
+
+#### Task 2.1 — 创建 axiom-boot Hook
+
+文件：`src/hooks/axiom-boot/index.ts`
+
+功能：
+- 在 `UserPromptSubmit` 事件时触发
+- 读取 `.omc/axiom/active_context.md`
+- 检测 `task_status`（IDLE / EXECUTING / BLOCKED）
+- EXECUTING 状态时注入恢复提示到上下文
+- 通过 `contextCollector.register({ source: 'axiom-boot', priority: 'high' })` 注入
+
+#### Task 2.2 — 创建 axiom-guards Hook
+
+文件：`src/hooks/axiom-guards/index.ts`
+
+功能（对应 Axiom 四大门禁）：
+- Expert Gate：检测新功能请求，注入"需先经过 axiom-review 流程"提示
+- User Gate：PRD 生成后注入用户确认要求
+- Complexity Gate：检测工时估算 > 1 天时注入拆解建议
+- CI Gate：代码变更后注入构建验证要求
+
+#### Task 2.3 — 扩展 context-injector 类型
+
+文件：`src/features/context-injector/types.ts`
+
+添加新的 `ContextSourceType` 值：
+- `'axiom-boot'` — 启动恢复上下文
+- `'axiom-guards'` — 门禁规则上下文
+- `'axiom-memory'` — 记忆系统上下文
+
+#### Task 2.4 — 创建 axiom StateManager
+
+文件：`src/hooks/axiom-boot/storage.ts`
+
+使用现有 `createStateManager<T>('axiom-context')` 管理 Axiom 状态，映射到 `.omc/state/axiom-context.json`。
+
+---
+
+### Phase 3：进化引擎集成（增强现有系统）
+
+**目标**：将 Axiom 的自进化能力融合到 ultrapower 的 project_memory 和 notepad 系统中。
+
+#### Task 3.1 — 迁移知识库数据
+
+将 Axiom 的 28 条知识条目（k-001 至 k-028）迁移到 ultrapower 的 project_memory：
+- architecture 类 → `project_memory_add_note(category="architecture")`
+- workflow 类 → `project_memory_add_note(category="workflow")`
+- pattern 类 → `project_memory_add_directive(priority="high")`
+- tooling 类 → `project_memory_add_note(category="build")`
+
+#### Task 3.2 — 创建 learning_queue 处理机制
+
+在 `skills/axiom-evolve/SKILL.md` 中定义：
+- 读取 `.omc/axiom/evolution/learning_queue.md`
+- 按 source_type 分类处理（code_change / error_fix / workflow_run）
+- 更新 knowledge_base.md 和 pattern_library.md
+- 调用 `project_memory_add_note` 持久化高置信知识
+
+#### Task 3.3 — 迁移 pattern_library
+
+将 Axiom 的 P-001 Markdown Workflow Pattern 迁移到 ultrapower：
+- 写入 `.omc/axiom/evolution/pattern_library.md`
+- 高置信模式（confidence >= 0.85）通过 `project_memory_add_directive` 持久化
+
+---
+
+### Phase 4：CLAUDE.md 增强（配置层融合）
+
+**目标**：将 Axiom 的启动协议和工作流路由规则融合到 ultrapower 的 CLAUDE.md 配置中。
+
+#### Task 4.1 — 更新项目 CLAUDE.md
+
+在 `CLAUDE.md` 中添加 Axiom 集成部分：
+- Axiom 启动协议（读取 active_context → 恢复状态）
+- 工作流触发表（用户意图 → skill 命令映射）
+- 门禁规则说明
+- 知识利用优先级
+
+#### Task 4.2 — 更新 AGENTS.md
+
+将 Axiom 的 Worker 规范融合到 `AGENTS.md`：
+- PM → Worker 协作模式
+- 三种标准输出格式（QUESTION/COMPLETE/BLOCKED）
+- 自修复策略和重试规则
+- 质量门禁（强制）
+
+---
+
+### Phase 5：文档和测试
+
+#### Task 5.1 — 更新 REFERENCE.md
+
+记录所有新增的 Axiom skills 和 agents。
+
+#### Task 5.2 — 创建迁移验证脚本
+
+验证所有文件已正确创建，所有 skill 可被 ultrapower 加载。
+
+---
+
+## 三、文件创建清单（完整）
+
+### 新增 Agent 文件（8个）
+```
+agents/axiom-requirement-analyst.md
+agents/axiom-product-designer.md
+agents/axiom-review-aggregator.md
+agents/axiom-system-architect.md
+agents/axiom-prd-crafter.md
+agents/axiom-context-manager.md
+agents/axiom-evolution-engine.md
+agents/axiom-worker.md
+```
+
+### 新增 Skill 文件（12个）
+```
+skills/axiom-draft/SKILL.md
+skills/axiom-review/SKILL.md
+skills/axiom-decompose/SKILL.md
+skills/axiom-implement/SKILL.md
+skills/axiom-analyze-error/SKILL.md
+skills/axiom-reflect/SKILL.md
+skills/axiom-evolve/SKILL.md
+skills/axiom-status/SKILL.md
+skills/axiom-rollback/SKILL.md
+skills/axiom-suspend/SKILL.md
+skills/axiom-context/SKILL.md
+skills/axiom-evolution/SKILL.md
+```
+
+### 新增 Hook 文件（TypeScript）
+```
+src/hooks/axiom-boot/index.ts
+src/hooks/axiom-boot/types.ts
+src/hooks/axiom-boot/storage.ts
+src/hooks/axiom-guards/index.ts
+src/hooks/axiom-guards/types.ts
+src/hooks/axiom-guards/constants.ts
+```
+
+### 新增记忆系统文件
+```
+.omc/axiom/active_context.md
+.omc/axiom/project_decisions.md
+.omc/axiom/user_preferences.md
+.omc/axiom/state_machine.md
+.omc/axiom/reflection_log.md
+.omc/axiom/evolution/knowledge_base.md
+.omc/axiom/evolution/pattern_library.md
+.omc/axiom/evolution/learning_queue.md
+.omc/axiom/evolution/workflow_metrics.md
+```
+
+### 新增适配器文件（9个）
+```
+.kiro/steering/axiom.md
+.cursorrules
+.gemini/GEMINI.md
+.gemini/GEMINI-CLI.md
+.opencode/OPENCODE.md
+.github/copilot-instructions.md
+```
+
+### 修改现有文件
+```
+CLAUDE.md                              ← 添加 Axiom 启动协议和工作流路由
+AGENTS.md                              ← 添加 Worker 规范
+src/hooks/index.ts                     ← 注册新 hooks
+src/features/context-injector/types.ts ← 添加新 ContextSourceType
+```
+
+---
+
+## 四、执行顺序
+
+```
+Phase 1 (并行) → Phase 2 (顺序) → Phase 3 (并行) → Phase 4 (顺序) → Phase 5
+     ↓                ↓                ↓                ↓
+  Task 1.1-1.4    Task 2.1-2.4    Task 3.1-3.3    Task 4.1-4.2
+  (纯文件创建)    (TypeScript)    (数据迁移)      (配置更新)
+```
+
+**Phase 1 可完全并行执行**（4个独立任务）
+**Phase 2 需顺序执行**（2.3 依赖 2.1/2.2 的类型需求）
+**Phase 3 可完全并行执行**（3个独立任务）
+**Phase 4 需顺序执行**（4.2 依赖 4.1 的上下文）
+
+---
+
+## 五、验收标准
+
+- [ ] 所有 8 个 Axiom agent 文件存在且格式正确
+- [ ] 所有 12 个 Axiom skill 文件存在且可被 ultrapower 加载
+- [ ] `/axiom-draft`、`/axiom-review`、`/axiom-decompose`、`/axiom-implement` 命令可用
+- [ ] `/axiom-status`、`/axiom-reflect`、`/axiom-evolve` 命令可用
+- [ ] axiom-boot hook 在会话启动时正确读取 active_context
+- [ ] axiom-guards hook 正确注入门禁规则
+- [ ] 记忆系统目录结构完整
+- [ ] 9 个适配器文件已迁移到正确位置
+- [ ] 28 条知识条目已迁移到 project_memory
+- [ ] CLAUDE.md 包含 Axiom 启动协议
+- [ ] AGENTS.md 包含 Worker 规范

package/docs/shared/agent-tiers.md

@@ -0,0 +1,160 @@
+# Agent 层级参考
+
+这是所有 agent 层级信息的唯一权威来源。所有 skill 文件和文档应引用此文件，而非重复其中的表格。
+
+## 层级矩阵
+
+| 领域 | LOW (Haiku) | MEDIUM (Sonnet) | HIGH (Opus) |
+|--------|-------------|-----------------|-------------|
+| **分析** | architect-low | architect-medium | architect |
+| **执行** | executor-low | executor | executor-high |
+| **深度工作** | - | - | deep-executor |
+| **搜索** | explore | - | explore-high |
+| **研究** | - | document-specialist | - |
+| **前端** | designer-low | designer | designer-high |
+| **文档** | writer | - | - |
+| **视觉** | - | vision | - |
+| **规划** | - | - | planner |
+| **评审** | - | - | critic |
+| **预规划** | - | - | analyst |
+| **测试** | - | qa-tester | - |
+| **安全** | security-reviewer-low | - | security-reviewer |
+| **构建** | - | build-fixer | - |
+| **TDD** | tdd-guide-low | tdd-guide | - |
+| **代码审查** | - | - | code-reviewer |
+| **数据科学** | - | scientist | scientist-high |
+
+## 模型路由指南
+
+| 任务复杂度 | 层级 | 模型 | 使用时机 |
+|-----------------|------|-------|-------------|
+| 简单 | LOW | haiku | 快速查询、简单修复、"X 返回什么？" |
+| 标准 | MEDIUM | sonnet | 功能实现、标准调试、"添加验证" |
+| 复杂 | HIGH | opus | 架构决策、复杂调试、"重构系统" |
+
+## 按任务类型选择 Agent
+
+| 任务类型 | 最佳 Agent | 层级 |
+|-----------|------------|------|
+| 快速代码查询 | explore | LOW |
+| 查找文件/模式 | explore | LOW |
+| 复杂架构搜索 | explore-high | HIGH |
+| 简单代码修改 | executor-low | LOW |
+| 功能实现 | executor | MEDIUM |
+| 复杂重构 | executor-high | HIGH |
+| 调试简单问题 | architect-low | LOW |
+| 调试复杂问题 | architect | HIGH |
+| UI 组件 | designer | MEDIUM |
+| 复杂 UI 系统 | designer-high | HIGH |
+| 编写文档/注释 | writer | LOW |
+| 研究文档/API | document-specialist | MEDIUM |
+| 分析图片/图表 | vision | MEDIUM |
+| 战略规划 | planner | HIGH |
+| 审查/评审计划 | critic | HIGH |
+| 预规划分析 | analyst | HIGH |
+| 交互式 CLI 测试 | qa-tester | MEDIUM |
+| 安全审查 | security-reviewer | HIGH |
+| 快速安全扫描 | security-reviewer-low | LOW |
+| 修复构建错误 | build-fixer | MEDIUM |
+| 简单构建修复 | build-fixer (model=haiku) | LOW |
+| TDD 工作流 | tdd-guide | MEDIUM |
+| 快速测试建议 | tdd-guide-low | LOW |
+| 代码审查 | code-reviewer | HIGH |
+| 快速代码检查 | code-reviewer (model=haiku) | LOW |
+| 数据分析/统计 | scientist | MEDIUM |
+| 快速数据检查 | scientist (model=haiku) | LOW |
+| 复杂 ML/假设验证 | scientist-high | HIGH |
+| 查找符号引用 | explore-high | HIGH |
+| 获取文件/工作区符号概览 | explore | LOW |
+| 结构化代码模式搜索 | explore | LOW |
+| 结构化代码转换 | executor-high | HIGH |
+| 全项目类型检查 | build-fixer | MEDIUM |
+| 检查单文件错误 | executor-low | LOW |
+| 数据分析/计算 | scientist | MEDIUM |
+| 复杂自主工作 | deep-executor | HIGH |
+| 深度目标导向执行 | deep-executor | HIGH |
+
+## 使用方法
+
+委派任务时，始终显式指定模型：
+
+```
+Task(subagent_type="ultrapower:executor",
+     model="sonnet",
+     prompt="...")
+```
+
+为节省 token，在任务允许时优先使用较低层级：
+- 简单查询和快速修复使用 `haiku`
+- 标准实现工作使用 `sonnet`
+- 复杂推理任务保留 `opus`
+
+## MCP 工具与 Agent 能力
+
+### 工具清单
+
+| 工具 | 类别 | 用途 | 是否分配给 Agent？ |
+|------|----------|---------|---------------------|
+| `lsp_hover` | LSP | 获取代码位置的类型信息和文档 | 否（orchestrator 直接使用） |
+| `lsp_goto_definition` | LSP | 跳转到符号定义处 | 否（orchestrator 直接使用） |
+| `lsp_find_references` | LSP | 查找符号在代码库中的所有用法 | 是（仅 `explore-high`） |
+| `lsp_document_symbols` | LSP | 获取文件中所有符号的概览 | 是 |
+| `lsp_workspace_symbols` | LSP | 按名称在工作区中搜索符号 | 是 |
+| `lsp_diagnostics` | LSP | 获取文件的错误、警告和提示 | 是 |
+| `lsp_diagnostics_directory` | LSP | 项目级类型检查（tsc --noEmit 或 LSP） | 是 |
+| `lsp_prepare_rename` | LSP | 检查符号是否可以重命名 | 否（orchestrator 直接使用） |
+| `lsp_rename` | LSP | 在整个项目中重命名符号 | 否（orchestrator 直接使用） |
+| `lsp_code_actions` | LSP | 获取可用的重构和快速修复 | 否（orchestrator 直接使用） |
+| `lsp_code_action_resolve` | LSP | 获取代码操作的完整编辑详情 | 否（orchestrator 直接使用） |
+| `lsp_servers` | LSP | 列出可用的语言服务器及安装状态 | 否（orchestrator 直接使用） |
+| `ast_grep_search` | AST | 基于 AST 的模式化结构代码搜索 | 是 |
+| `ast_grep_replace` | AST | 基于模式的结构化代码转换 | 是（仅 `executor-high`） |
+| `python_repl` | Data | 用于数据分析和计算的持久化 Python REPL | 是 |
+
+### Agent 工具矩阵（仅 MCP 工具）
+
+| Agent | LSP Diagnostics | LSP Dir Diagnostics | LSP Symbols | LSP References | AST Search | AST Replace | Python REPL |
+|-------|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
+| `explore` | - | - | doc + workspace | - | yes | - | - |
+| `explore-high` | - | - | doc + workspace | yes | yes | - | - |
+| `architect-low` | yes | - | - | - | - | - | - |
+| `architect-medium` | yes | yes | - | - | yes | - | - |
+| `architect` | yes | yes | - | - | yes | - | - |
+| `executor-low` | yes | - | - | - | - | - | - |
+| `executor` | yes | yes | - | - | - | - | - |
+| `executor-high` | yes | yes | - | - | yes | yes | - |
+| `deep-executor` | yes | yes | - | - | yes | yes | - |
+| `build-fixer` | yes | yes | - | - | - | - | - |
+| `tdd-guide` | yes | - | - | - | - | - | - |
+| `tdd-guide-low` | yes | - | - | - | - | - | - |
+| `code-reviewer` | yes | - | - | - | yes | - | - |
+| `qa-tester` | yes | - | - | - | - | - | - |
+| `scientist` | - | - | - | - | - | - | yes |
+| `scientist-high` | - | - | - | - | - | - | yes |
+
+### 未分配工具（Orchestrator 直接使用）
+
+以下 7 个 MCP 工具未分配给任何 agent，需要时直接使用：
+
+| 工具 | 直接使用时机 |
+|------|---------------------|
+| `lsp_hover` | 对话中快速查询类型 |
+| `lsp_goto_definition` | 分析过程中导航到符号定义 |
+| `lsp_prepare_rename` | 在决定方案前检查重命名可行性 |
+| `lsp_rename` | 安全重命名操作（返回编辑预览，不自动应用） |
+| `lsp_code_actions` | 发现可用的重构操作 |
+| `lsp_code_action_resolve` | 获取特定代码操作的详情 |
+| `lsp_servers` | 检查语言服务器可用性 |
+
+对于需要实现的复杂重命名或重构任务，委派给 `executor-high`，它可以使用 `ast_grep_replace` 进行结构化转换。
+
+### 工具选择指南
+
+- **需要文件符号概览或工作区搜索？** 通过 `explore` 或 `explore-high` 使用 `lsp_document_symbols`/`lsp_workspace_symbols`
+- **需要查找符号的所有用法？** 通过 `explore-high` 使用 `lsp_find_references`（唯一拥有此工具的 agent）
+- **需要结构化代码模式？**（如"查找所有匹配 X 形状的函数"）通过 `explore` 系列、`architect`/`architect-medium` 或 `code-reviewer` 使用 `ast_grep_search`
+- **需要结构化代码转换？** 通过 `executor-high` 使用 `ast_grep_replace`（唯一拥有此工具的 agent）
+- **需要全项目类型检查？** 通过 `architect`/`architect-medium`、`executor`/`executor-high` 或 `build-fixer` 使用 `lsp_diagnostics_directory`
+- **需要单文件错误检查？** 通过多个 agent 使用 `lsp_diagnostics`（参见矩阵）
+- **需要数据分析/计算？** 通过 `scientist` 或 `scientist-high` 使用 `python_repl`
+- **需要快速类型信息或定义查询？** 直接使用 `lsp_hover`/`lsp_goto_definition`（orchestrator 直接工具）

package/docs/shared/features.md

@@ -0,0 +1,153 @@
+# 功能参考（v3.1 - v3.4）
+
+## Session Notepad（短期记忆）
+
+位于 `.omc/notepad.md` 的抗压缩记忆系统，分为三个层级：
+
+| 区块 | 行为 | 用途 |
+|---------|----------|---------|
+| **Priority Context** | 每次 session 启动时始终加载（最多 500 字符） | 关键信息：如"项目使用 pnpm"、"API key 在 .env 中" |
+| **Working Memory** | 带时间戳的条目，7 天后自动清理 | 调试线索、临时发现 |
+| **MANUAL** | 永不自动清理 | 团队联系人、部署信息、永久笔记 |
+
+**用户 skill：** `/ultrapower:note`
+- `/ultrapower:note <content>` - 添加到 Working Memory
+- `/ultrapower:note --priority <content>` - 添加到 Priority Context
+- `/ultrapower:note --manual <content>` - 添加到 MANUAL 区块
+- `/ultrapower:note --show` - 显示 notepad 内容
+
+**自动捕获：** Task agent 输出中的 `<remember>` 标签会被自动捕获：
+- `<remember>content</remember>` → 带时间戳写入 Working Memory
+- `<remember priority>content</remember>` → 替换 Priority Context
+
+**API：** `initNotepad()`、`addWorkingMemoryEntry()`、`setPriorityContext()`、`addManualEntry()`、`getPriorityContext()`、`getWorkingMemory()`、`formatNotepadContext()`、`pruneOldEntries()`
+
+## Notepad Wisdom 系统（计划范围）
+
+按计划范围捕获学习成果、决策、问题和挑战。
+
+**位置：** `.omc/notepads/{plan-name}/`
+
+| 文件 | 用途 |
+|------|---------|
+| `learnings.md` | 技术发现和模式 |
+| `decisions.md` | 架构和设计决策 |
+| `issues.md` | 已知问题和解决方案 |
+| `problems.md` | 阻塞项和挑战 |
+
+**API：** `initPlanNotepad()`、`addLearning()`、`addDecision()`、`addIssue()`、`addProblem()`、`getWisdomSummary()`、`readPlanWisdom()`
+
+## 委派类别
+
+语义化任务分类，自动映射到模型层级、温度和思考预算。
+
+| 类别 | 层级 | 温度 | 思考 | 用途 |
+|----------|------|-------------|----------|---------|
+| `visual-engineering` | HIGH | 0.7 | high | UI/UX、前端、设计系统 |
+| `ultrabrain` | HIGH | 0.3 | max | 复杂推理、架构、深度调试 |
+| `artistry` | MEDIUM | 0.9 | medium | 创意解决方案、头脑风暴 |
+| `quick` | LOW | 0.1 | low | 简单查询、基本操作 |
+| `writing` | MEDIUM | 0.5 | medium | 文档、技术写作 |
+
+**自动检测：** 类别根据 prompt 关键词自动识别。
+
+## 目录诊断工具
+
+通过 `lsp_diagnostics_directory` 工具进行项目级类型检查。
+
+**策略：**
+- `auto`（默认）- 自动选择最佳策略，存在 tsconfig.json 时优先使用 tsc
+- `tsc` - 快速，使用 TypeScript 编译器
+- `lsp` - 备用方案，通过 Language Server 逐文件检查
+
+**用途：** 在提交前或重构后检查整个项目的错误。
+
+## Session Resume
+
+后台 agent 可通过 `resume-session` 工具携带完整上下文恢复执行。
+
+## Ultrapilot（v3.4）
+
+并行 autopilot，最多支持 20 个并发 worker，执行速度提升 3-5 倍。
+
+**触发词：** "ultrapilot"、"parallel build"、"swarm build"
+
+**工作原理：**
+1. 任务分解引擎将复杂任务拆分为可并行的子任务
+2. 文件所有权协调器为 worker 分配不重叠的文件集
+3. Worker 并行执行，协调器管理共享文件
+4. 结果整合时进行冲突检测
+
+**最适合：** 多组件系统、全栈应用、大规模重构
+
+**状态文件：**
+- `.omc/state/ultrapilot-state.json` - Session 状态
+- `.omc/state/ultrapilot-ownership.json` - 文件所有权
+
+## Swarm（v3.4）
+
+N 个协调 agent，从共享任务池中原子性地认领任务。
+
+**用法：** `/swarm 5:executor "fix all TypeScript errors"`
+
+**特性：**
+- 共享任务列表，包含 pending/claimed/done 状态
+- 每个任务 5 分钟超时，超时后自动释放
+- 所有任务完成后干净退出
+
+## Pipeline（v3.4）
+
+顺序 agent 链，各阶段之间传递数据。
+
+**内置预设：**
+| 预设 | 阶段 |
+|--------|--------|
+| `review` | explore -> architect -> critic -> executor |
+| `implement` | planner -> executor -> tdd-guide |
+| `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 |
+
+**自定义 pipeline：** `/pipeline explore:haiku -> architect:opus -> executor:sonnet`
+
+## 统一取消（v3.4）
+
+智能取消，自动检测当前活跃模式。
+
+**用法：** `/cancel` 或直接说 "cancelomc"、"stopomc"
+
+自动检测并取消：autopilot、ultrapilot、ralph、ultrawork、ultraqa、swarm、pipeline
+使用 `--force` 或 `--all` 清除所有状态。
+
+## 验证模块（v3.4）
+
+可复用的工作流验证协议。
+
+**标准检查项：** BUILD、TEST、LINT、FUNCTIONALITY、ARCHITECT、TODO、ERROR_FREE
+
+**证据验证：** 5 分钟新鲜度检测，通过/失败追踪
+
+## 状态管理（v3.4）
+
+标准化的状态文件位置。
+
+**所有模式状态文件的标准路径：**
+- 主路径：`.omc/state/{name}.json`（本地，按项目）
+- 全局备份：`~/.omc/state/{name}.json`（全局，session 连续性）
+
+**模式状态文件：**
+| 模式 | 状态文件 |
+|------|-----------|
+| ralph | `ralph-state.json` |
+| autopilot | `autopilot-state.json` |
+| ultrapilot | `ultrapilot-state.json` |
+| ultrawork | `ultrawork-state.json` |
+|  | `-state.json` |
+| ultraqa | `ultraqa-state.json` |
+| pipeline | `pipeline-state.json` |
+| swarm | `swarm-summary.json` + `swarm-active.marker` |
+
+**重要：** 永远不要将 OMC 状态存储在 `~/.claude/` 中——该目录保留给 Claude Code 本身使用。
+
+旧版位置在读取时自动迁移。