前置

架构

分层

层级组成主要职责
L0 用户与业务边界用户意图、授权、业务约束给出目标、约束和需要批准的高风险动作
L1 控制层Orchestrator理解目标、判断复杂度、制定任务图、选择 Agent、授权、验收、整合和交付
L2 专业层14 个 Subagent在明确职责和权限内执行专业子任务
L3 流程与知识层Subgraph、Hard Skill、Soft Skill、LoreBook复用稳定流程、封装专业 SOP、按需加载知识
L4 执行与治理层Tools、Runtime Policy、State、Trace、Evaluation提供真实执行能力、强制权限、持久化状态、审计和评测

Orchestrator 调度 14 个内置 Subagent。委派由 Orchestrator 发出;Subagent 不自行 Spawn、Fork,也不再往下委派。权限由 Runtime 在执行时强制,完成由 Orchestrator 按验收条件确认。

关系

flowchart TB
 U[用户目标 / 约束 / 授权]
 O[Orchestrator<br/>唯一主控与最终验收者]
 R[Routing & Task Planner]
 W[Workflow / Subgraph]
 A1[general-purpose]
 A2[researcher]
 A3[math-researcher]
 A4[explorer]
 A5[planner]
 A6[coder]
 A7[tester]
 A8[reviewer]
 A9[debugger]
 A10[security-auditor]
 A11[data-analyst]
 A12[scientist]
 A13[technical-writer]
 A14[architect]
 P[Runtime Policy Engine]
 T[Tools / MCP / Files / Shell]
 S[Sandbox / ACL / Network Egress]
 X[Decision Trace + Execution Trace + Evals]

 U --> O
 O --> R
 R --> W
 W --> A1
 W --> A2
 W --> A3
 W --> A4
 W --> A5
 W --> A6
 W --> A7
 W --> A8
 W --> A9
 W --> A10
 W --> A11
 W --> A12
 W --> A13
 W --> A14
 A1 --> P
 A2 --> P
 A3 --> P
 A4 --> P
 A5 --> P
 A6 --> P
 A7 --> P
 A8 --> P
 A9 --> P
 A10 --> P
 A11 --> P
 A12 --> P
 A13 --> P
 A14 --> P
 P --> S
 S --> T
 T --> X
 X --> O
 O --> U

用户目标进入 Orchestrator。Orchestrator 经路由和 Subgraph 把任务分给 Subagent。Subagent 的工具调用先过 Runtime Policy 和沙箱,再触及工具、文件和 Shell。Trace 回到 Orchestrator,由它向用户交付。

Orchestrator

Orchestrator 在 14 个 Subagent 之外。它决定委派、权限范围和是否验收。调度和工具权限分开算,它不默认拥有全部工具。

每个任务有一个 Owner。其他 Agent 可以提供输入。顶层任务的 Owner 是 Orchestrator。

  • 识别用户目标、交付物、约束、风险和未明确条件。
  • 判断是否委派,以及复杂度等级。
  • 选择足够完成任务的最少 Agent。
  • 把复杂目标分解成有依赖的子任务 DAG。
  • 为每个子任务写明目标、输入、输出、验收标准和预算。
  • 算出最小权限集合,请求 Runtime 建立执行会话。
  • 管理并行任务、文件锁、工作区和冲突。
  • 按工具的实际结果、交付物和验收标准核验子 Agent 的结果。
  • 对失败、阻塞、权限拒绝和部分完成做恢复或重新规划。重试次数见预算。
  • 整合成果,写明来源、假设、限制和未完成项,交给用户。

角色

Work mode 是能力上限。每次委派由任务级 Capability Filter 再收紧。

IDSubagent专业方向职责默认 Work mode默认网络
01general-purpose通用执行处理没有明显专业归属的轻量任务rooff
02researcher外部研究网络检索、来源验证、技术和资料调研roon(受限)
03math-researcher数学研究数学推导、证明、计算与数值验证swoff
04explorer内部探索代码库、文件、依赖、调用关系和项目事实rooff
05planner执行规划任务分解、依赖、顺序、里程碑和验收条件ploff
06coder软件实现功能实现、代码修改、重构和修复swoff
07tester测试验证测试设计、执行、回归和结果分析swoff
08reviewer独立质量审查代码、逻辑、设计和可维护性审查rooff
09debugger故障诊断复现、日志分析、根因和性能诊断rooff
10security-auditor安全审计威胁建模、漏洞分析、权限和安全配置审查rooff(按需开只读情报源)
11data-analyst数据分析数据质量、统计、建模、可视化和解释swoff
12scientist科学研究科学问题、假设、机制、模型和实验设计swoff
13technical-writer技术写作技术文档、规范、报告和知识交付swoff
14architect系统架构架构设计、技术选型、接口和系统演进ploff

每次委派可以附上逻辑权限,在该次任务的 capability 之上按路径收紧资源访问。