@liangjie559567/ultrapower 5.6.6 → 5.6.8

package/docs/adr/002-caching-strategy.md

@@ -13,16 +13,22 @@
 ### 问题陈述
 
 WorkerStateAdapter 引入后，频繁的状态查询成为性能瓶颈：
-- Team 模式下每 5 秒检查一次所有 workers 的健康状态
-- MCP 模式下任务完成后需要查询最终状态
-- 无缓存时，100 个 workers 的健康检查需要 ~50ms
+
+* Team 模式下每 5 秒检查一次所有 workers 的健康状态
+
+* MCP 模式下任务完成后需要查询最终状态
+
+* 无缓存时，100 个 workers 的健康检查需要 ~50ms
 
 ### 约束条件
 
-- 缓存必须对业务逻辑透明（装饰器模式）
-- 缓存失效策略必须简单可靠
-- 不能引入额外的依赖
-- 缓存命中率需要 > 80%
+* 缓存必须对业务逻辑透明（装饰器模式）
+
+* 缓存失效策略必须简单可靠
+
+* 不能引入额外的依赖
+
+* 缓存命中率需要 > 80%
 
 ---
 
@@ -39,15 +45,20 @@ const cachedAdapter = new CachedWorkerAdapter(baseAdapter, 5000); // 5s TTL
 ```
 
 **缓存策略**:
-- **get()**: 缓存单个 worker 状态（5s TTL）
-- **list()**: 不缓存（过滤条件复杂）
-- **upsert()**: 更新时同步缓存
-- **delete()**: 删除时清除缓存
-- **cleanup()**: 清空整个缓存
+
+* **get()**: 缓存单个 worker 状态（5s TTL）
+
+* **list()**: 不缓存（过滤条件复杂）
+
+* **upsert()**: 更新时同步缓存
+
+* **delete()**: 删除时清除缓存
+
+* **cleanup()**: 清空整个缓存
 
 **性能目标**:
 | 操作 | 无缓存 | 有缓存 | 提升 |
-|------|--------|--------|------|
+| ------ | -------- | -------- | ------ |
 | 单个查询 | 20ms | <5ms | 4x |
 | 健康检查 | 50ms | <10ms | 5x |
 | 批量更新 | 200ms | <50ms | 4x |
@@ -76,24 +87,32 @@ const cachedAdapter = new CachedWorkerAdapter(baseAdapter, 5000); // 5s TTL
 ### 方案 A: 数据库级缓存（SQLite 查询缓存）
 
 **优点**:
-- 自动缓存，无需额外代码
-- 缓存一致性有保证
+
+* 自动缓存，无需额外代码
+
+* 缓存一致性有保证
 
 **缺点**:
-- 仅适用 SQLite，JSON 无法使用
-- 无法跨适配器共享缓存
+
+* 仅适用 SQLite，JSON 无法使用
+
+* 无法跨适配器共享缓存
 
 **为什么未采用**: 不够通用，无法覆盖 JSON 适配器
 
 ### 方案 B: 无缓存，优化查询
 
 **优点**:
-- 无缓存一致性问题
-- 实现简单
+
+* 无缓存一致性问题
+
+* 实现简单
 
 **缺点**:
-- 性能无法达到目标（4-5x）
-- Team 模式下频繁查询成为瓶颈
+
+* 性能无法达到目标（4-5x）
+
+* Team 模式下频繁查询成为瓶颈
 
 **为什么未采用**: 无法满足性能需求
 
@@ -101,12 +120,14 @@ const cachedAdapter = new CachedWorkerAdapter(baseAdapter, 5000); // 5s TTL
 
 ## 相关决策
 
-- ADR-001: WorkerStateAdapter 抽象层设计
-- ADR-003: 渐进式迁移方案
+* ADR-001: WorkerStateAdapter 抽象层设计
+
+* ADR-003: 渐进式迁移方案
 
 ---
 
 ## 参考资源
 
-- `src/workers/cached-adapter.ts` - 实现代码
-- `.omc/p1-5/worker-backend-design.md` §5.1 - 缓存设计
+* `src/workers/cached-adapter.ts` - 实现代码
+
+* `.omc/p1-5/worker-backend-design.md` §5.1 - 缓存设计

package/docs/adr/003-gradual-migration.md

@@ -13,16 +13,22 @@
 ### 问题陈述
 
 WorkerStateAdapter 抽象层创建后，需要将现有 MCP 和 Team 模块迁移到新接口。直接迁移风险高：
-- 可能破坏现有功能
-- 无法快速回滚
-- 难以隔离问题
+
+* 可能破坏现有功能
+
+* 无法快速回滚
+
+* 难以隔离问题
 
 ### 约束条件
 
-- 必须保持 100% 向后兼容
-- 每个阶段必须独立可验证
-- 迁移期间不能中断服务
-- 需要支持快速回滚
+* 必须保持 100% 向后兼容
+
+* 每个阶段必须独立可验证
+
+* 迁移期间不能中断服务
+
+* 需要支持快速回滚
 
 ---
 
@@ -35,49 +41,69 @@ WorkerStateAdapter 抽象层创建后，需要将现有 MCP 和 Team 模块迁
 **四阶段迁移**:
 
 | 阶段 | 目标 | 耗时 | 风险 |
-|------|------|------|------|
+| ------ | ------ | ------ | ------ |
 | Phase 1 | 创建抽象层 | 1 周 | 低 |
 | Phase 2 | MCP 迁移 | 1 周 | 中 |
 | Phase 3 | Team 迁移 | 1 周 | 中 |
 | Phase 4 | 优化清理 | 1 周 | 低 |
 
 **Phase 1: 基础抽象层**
-- 创建 `src/workers/` 目录
-- 实现 SQLite 和 JSON 适配器
-- 单元测试覆盖率 > 90%
-- 不修改现有代码，零风险
+
+* 创建 `src/workers/` 目录
+
+* 实现 SQLite 和 JSON 适配器
+
+* 单元测试覆盖率 > 90%
+
+* 不修改现有代码，零风险
 
 **Phase 2: MCP 迁移**
-- 修改 `src/mcp/job-management.ts`
-- 环境变量 `WORKER_BACKEND=auto|sqlite|json|legacy` 控制
-- 失败时自动回退到旧实现
-- 迁移工具转换现有 jobs.db 数据
+
+* 修改 `src/mcp/job-management.ts`
+
+* 环境变量 `WORKER_BACKEND=auto | sqlite | json | legacy` 控制
+
+* 失败时自动回退到旧实现
+
+* 迁移工具转换现有 jobs.db 数据
 
 **Phase 3: Team 迁移**
-- 修改 `src/team/worker-health.ts` 和 `worker-restart.ts`
-- 优先查询适配器，不存在时回退 JSON 文件
-- 完全向后兼容，无需迁移数据
+
+* 修改 `src/team/worker-health.ts` 和 `worker-restart.ts`
+
+* 优先查询适配器，不存在时回退 JSON 文件
+
+* 完全向后兼容，无需迁移数据
 
 **Phase 4: 优化清理**
-- 实现缓存层和并发控制
-- 移除 Swarm 遗留代码
-- 性能基准测试达标
-- 文档更新
+
+* 实现缓存层和并发控制
+
+* 移除 Swarm 遗留代码
+
+* 性能基准测试达标
+
+* 文档更新
 
 ### 实施方式
 
 **环境变量控制**:
 ```bash
+
 # 使用新适配器（自动选择 SQLite 或 JSON）
+
 WORKER_BACKEND=auto
 
 # 强制使用 SQLite
+
 WORKER_BACKEND=sqlite
 
 # 强制使用 JSON
+
 WORKER_BACKEND=json
 
 # 回退到旧实现
+
 WORKER_BACKEND=legacy
 ```
 
@@ -124,26 +150,36 @@ if (workers.length === 0) {
 ### 方案 A: 一次性迁移
 
 **优点**:
-- 迁移周期短（2 周）
-- 无需维护两套实现
+
+* 迁移周期短（2 周）
+
+* 无需维护两套实现
 
 **缺点**:
-- 风险高，问题难以隔离
-- 无法快速回滚
-- 可能中断服务
+
+* 风险高，问题难以隔离
+
+* 无法快速回滚
+
+* 可能中断服务
 
 **为什么未采用**: 风险无法接受
 
 ### 方案 B: 并行运行（新旧同时）
 
 **优点**:
-- 可以对比验证
-- 问题隔离
+
+* 可以对比验证
+
+* 问题隔离
 
 **缺点**:
-- 维护成本极高
-- 数据一致性难以保证
-- 迁移周期更长
+
+* 维护成本极高
+
+* 数据一致性难以保证
+
+* 迁移周期更长
 
 **为什么未采用**: 维护成本过高
 
@@ -152,42 +188,63 @@ if (workers.length === 0) {
 ## 迁移检查清单
 
 ### Phase 1 完成标准
-- [ ] `src/workers/types.ts` 定义完整
-- [ ] SQLite 和 JSON 适配器实现
-- [ ] 单元测试覆盖率 > 90%
-- [ ] 工厂函数支持自动回退
-- [ ] 文档完整
+
+* [ ] `src/workers/types.ts` 定义完整
+
+* [ ] SQLite 和 JSON 适配器实现
+
+* [ ] 单元测试覆盖率 > 90%
+
+* [ ] 工厂函数支持自动回退
+
+* [ ] 文档完整
 
 ### Phase 2 完成标准
-- [ ] `job-management.ts` 集成适配器
-- [ ] 环境变量控制生效
-- [ ] 迁移工具验证数据一致性
-- [ ] MCP 任务完整流程测试通过
-- [ ] 性能基准测试达标
+
+* [ ] `job-management.ts` 集成适配器
+
+* [ ] 环境变量控制生效
+
+* [ ] 迁移工具验证数据一致性
+
+* [ ] MCP 任务完整流程测试通过
+
+* [ ] 性能基准测试达标
 
 ### Phase 3 完成标准
-- [ ] `worker-health.ts` 和 `worker-restart.ts` 迁移
-- [ ] Team 健康检查功能正常
-- [ ] 回退机制验证
-- [ ] 所有 Team 测试通过
+
+* [ ] `worker-health.ts` 和 `worker-restart.ts` 迁移
+
+* [ ] Team 健康检查功能正常
+
+* [ ] 回退机制验证
+
+* [ ] 所有 Team 测试通过
 
 ### Phase 4 完成标准
-- [ ] 缓存层实现并测试
-- [ ] 性能基准全部达标
-- [ ] 文档同步更新
-- [ ] 遗留代码清理
+
+* [ ] 缓存层实现并测试
+
+* [ ] 性能基准全部达标
+
+* [ ] 文档同步更新
+
+* [ ] 遗留代码清理
 
 ---
 
 ## 相关决策
 
-- ADR-001: WorkerStateAdapter 抽象层设计
-- ADR-002: 缓存层实现策略
+* ADR-001: WorkerStateAdapter 抽象层设计
+
+* ADR-002: 缓存层实现策略
 
 ---
 
 ## 参考资源
 
-- `.omc/p1-5/worker-backend-design.md` §7 - 分阶段实施计划
-- `.omc/p1-5/phase1-3-summary.md` - 实施总结
-- `docs/standards/contribution-guide.md` - 贡献规范
+* `.omc/p1-5/worker-backend-design.md` §7 - 分阶段实施计划
+
+* `.omc/p1-5/phase1-3-summary.md` - 实施总结
+
+* `docs/standards/contribution-guide.md` - 贡献规范

package/docs/adr/template.md

@@ -13,14 +13,20 @@
 为什么需要这个决策？描述问题的上下文、约束条件和驱动因素。
 
 ### 问题陈述
-- 当前状态是什么？
-- 存在什么问题或痛点？
-- 为什么现在需要解决？
+
+* 当前状态是什么？
+
+* 存在什么问题或痛点？
+
+* 为什么现在需要解决？
 
 ### 约束条件
-- 技术约束
-- 业务约束
-- 时间约束
+
+* 技术约束
+
+* 业务约束
+
+* 时间约束
 
 ---
 
@@ -29,12 +35,16 @@
 我们决定做什么？简明扼要地陈述决策。
 
 ### 选择的方案
+
 [描述选择的具体方案]
 
 ### 实施方式
-- 关键步骤
-- 依赖关系
-- 时间线
+
+* 关键步骤
+
+* 依赖关系
+
+* 时间线
 
 ---
 
@@ -43,19 +53,28 @@
 这个决策的影响是什么？
 
 ### 正面影响
-- 优势 1
-- 优势 2
-- 优势 3
+
+* 优势 1
+
+* 优势 2
+
+* 优势 3
 
 ### 负面影响
-- 风险 1
-- 成本 1
-- 限制 1
+
+* 风险 1
+
+* 成本 1
+
+* 限制 1
 
 ### 权衡
-- 性能 vs 复杂度
-- 灵活性 vs 简单性
-- 等等
+
+* 性能 vs 复杂度
+
+* 灵活性 vs 简单性
+
+* 等等
 
 ---
 
@@ -64,6 +83,7 @@
 考虑过但未采用的方案。
 
 ### 方案 A: [名称]
+
 **优点**:
 -
 
@@ -73,6 +93,7 @@
 **为什么未采用**:
 
 ### 方案 B: [名称]
+
 **优点**:
 -
 
@@ -85,13 +106,16 @@
 
 ## 相关决策
 
-- ADR-XXX: [相关决策]
-- ADR-YYY: [相关决策]
+* ADR-XXX: [相关决策]
+
+* ADR-YYY: [相关决策]
 
 ---
 
 ## 参考资源
 
-- [文档链接]
-- [代码链接]
-- [讨论链接]
+* [文档链接]
+
+* [代码链接]
+
+* [讨论链接]

package/docs/agent-templates/AGENTS.md

@@ -4,12 +4,13 @@
 # docs/agent-templates/
 
 ## Purpose
+
 Agent 模板文档目录。存放 agent 提示词设计规范和层级指令模板，指导如何为不同复杂度的任务设计 agent 提示词。
 
 ## Key Files
 
 | File | Description |
-|------|-------------|
+| ------ | ------------- |
 | `base-agent.md` | 基础 agent 提示词模板规范 |
 | `README.md` | 模板使用说明 |
 | `tier-instructions.md` | 分层指令设计规范（haiku/sonnet/opus 层级） |
@@ -17,13 +18,17 @@ Agent 模板文档目录。存放 agent 提示词设计规范和层级指令模
 ## For AI Agents
 
 ### 修改此目录时
-- 模板变更需同步更新 `src/agents/templates/`
-- 参见 `agents/` 目录了解实际 agent 定义
+
+* 模板变更需同步更新 `src/agents/templates/`
+
+* 参见 `agents/` 目录了解实际 agent 定义
 
 ## Dependencies
 
 ### Internal
-- `src/agents/templates/` — TypeScript 模板实现
-- `agents/` — Agent 提示词定义
+
+* `src/agents/templates/` — TypeScript 模板实现
+
+* `agents/` — Agent 提示词定义
 
 <!-- MANUAL: -->

package/docs/agent-templates/README.md

@@ -4,9 +4,11 @@ This directory contains reusable templates for creating agent prompts, reducing
 
 ## Files
 
-- **base-agent.md**: Core template structure with injection points
-- **tier-instructions.md**: Tier-specific behavioral instructions (LOW/MEDIUM/HIGH)
-- **README.md**: This file - usage guide
+* **base-agent.md**: Core template structure with injection points
+
+* **tier-instructions.md**: Tier-specific behavioral instructions (LOW/MEDIUM/HIGH)
+
+* **README.md**: This file - usage guide
 
 ## Template System
 
@@ -15,7 +17,7 @@ This directory contains reusable templates for creating agent prompts, reducing
 The template uses the following placeholders:
 
 | Placeholder | Description | Example |
-|-------------|-------------|---------|
+| ------------- | ------------- | --------- |
 | `{{AGENT_NAME}}` | Agent identifier | `executor-low`, `architect-medium` |
 | `{{ROLE_DESCRIPTION}}` | What this agent does | "You execute simple code changes..." |
 | `{{TIER_INSTRUCTIONS}}` | Tier-specific behavior | LOW/MEDIUM/HIGH instructions |
@@ -29,14 +31,14 @@ The template uses the following placeholders:
    cp agents/templates/base-agent.md agents/my-new-agent.md
    ```
 
-2. **Replace placeholders**:
+1. **Replace placeholders**:
    - Set `{{AGENT_NAME}}` to your agent name
    - Write `{{ROLE_DESCRIPTION}}` specific to your agent
    - Copy appropriate tier instructions from `tier-instructions.md`
    - Add any `{{TASK_SPECIFIC_INSTRUCTIONS}}` unique to this agent
    - Define `{{EXPECTED_DELIVERABLES}}`
 
-3. **Review common protocol**:
+1. **Review common protocol**:
    - The base template includes shared verification and tool usage protocols
    - These apply to ALL agents and don't need modification
    - Only extend if your agent needs additional protocols
@@ -44,37 +46,53 @@ The template uses the following placeholders:
 ### Example: Creating executor-low
 
 ```markdown
+
 # executor-low
 
 ## Role
+
 You execute simple, well-defined code changes quickly and efficiently. Handle single-file modifications, small bug fixes, and straightforward feature additions.
 
 ## Tier-Specific Instructions
+
 **Tier: LOW (Haiku) - Speed-Focused Execution**
 
-- Focus on speed and direct execution
-- Handle simple, well-defined tasks only
-- Limit exploration to 5 files maximum
-- Escalate to executor (MEDIUM) if:
+* Focus on speed and direct execution
+
+* Handle simple, well-defined tasks only
+
+* Limit exploration to 5 files maximum
+
+* Escalate to executor (MEDIUM) if:
   - Task requires analyzing more than 5 files
   - Complexity is higher than expected
   - Architectural decisions needed
-- Prefer straightforward solutions over clever ones
-- Skip deep investigation - implement what's asked
+
+* Prefer straightforward solutions over clever ones
+
+* Skip deep investigation - implement what's asked
 
 ## Common Protocol
+
 [... standard protocol from base-agent.md ...]
 
 ## Task Execution
-- Read the target file first
-- Make the requested changes
-- Run lsp_diagnostics on changed files
-- Verify changes compile/pass basic checks
+
+* Read the target file first
+
+* Make the requested changes
+
+* Run lsp_diagnostics on changed files
+
+* Verify changes compile/pass basic checks
 
 ## Deliverables
-- Modified file(s)
-- lsp_diagnostics output showing no new errors
-- Brief summary of changes made
+
+* Modified file(s)
+
+* lsp_diagnostics output showing no new errors
+
+* Brief summary of changes made
 ```
 
 ## Benefits
@@ -86,16 +104,20 @@ You execute simple, well-defined code changes quickly and efficiently. Handle si
 
 ## Best Practices
 
-- **Don't override common protocol** unless absolutely necessary
-- **Be specific in role descriptions** - avoid vague terms like "handle tasks"
-- **Document escalation paths** - when should this agent call another?
-- **Include examples** in task-specific instructions when helpful
-- **Keep tier instructions pure** - only capability/scope guidance, not role-specific behavior
+* **Don't override common protocol** unless absolutely necessary
+
+* **Be specific in role descriptions** - avoid vague terms like "handle tasks"
+
+* **Document escalation paths** - when should this agent call another?
+
+* **Include examples** in task-specific instructions when helpful
+
+* **Keep tier instructions pure** - only capability/scope guidance, not role-specific behavior
 
 ## Tier Selection Guide
 
 | Tier | Model | Token Cost | Use When |
-|------|-------|------------|----------|
+| ------ | ------- | ------------ | ---------- |
 | LOW | Haiku | $ | Task is simple, well-defined, <5 files |
 | MEDIUM | Sonnet | $$ | Task needs investigation, <20 files |
 | HIGH | Opus | $$$ | Task is complex, architectural, unlimited files |
@@ -104,7 +126,10 @@ You execute simple, well-defined code changes quickly and efficiently. Handle si
 
 Potential additions to the template system:
 
-- Domain-specific templates (frontend, backend, data, etc.)
-- Composition templates for specialized agents
-- Automated template validation
-- Template generation CLI tool
+* Domain-specific templates (frontend, backend, data, etc.)
+
+* Composition templates for specialized agents
+
+* Automated template validation
+
+* Template generation CLI tool