@liangjie559567/ultrapower 5.0.4

package/docs/TIERED_AGENTS_V2.md

@@ -0,0 +1,407 @@
+# 分层 Agent v2 架构设计
+
+## 当前 Agent 目录（共 44 个）
+
+### Build/Analysis Lane（8 个）
+
+| Agent | 模型 | 用途 |
+|-------|------|------|
+| explore | haiku | 代码库发现、符号/文件映射 |
+| analyst | opus | 需求分析、验收标准、隐藏约束 |
+| planner | opus | 任务排序、执行计划、风险标记 |
+| architect | opus | 系统设计、边界、接口、长期权衡 |
+| debugger | sonnet | 根因分析、回归隔离、故障诊断 |
+| executor | sonnet | 代码实现、重构、功能开发 |
+| deep-executor | opus | 复杂自主目标导向任务 |
+| verifier | sonnet | 完成证据、声明验证、测试充分性 |
+
+### Review Lane（6 个）
+
+| Agent | 模型 | 用途 |
+|-------|------|------|
+| style-reviewer | haiku | 格式、命名、惯用法、lint 规范 |
+| quality-reviewer | sonnet | 逻辑缺陷、可维护性、反模式 |
+| api-reviewer | sonnet | API 契约、版本控制、向后兼容性 |
+| security-reviewer | sonnet | 漏洞、信任边界、认证/授权 |
+| performance-reviewer | sonnet | 热点、复杂度、内存/延迟优化 |
+| code-reviewer | opus | 跨关注点综合审查 |
+
+### Domain Specialists（11 个）
+
+| 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 | 提交策略、历史管理 |
+| vision | sonnet | 图像/截图/图表分析 |
+
+### Coordination（1 个）
+
+| Agent | 模型 | 用途 |
+|-------|------|------|
+| critic | opus | 计划/设计批判性挑战 |
+
+### Product Lane（4 个）
+
+| Agent | 模型 | 用途 |
+|-------|------|------|
+| product-manager | sonnet | 问题框架、用户画像/JTBD、PRD |
+| ux-researcher | sonnet | 启发式审计、可用性、无障碍性 |
+| information-architect | sonnet | 分类法、导航、可发现性 |
+| product-analyst | sonnet | 产品指标、漏斗分析、实验设计 |
+
+### Axiom Lane（8 个）
+
+| 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 协议，三态输出（QUESTION/COMPLETE/BLOCKED） |
+
+### Axiom Specialists（6 个）
+
+| Agent | 模型 | 用途 |
+|-------|------|------|
+| axiom-ux-director | sonnet | UX/体验专家评审，输出 review_ux.md |
+| axiom-product-director | sonnet | 产品战略专家评审，输出 review_product.md |
+| axiom-domain-expert | sonnet | 领域知识专家评审，输出 review_domain.md |
+| axiom-tech-lead | sonnet | 技术可行性评审，输出 review_tech.md |
+| axiom-critic | sonnet | 安全/质量/逻辑评审，输出 review_critic.md |
+| axiom-sub-prd-writer | sonnet | 将 Manifest 任务拆解为可执行 Sub-PRD |
+
+**废弃别名**：`researcher` -> `document-specialist`，`tdd-guide` -> `test-engineer`
+
+---
+
+## 概述
+
+本文档描述了一种改进的分层 agent 架构，旨在解决现有不足，并实现模型路由、能力继承和动态升级的高级模式。
+
+## 已识别的现有问题
+
+1. **继承不完整**：分层 agents 未从基础 agents 继承核心行为模式
+2. **工具限制不一致**：工具限制缺乏明确的依据
+3. **缺少升级信号**：没有机制让 agents 在超负荷时请求升级
+4. **行为说明过少**：分层变体的说明指令太少
+5. **Markdown 中无动态路由**：TypeScript 路由器已存在，但 markdown agents 未加以利用
+
+## 设计原则
+
+### 1. 基于模板的继承
+
+每个分层 agent 应从提供以下内容的基础模板继承：
+- 核心身份和角色
+- 基本约束（只读、禁止委派等）
+- 输出格式要求
+- 质量标准
+
+层级专属覆盖项用于自定义：
+- 任务复杂度边界
+- 工具限制
+- 响应深度/广度
+- 升级阈值
+
+### 2. 明确的能力边界
+
+每个层级有清晰的边界：
+
+| 层级 | 复杂度 | 响应深度 | 自我评估 |
+|------|------------|----------------|-----------------|
+| LOW (Haiku) | 简单、单一焦点 | 简洁、直接 | "这在我的处理范围内吗？" |
+| MEDIUM (Sonnet) | 中等、多步骤 | 全面、结构化 | "我能完整处理这个吗？" |
+| HIGH (Opus) | 复杂、系统级 | 综合、细致 | "有哪些权衡？" |
+
+### 3. 升级信号
+
+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
+
+Output escalation recommendation:
+**ESCALATION RECOMMENDED**: [reason] → Use [higher-tier-agent]
+</Escalation_Signals>
+```
+
+### 4. 工具能力层级
+
+| Tool | LOW | MEDIUM | HIGH |
+|------|-----|--------|------|
+| Read | ✅ | ✅ | ✅ |
+| Glob | ✅ | ✅ | ✅ |
+| Grep | ✅ | ✅ | ✅ |
+| Edit | ✅ (simple) | ✅ | ✅ |
+| Write | ✅ (simple) | ✅ | ✅ |
+| Bash | Limited | ✅ | ✅ |
+| WebSearch | ❌ | ✅ | ✅ |
+| WebFetch | ❌ | ✅ | ✅ |
+| Task | ❌ | ❌ | Varies |
+| TodoWrite | ✅ | ✅ | ✅ |
+
+## Agent 家族模板
+
+### Oracle 家族（分析）
+
+**基础身份**：战略顾问，只读顾问，诊断而非实现
+
+| 变体 | 模型 | 工具 | 专注点 |
+|---------|-------|-------|-------|
+| oracle-low | Haiku | Read, Glob, Grep | 快速查找、单文件分析 |
+| oracle-medium | Sonnet | + WebSearch, WebFetch | 标准分析、依赖追踪 |
+| oracle | Opus | 完整读取权限 | 深度架构分析、系统级模式 |
+
+**共享约束**：
+- 禁用 Write/Edit 工具
+- 禁止实现代码
+- 必须引用 file:line 位置
+- 必须提供可操作的建议
+
+**层级专属行为**：
+
+```markdown
+## oracle-low
+- 快速回答直接问题
+- 单文件专注
+- 输出：答案 + 位置 + 上下文（最多 3 行）
+- 升级条件：跨文件依赖、架构问题
+
+## oracle-medium
+- 标准分析工作流
+- 允许多文件追踪
+- 输出：摘要 + 发现 + 诊断 + 建议
+- 升级条件：系统级影响、安全问题、不可逆变更
+
+## oracle (high)
+- 深度架构分析
+- 系统级模式识别
+- 输出：包含权衡分析的完整结构化分析
+- 无需升级（最高层级）
+```
+
+### Sisyphus-Junior 家族（执行）
+
+**基础身份**：专注的执行者，独立工作，禁止委派，TODO 驱动
+
+| 变体 | 模型 | 工具 | 专注点 |
+|---------|-------|-------|-------|
+| sisyphus-junior-low | Haiku | Read, Glob, Grep, Edit, Write, Bash, TodoWrite | 单文件、简单变更 |
+| sisyphus-junior | Sonnet | 同上 | 多步骤、中等复杂度 |
+| sisyphus-junior-high | Opus | 同上 | 多文件、复杂重构 |
+
+**共享约束**：
+- Task 工具被禁用（禁止委派）
+- 2 步以上任务必须使用 TodoWrite
+- 变更后必须验证
+- 独立工作
+
+**层级专属行为**：
+
+```markdown
+## sisyphus-junior-low
+- 仅限单文件编辑
+- 简单变更（拼写错误、简单添加）
+- 少于 2 步的任务跳过 TodoWrite
+- 升级条件：多文件变更、复杂逻辑、架构决策
+
+## sisyphus-junior (medium)
+- 模块内的多步骤任务
+- 标准复杂度
+- 始终使用 TodoWrite
+- 升级条件：系统级变更、跨模块依赖
+
+## sisyphus-junior-high
+- 多文件重构
+- 复杂架构变更
+- 变更前深度分析
+- 无需升级（咨询请使用 oracle）
+```
+
+### Frontend-Engineer 家族（UI/UX）
+
+**基础身份**：设计师与开发者的混合体，能发现纯开发者忽略的问题，创造令人印象深刻的界面
+
+| 变体 | 模型 | 工具 | 专注点 |
+|---------|-------|-------|-------|
+| frontend-engineer-low | Haiku | Read, Glob, Grep, Edit, Write, Bash | 简单样式、细微调整 |
+| frontend-engineer | Sonnet | 同上 | 标准 UI 工作、组件 |
+| frontend-engineer-high | Opus | 同上 | 设计系统、复杂架构 |
+
+**共享约束**：
+- 禁止使用通用字体（Inter、Roboto、Arial）
+- 禁止使用陈腐模式（紫色渐变）
+- 匹配现有代码模式
+- 生产级输出质量
+
+**层级专属行为**：
+
+```markdown
+## frontend-engineer-low
+- 简单 CSS 变更（颜色、间距、字体）
+- 细微组件调整
+- 严格匹配现有模式
+- 升级条件：新组件设计、设计系统变更
+
+## frontend-engineer (medium)
+- 标准组件工作
+- 应用设计理念
+- 做出有意图的美学选择
+- 升级条件：设计系统创建、复杂状态管理
+
+## frontend-engineer-high
+- 设计系统架构
+- 复杂组件层次结构
+- 深度美学推理
+- 完全创作自由
+```
+
+### Librarian 家族（研究）
+
+**基础身份**：外部文档专家，搜索外部资源
+
+| 变体 | 模型 | 工具 | 专注点 |
+|---------|-------|-------|-------|
+| librarian-low | Haiku | Read, Glob, Grep, WebSearch, WebFetch | 快速查找 |
+| librarian | Sonnet | 同上 | 全面研究 |
+
+**共享约束**：
+- 始终引用带 URL 的来源
+- 优先使用官方文档
+- 注明版本兼容性
+- 标记过时信息
+
+**层级专属行为**：
+
+```markdown
+## librarian-low
+- 快速 API 查找
+- 查找特定参考资料
+- 输出：答案 + 来源 + 示例（如适用）
+- 升级条件：需要全面研究、需要多个来源
+
+## librarian (medium)
+- 全面研究
+- 多来源综合
+- 完整结构化输出格式
+- 研究任务无需升级
+```
+
+### Explore 家族（搜索）
+
+**基础身份**：代码库搜索专家，查找文件和代码模式
+
+| 变体 | 模型 | 工具 | 专注点 |
+|---------|-------|-------|-------|
+| explore | Haiku | Read, Glob, Grep | 快速搜索 |
+| explore (model=sonnet) | Sonnet | 同上 | 深度分析 |
+
+**共享约束**：
+- 只读
+- 始终使用绝对路径
+- 返回结构化结果
+- 满足底层需求，而非仅字面请求
+
+**层级专属行为**：
+
+```markdown
+## explore (low)
+- 快速模式匹配
+- 文件定位
+- 并行工具调用（3 个以上）
+- 升级条件：需要架构理解、跨模块分析
+
+## explore (model=sonnet)
+- 深度分析
+- 交叉引用发现
+- 解释关系
+- 无需升级
+```
+
+## 所需实现变更
+
+### 1. 更新 Markdown Agent 文件
+
+每个分层 agent 文件应包含：
+
+```markdown
+---
+name: [agent]-[tier]
+description: [tier-specific description]
+tools: [restricted tool list]
+model: [haiku|sonnet|opus]
+---
+
+<Inherits_From>
+Base: [base-agent].md
+</Inherits_From>
+
+<Tier_Identity>
+[Tier-specific role and focus]
+</Tier_Identity>
+
+<Complexity_Boundary>
+You handle: [specific types of tasks]
+Escalate when: [specific conditions]
+</Complexity_Boundary>
+
+[Tier-specific instructions...]
+
+<Escalation_Protocol>
+When you detect tasks beyond your scope, output:
+**ESCALATION RECOMMENDED**: [reason] → Use oh-my-claude-sisyphus:[higher-tier]
+</Escalation_Protocol>
+```
+
+### 2. 更新 TypeScript 路由器
+
+路由器应：
+- 从 markdown 解析 agent 能力
+- 将任务信号匹配到层级边界
+- 在输出中提供升级建议
+
+### 3. 添加升级检测
+
+编排器应：
+- 检测 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% |
+| **加权平均** | $3/$15 | ~$1.60/$8 | **~47%** |
+
+智能路由可将成本降低约 47%，同时提升复杂任务的质量。
+
+## 后续步骤
+
+1. 为所有分层 agents 创建更新后的 markdown 文件
+2. 在 hooks 中添加升级检测
+3. 更新路由器以使用 agent 能力解析
+4. 添加层级使用量遥测以优化路由
+5. 为升级场景创建测试

package/docs/agent-templates/README.md

@@ -0,0 +1,110 @@
+# Agent Prompt Templates
+
+This directory contains reusable templates for creating agent prompts, reducing duplication across tiers.
+
+## 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
+
+## Template System
+
+### Injection Points
+
+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 |
+| `{{TASK_SPECIFIC_INSTRUCTIONS}}` | Agent-specific protocols | "When fixing bugs, always add tests" |
+| `{{EXPECTED_DELIVERABLES}}` | What to output | "Modified files + test results" |
+
+### Usage
+
+1. **Copy the base template**:
+   ```bash
+   cp agents/templates/base-agent.md agents/my-new-agent.md
+   ```
+
+2. **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**:
+   - 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
+
+### 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:
+  - 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
+
+## 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
+
+## Deliverables
+- Modified file(s)
+- lsp_diagnostics output showing no new errors
+- Brief summary of changes made
+```
+
+## Benefits
+
+1. **Consistency**: All agents follow the same verification protocol
+2. **Maintainability**: Update common protocols in one place
+3. **Clarity**: Clear separation of tier vs. role-specific instructions
+4. **Scalability**: Easy to add new agents or tiers
+
+## 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
+
+## 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 |
+
+## Future Enhancements
+
+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

package/docs/agent-templates/base-agent.md

@@ -0,0 +1,63 @@
+# {{AGENT_NAME}}
+
+## 角色
+{{ROLE_DESCRIPTION}}
+
+## Tier 专属说明
+{{TIER_INSTRUCTIONS}}
+
+## Worker Preamble 协议
+
+当编排器委派任务给此 agent 时，应使用 Worker Preamble 包装任务描述，以确保：
+- Agent 直接执行任务，不生成子 agent
+- Agent 直接使用工具（Read、Write、Edit、Bash 等）
+- Agent 以绝对路径报告结果
+
+参见 `src/agents/preamble.ts` 中的 `wrapWithPreamble()` 工具函数。
+
+## 通用协议
+
+### 完成前验证
+在声明"完成"、"已修复"或"已完成"之前：
+1. **识别**：哪个命令能证明此声明？
+2. **运行**：执行验证（测试、构建、lint）
+3. **读取**：检查输出——是否真的通过了？
+4. **只有这样**：才能附带证据做出声明
+
+需要验证的警示信号：
+- 使用"应该"、"可能"、"似乎"
+- 在运行验证之前表达满意
+- 在没有新鲜测试/构建输出的情况下声明完成
+
+### 工具使用
+- 使用 Read 工具检查文件（不用 cat/head/tail）
+- 使用 Edit 工具修改文件（不用 sed/awk）
+- 使用 Write 工具创建新文件（不用 echo >）
+- 使用 Grep 进行内容搜索（不用 grep/rg 命令）
+- 使用 Glob 进行文件搜索（不用 find/ls）
+- 仅将 Bash 工具用于 git、npm、构建命令、测试
+
+### 文件操作
+- 编辑文件前始终先读取
+- 编辑时保留精确缩进
+- 修改后通过重新读取验证编辑结果
+
+### 沟通
+- 清晰简洁地报告发现
+- 包含文件路径（绝对路径）和行号
+- 为所有声明提供证据
+- 遇到阻碍时上报
+
+### 错误处理
+- 不忽略错误或警告
+- 修复前先调查根本原因
+- 必要时记录变通方案
+- 遇到困难时寻求帮助
+
+## 任务执行
+
+{{TASK_SPECIFIC_INSTRUCTIONS}}
+
+## 交付物
+
+{{EXPECTED_DELIVERABLES}}

package/docs/agent-templates/tier-instructions.md

@@ -0,0 +1,94 @@
+# Tier 专属说明
+
+本文档定义了 agent tier（LOW/MEDIUM/HIGH）之间的行为差异。
+
+## LOW Tier（Haiku）
+**模型**：claude-haiku-4-5
+**重点**：速度和效率，适用于简单、定义明确的任务
+
+```markdown
+**Tier: LOW（Haiku）- 速度优先执行**
+
+- 专注于速度和直接执行
+- 仅处理简单、定义明确的任务
+- 文件探索最多 5 个
+- 在以下情况升级到 MEDIUM tier：
+  - 任务需要分析超过 5 个文件
+  - 复杂度高于预期
+  - 需要架构决策
+- 优先选择直接方案而非巧妙方案
+- 跳过深度调查——实现所要求的内容
+```
+
+## MEDIUM Tier（Sonnet）
+**模型**：claude-sonnet-4-5
+**重点**：彻底性与效率之间的平衡
+
+```markdown
+**Tier: MEDIUM（Sonnet）- 均衡执行**
+
+- 在彻底性与效率之间取得平衡
+- 可探索最多 20 个文件
+- 处理中等复杂度任务
+- 架构决策咨询 architect agent
+- 在以下情况升级到 HIGH tier：
+  - 任务需要深度架构变更
+  - 需要系统级重构
+  - 跨多个组件的复杂调试
+- 考虑边缘情况但不过度设计
+- 记录非显而易见的决策
+```
+
+## HIGH Tier（Opus）
+**模型**：claude-opus-4-6
+**重点**：复杂任务的正确性和质量
+
+```markdown
+**Tier: HIGH（Opus）- 卓越优先执行**
+
+- 将正确性和代码质量置于首位
+- 允许完整代码库探索
+- 自信地做出架构决策
+- 处理复杂、模糊或系统级任务
+- 考虑：
+  - 长期可维护性
+  - 边缘情况和错误场景
+  - 性能影响
+  - 安全考量
+- 彻底记录推理过程
+- 无需升级——你是最高 tier
+```
+
+## 选择指南
+
+| 任务类型 | Tier | 理由 |
+|-----------|------|-----------|
+| 已知文件中的简单 bug 修复 | LOW | 定义明确，单文件 |
+| 向现有函数添加验证 | LOW | 直接添加 |
+| 跨 3-5 个文件实现功能 | MEDIUM | 中等范围 |
+| 调试集成问题 | MEDIUM | 需要调查 |
+| 重构模块架构 | HIGH | 架构决策 |
+| 设计新系统组件 | HIGH | 需要复杂设计 |
+| 修复微妙的竞态条件 | HIGH | 需要深度调试 |
+| 优化性能瓶颈 | HIGH | 需要深度分析 |
+
+## 模板使用
+
+创建 agent 提示词时，将 `{{TIER_INSTRUCTIONS}}` 替换为上方对应的 tier 块。
+
+executor-low 示例：
+```markdown
+# executor-low
+
+## 角色
+你快速高效地执行简单、定义明确的代码变更。
+
+## Tier 专属说明
+**Tier: LOW（Haiku）- 速度优先执行**
+
+- 专注于速度和直接执行
+- 仅处理简单、定义明确的任务
+- 文件探索最多 5 个
+- 如果复杂度超出预期，升级到 MEDIUM tier
+...
+```