@liangjie559567/ultrapower 5.6.5 → 5.6.7

package/docs/TIERED_AGENTS_V2.md

@@ -5,7 +5,7 @@
 ### Build/Analysis Lane（8 个）
 
 | Agent | 模型 | 用途 |
-|-------|------|------|
+| ------- | ------ | ------ |
 | explore | haiku | 代码库发现、符号/文件映射 |
 | analyst | opus | 需求分析、验收标准、隐藏约束 |
 | planner | opus | 任务排序、执行计划、风险标记 |
@@ -18,7 +18,7 @@
 ### Review Lane（6 个）
 
 | Agent | 模型 | 用途 |
-|-------|------|------|
+| ------- | ------ | ------ |
 | style-reviewer | haiku | 格式、命名、惯用法、lint 规范 |
 | quality-reviewer | sonnet | 逻辑缺陷、可维护性、反模式 |
 | api-reviewer | sonnet | API 契约、版本控制、向后兼容性 |
@@ -29,7 +29,7 @@
 ### Domain Specialists（16 个）
 
 | Agent | 模型 | 用途 |
-|-------|------|------|
+| ------- | ------ | ------ |
 | dependency-expert | sonnet | 外部 SDK/API/包评估 |
 | test-engineer | sonnet | 测试策略、覆盖率、不稳定测试加固 |
 | quality-strategist | sonnet | 质量策略、发布就绪性、风险评估 |
@@ -50,13 +50,13 @@
 ### Coordination（1 个）
 
 | Agent | 模型 | 用途 |
-|-------|------|------|
+| ------- | ------ | ------ |
 | critic | opus | 计划/设计批判性挑战 |
 
 ### Product Lane（4 个）
 
 | Agent | 模型 | 用途 |
-|-------|------|------|
+| ------- | ------ | ------ |
 | product-manager | sonnet | 问题框架、用户画像/JTBD、PRD |
 | ux-researcher | sonnet | 启发式审计、可用性、无障碍性 |
 | information-architect | sonnet | 分类法、导航、可发现性 |
@@ -65,7 +65,7 @@
 ### Axiom Lane（14 个）
 
 | Agent | 模型 | 用途 |
-|-------|------|------|
+| ------- | ------ | ------ |
 | axiom-requirement-analyst | sonnet | 需求分析三态门（PASS/CLARIFY/REJECT） |
 | axiom-product-designer | sonnet | Draft PRD 生成，含 Mermaid 流程图 |
 | axiom-review-aggregator | sonnet | 5 专家并行审查聚合与冲突仲裁 |
@@ -102,23 +102,31 @@
 ### 1. 基于模板的继承
 
 每个分层 agent 应从提供以下内容的基础模板继承：
-- 核心身份和角色
-- 基本约束（只读、禁止委派等）
-- 输出格式要求
-- 质量标准
+
+* 核心身份和角色
+
+* 基本约束（只读、禁止委派等）
+
+* 输出格式要求
+
+* 质量标准
 
 层级专属覆盖项用于自定义：
-- 任务复杂度边界
-- 工具限制
-- 响应深度/广度
-- 升级阈值
+
+* 任务复杂度边界
+
+* 工具限制
+
+* 响应深度/广度
+
+* 升级阈值
 
 ### 2. 明确的能力边界
 
 每个层级有清晰的边界：
 
 | 层级 | 复杂度 | 响应深度 | 自我评估 |
-|------|------------|----------------|-----------------|
+| ------ | ------------ | ---------------- | ----------------- |
 | LOW (Haiku) | 简单、单一焦点 | 简洁、直接 | "这在我的处理范围内吗？" |
 | MEDIUM (Sonnet) | 中等、多步骤 | 全面、结构化 | "我能完整处理这个吗？" |
 | HIGH (Opus) | 复杂、系统级 | 综合、细致 | "有哪些权衡？" |
@@ -129,14 +137,20 @@ Agents 应识别何时建议升级：
 
 ```markdown
 <Escalation_Signals>
+
 ## When to Recommend Higher Tier
 
 Escalate when you detect:
-- Task exceeds your complexity boundary
-- Multiple failed attempts (>2)
-- Cross-system dependencies you can't trace
-- Security-sensitive changes
-- Irreversible operations
+
+* Task exceeds your complexity boundary
+
+* Multiple failed attempts (>2)
+
+* Cross-system dependencies you can't trace
+
+* Security-sensitive changes
+
+* Irreversible operations
 
 Output escalation recommendation:
 **ESCALATION RECOMMENDED**: [reason] → Use [higher-tier-agent]
@@ -146,7 +160,7 @@ Output escalation recommendation:
 ### 4. 工具能力层级
 
 | Tool | LOW | MEDIUM | HIGH |
-|------|-----|--------|------|
+| ------ | ----- | -------- | ------ |
 | Read | ✅ | ✅ | ✅ |
 | Glob | ✅ | ✅ | ✅ |
 | Grep | ✅ | ✅ | ✅ |
@@ -165,37 +179,54 @@ Output escalation recommendation:
 **基础身份**：战略顾问，只读顾问，诊断而非实现
 
 | 变体 | 模型 | 工具 | 专注点 |
-|---------|-------|-------|-------|
+| --------- | ------- | ------- | ------- |
 | oracle-low | Haiku | Read, Glob, Grep | 快速查找、单文件分析 |
 | oracle-medium | Sonnet | + WebSearch, WebFetch | 标准分析、依赖追踪 |
 | oracle | Opus | 完整读取权限 | 深度架构分析、系统级模式 |
 
 **共享约束**：
-- 禁用 Write/Edit 工具
-- 禁止实现代码
-- 必须引用 file:line 位置
-- 必须提供可操作的建议
+
+* 禁用 Write/Edit 工具
+
+* 禁止实现代码
+
+* 必须引用 file:line 位置
+
+* 必须提供可操作的建议
 
 **层级专属行为**：
 
 ```markdown
+
 ## oracle-low
-- 快速回答直接问题
-- 单文件专注
-- 输出：答案 + 位置 + 上下文（最多 3 行）
-- 升级条件：跨文件依赖、架构问题
+
+* 快速回答直接问题
+
+* 单文件专注
+
+* 输出：答案 + 位置 + 上下文（最多 3 行）
+
+* 升级条件：跨文件依赖、架构问题
 
 ## oracle-medium
-- 标准分析工作流
-- 允许多文件追踪
-- 输出：摘要 + 发现 + 诊断 + 建议
-- 升级条件：系统级影响、安全问题、不可逆变更
+
+* 标准分析工作流
+
+* 允许多文件追踪
+
+* 输出：摘要 + 发现 + 诊断 + 建议
+
+* 升级条件：系统级影响、安全问题、不可逆变更
 
 ## oracle (high)
-- 深度架构分析
-- 系统级模式识别
-- 输出：包含权衡分析的完整结构化分析
-- 无需升级（最高层级）
+
+* 深度架构分析
+
+* 系统级模式识别
+
+* 输出：包含权衡分析的完整结构化分析
+
+* 无需升级（最高层级）
 ```
 
 ### Sisyphus-Junior 家族（执行）
@@ -203,37 +234,54 @@ Output escalation recommendation:
 **基础身份**：专注的执行者，独立工作，禁止委派，TODO 驱动
 
 | 变体 | 模型 | 工具 | 专注点 |
-|---------|-------|-------|-------|
+| --------- | ------- | ------- | ------- |
 | sisyphus-junior-low | Haiku | Read, Glob, Grep, Edit, Write, Bash, TodoWrite | 单文件、简单变更 |
 | sisyphus-junior | Sonnet | 同上 | 多步骤、中等复杂度 |
 | sisyphus-junior-high | Opus | 同上 | 多文件、复杂重构 |
 
 **共享约束**：
-- Task 工具被禁用（禁止委派）
-- 2 步以上任务必须使用 TodoWrite
-- 变更后必须验证
-- 独立工作
+
+* Task 工具被禁用（禁止委派）
+
+* 2 步以上任务必须使用 TodoWrite
+
+* 变更后必须验证
+
+* 独立工作
 
 **层级专属行为**：
 
 ```markdown
+
 ## sisyphus-junior-low
-- 仅限单文件编辑
-- 简单变更（拼写错误、简单添加）
-- 少于 2 步的任务跳过 TodoWrite
-- 升级条件：多文件变更、复杂逻辑、架构决策
+
+* 仅限单文件编辑
+
+* 简单变更（拼写错误、简单添加）
+
+* 少于 2 步的任务跳过 TodoWrite
+
+* 升级条件：多文件变更、复杂逻辑、架构决策
 
 ## sisyphus-junior (medium)
-- 模块内的多步骤任务
-- 标准复杂度
-- 始终使用 TodoWrite
-- 升级条件：系统级变更、跨模块依赖
+
+* 模块内的多步骤任务
+
+* 标准复杂度
+
+* 始终使用 TodoWrite
+
+* 升级条件：系统级变更、跨模块依赖
 
 ## sisyphus-junior-high
-- 多文件重构
-- 复杂架构变更
-- 变更前深度分析
-- 无需升级（咨询请使用 oracle）
+
+* 多文件重构
+
+* 复杂架构变更
+
+* 变更前深度分析
+
+* 无需升级（咨询请使用 oracle）
 ```
 
 ### Frontend-Engineer 家族（UI/UX）
@@ -241,37 +289,54 @@ Output escalation recommendation:
 **基础身份**：设计师与开发者的混合体，能发现纯开发者忽略的问题，创造令人印象深刻的界面
 
 | 变体 | 模型 | 工具 | 专注点 |
-|---------|-------|-------|-------|
+| --------- | ------- | ------- | ------- |
 | frontend-engineer-low | Haiku | Read, Glob, Grep, Edit, Write, Bash | 简单样式、细微调整 |
 | frontend-engineer | Sonnet | 同上 | 标准 UI 工作、组件 |
 | frontend-engineer-high | Opus | 同上 | 设计系统、复杂架构 |
 
 **共享约束**：
-- 禁止使用通用字体（Inter、Roboto、Arial）
-- 禁止使用陈腐模式（紫色渐变）
-- 匹配现有代码模式
-- 生产级输出质量
+
+* 禁止使用通用字体（Inter、Roboto、Arial）
+
+* 禁止使用陈腐模式（紫色渐变）
+
+* 匹配现有代码模式
+
+* 生产级输出质量
 
 **层级专属行为**：
 
 ```markdown
+
 ## frontend-engineer-low
-- 简单 CSS 变更（颜色、间距、字体）
-- 细微组件调整
-- 严格匹配现有模式
-- 升级条件：新组件设计、设计系统变更
+
+* 简单 CSS 变更（颜色、间距、字体）
+
+* 细微组件调整
+
+* 严格匹配现有模式
+
+* 升级条件：新组件设计、设计系统变更
 
 ## frontend-engineer (medium)
-- 标准组件工作
-- 应用设计理念
-- 做出有意图的美学选择
-- 升级条件：设计系统创建、复杂状态管理
+
+* 标准组件工作
+
+* 应用设计理念
+
+* 做出有意图的美学选择
+
+* 升级条件：设计系统创建、复杂状态管理
 
 ## frontend-engineer-high
-- 设计系统架构
-- 复杂组件层次结构
-- 深度美学推理
-- 完全创作自由
+
+* 设计系统架构
+
+* 复杂组件层次结构
+
+* 深度美学推理
+
+* 完全创作自由
 ```
 
 ### Librarian 家族（研究）
@@ -279,30 +344,43 @@ Output escalation recommendation:
 **基础身份**：外部文档专家，搜索外部资源
 
 | 变体 | 模型 | 工具 | 专注点 |
-|---------|-------|-------|-------|
+| --------- | ------- | ------- | ------- |
 | librarian-low | Haiku | Read, Glob, Grep, WebSearch, WebFetch | 快速查找 |
 | librarian | Sonnet | 同上 | 全面研究 |
 
 **共享约束**：
-- 始终引用带 URL 的来源
-- 优先使用官方文档
-- 注明版本兼容性
-- 标记过时信息
+
+* 始终引用带 URL 的来源
+
+* 优先使用官方文档
+
+* 注明版本兼容性
+
+* 标记过时信息
 
 **层级专属行为**：
 
 ```markdown
+
 ## librarian-low
-- 快速 API 查找
-- 查找特定参考资料
-- 输出：答案 + 来源 + 示例（如适用）
-- 升级条件：需要全面研究、需要多个来源
+
+* 快速 API 查找
+
+* 查找特定参考资料
+
+* 输出：答案 + 来源 + 示例（如适用）
+
+* 升级条件：需要全面研究、需要多个来源
 
 ## librarian (medium)
-- 全面研究
-- 多来源综合
-- 完整结构化输出格式
-- 研究任务无需升级
+
+* 全面研究
+
+* 多来源综合
+
+* 完整结构化输出格式
+
+* 研究任务无需升级
 ```
 
 ### Explore 家族（搜索）
@@ -310,30 +388,43 @@ Output escalation recommendation:
 **基础身份**：代码库搜索专家，查找文件和代码模式
 
 | 变体 | 模型 | 工具 | 专注点 |
-|---------|-------|-------|-------|
+| --------- | ------- | ------- | ------- |
 | explore | Haiku | Read, Glob, Grep | 快速搜索 |
 | explore (model=sonnet) | Sonnet | 同上 | 深度分析 |
 
 **共享约束**：
-- 只读
-- 始终使用绝对路径
-- 返回结构化结果
-- 满足底层需求，而非仅字面请求
+
+* 只读
+
+* 始终使用绝对路径
+
+* 返回结构化结果
+
+* 满足底层需求，而非仅字面请求
 
 **层级专属行为**：
 
 ```markdown
+
 ## explore (low)
-- 快速模式匹配
-- 文件定位
-- 并行工具调用（3 个以上）
-- 升级条件：需要架构理解、跨模块分析
+
+* 快速模式匹配
+
+* 文件定位
+
+* 并行工具调用（3 个以上）
+
+* 升级条件：需要架构理解、跨模块分析
 
 ## explore (model=sonnet)
-- 深度分析
-- 交叉引用发现
-- 解释关系
-- 无需升级
+
+* 深度分析
+
+* 交叉引用发现
+
+* 解释关系
+
+* 无需升级
 ```
 
 ## 所需实现变更
@@ -347,7 +438,7 @@ Output escalation recommendation:
 name: [agent]-[tier]
 description: [tier-specific description]
 tools: [restricted tool list]
-model: [haiku|sonnet|opus]
+model: [haiku | sonnet | opus]
 ---
 
 <Inherits_From>
@@ -374,23 +465,29 @@ When you detect tasks beyond your scope, output:
 ### 2. 更新 TypeScript 路由器
 
 路由器应：
-- 从 markdown 解析 agent 能力
-- 将任务信号匹配到层级边界
-- 在输出中提供升级建议
+
+* 从 markdown 解析 agent 能力
+
+* 将任务信号匹配到层级边界
+
+* 在输出中提供升级建议
 
 ### 3. 添加升级检测
 
 编排器应：
-- 检测 agent 输出中的 "ESCALATION RECOMMENDED"
-- 自动用推荐的更高层级重试
-- 记录升级模式以优化路由
+
+* 检测 agent 输出中的 "ESCALATION RECOMMENDED"
+
+* 自动用推荐的更高层级重试
+
+* 记录升级模式以优化路由
 
 ## 成本影响分析
 
 基于当前定价（Haiku $1/$5，Sonnet $3/$15，Opus $5/$25，每百万 token）：
 
 | 场景 | 之前（全部 Sonnet） | 之后（分层） | 节省 |
-|----------|---------------------|----------------|---------|
+| ---------- | --------------------- | ---------------- | --------- |
 | 简单查找（70%） | $3/$15 | $1/$5 (Haiku) | ~67% |
 | 标准工作（25%） | $3/$15 | $3/$15 (Sonnet) | 0% |
 | 复杂工作（5%） | $3/$15 | $5/$25 (Opus) | -67% |

package/docs/TUTORIAL.md

@@ -20,6 +20,7 @@
 ## 场景 1: 环境验证与配置
 
 ### 目标
+
 验证 ultrapower 安装正确，配置基本环境。
 
 ### 步骤
@@ -48,15 +49,19 @@
 ```
 
 ### 验证
-- [ ] omc-doctor 显示全部 ✅
-- [ ] 能看到 50+ agents 列表
-- [ ] 能看到 70+ skills 列表
+
+* [ ] omc-doctor 显示全部 ✅
+
+* [ ] 能看到 50+ agents 列表
+
+* [ ] 能看到 70+ skills 列表
 
 ---
 
 ## 场景 2: 使用第一个 agent（executor）
 
 ### 目标
+
 学习如何调用 agent 执行代码任务。
 
 ### 步骤
@@ -90,15 +95,19 @@ describe('add', () => {
 ```
 
 ### 验证
-- [ ] 函数代码已生成
-- [ ] 测试代码已生成
-- [ ] 测试通过
+
+* [ ] 函数代码已生成
+
+* [ ] 测试代码已生成
+
+* [ ] 测试通过
 
 ---
 
 ## 场景 3: 创建自定义 skill
 
 ### 目标
+
 学习如何创建自定义 skill。
 
 ### 步骤
@@ -110,14 +119,17 @@ mkdir -p skills/my-skill
 
 **3.2 创建 SKILL.md**
 ```markdown
+
 # My Custom Skill
 
 触发词: "my-skill"
 
 ## 描述
+
 这是我的第一个自定义 skill。
 
 ## 执行逻辑
+
 1. 读取用户输入
 2. 调用 executor agent
 3. 返回结果
@@ -129,15 +141,19 @@ mkdir -p skills/my-skill
 ```
 
 ### 验证
-- [ ] skill 文件已创建
-- [ ] skill 可以被触发
-- [ ] skill 执行成功
+
+* [ ] skill 文件已创建
+
+* [ ] skill 可以被触发
+
+* [ ] skill 执行成功
 
 ---
 
 ## 场景 4: 配置 hook 自动化
 
 ### 目标
+
 学习如何配置 hook 实现自动化。
 
 ### 步骤
@@ -155,10 +171,13 @@ mkdir -p skills/my-skill
 
 **4.2 测试 hook**
 ```
+
 # 编辑任意文件
+
 Edit(file_path="test.ts", old_string="...", new_string="...")
 
 # hook 会自动运行 prettier
+
 ```
 
 **4.3 验证 hook 执行**
@@ -167,15 +186,19 @@ cat .omc/logs/hook-execution.log
 ```
 
 ### 验证
-- [ ] hook 配置已创建
-- [ ] 编辑文件后 hook 自动触发
-- [ ] 文件已格式化
+
+* [ ] hook 配置已创建
+
+* [ ] 编辑文件后 hook 自动触发
+
+* [ ] 文件已格式化
 
 ---
 
 ## 场景 5: 团队协作模式（team）
 
 ### 目标
+
 学习如何使用 team 模式进行多 agent 协作。
 
 ### 步骤
@@ -197,14 +220,20 @@ TaskList()
 
 **5.4 查看执行结果**
 ```
+
 # team 会自动完成所有阶段
+
 # 最终输出验证报告
+
 ```
 
 ### 验证
-- [ ] team 模式启动成功
-- [ ] 所有阶段顺序执行
-- [ ] 最终状态为 complete
+
+* [ ] team 模式启动成功
+
+* [ ] 所有阶段顺序执行
+
+* [ ] 最终状态为 complete
 
 ---
 
@@ -212,9 +241,11 @@ TaskList()
 
 恭喜完成教程！你现在可以：
 
-- 查看 [USER_GUIDE.md](USER_GUIDE.md) 了解更多功能
-- 查看 [REFERENCE.md](REFERENCE.md) 获取完整参考
-- 加入社区讨论：[GitHub Discussions](https://github.com/liangjie559567/ultrapower/discussions)
+* 查看 [USER_GUIDE.md](USER_GUIDE.md) 了解更多功能
+
+* 查看 [REFERENCE.md](REFERENCE.md) 获取完整参考
+
+* 加入社区讨论：[GitHub Discussions](https://github.com/liangjie559567/ultrapower/discussions)
 
 ---