subagent-orchestrator

通过主控制器持续运行任务流水线，而非偶然为之。

核心规则

1. 将 autopilot 视为一条连续流水线

   • 不可在“单次运行完成”时停止。
   • 一次运行完成意味着交接，而非“整条流水线结束”。
   • 持续执行，直至满足以下任一条件：整条流水线完成、被阻塞、被用户暂停。

2. 主控制器必须主动重新分派

   • 不得等待用户提醒才继续。
   • 对每条 autopilot 流水线，主控制器需自行决定下一个子任务切片，并立即启动对应角色。

3. 保持任务看板实时更新

   • 在分派下一轮前或分派时，同步更新 AGENT_TASK_BOARD.md。
   • 需记录：目标、当前轮次、已完成项、剩余项、下一子切片、后续角色。

4. 保持子代理回复简洁

   • 优先包含：目标 / 已完成项 / 文件 / 状态 / 下一步 / 风险。
   • 避免冗长的背景复述。

5. 清理已完成会话，但保留记忆

   • 已完成的子代理会话无需长期保留。
   • 在遗忘前，须将持久化记录写入 memory/YYYY-MM-DD.md。
   • 至少包含：任务目标、变更文件、结果状态、风险、下一步动作。
   • 必要时，将稳定的协作规则提升至 MEMORY.md。

6. 不保留不必要的中间产物

   • 临时截图、临时文件及中间输出，在不再需要时可直接删除。
   • 若用户需要截图作为凭证，优先直接发送，而非长期本地保存。

角色路由

请勿将项目特定的模型规则硬编码到本技能中。

除非用户或项目规则明确覆盖，否则一律使用当前会话默认配置。若某项目存在角色专属的模型偏好，请将其存于项目记忆、任务看板规则或项目文档中——而非作为通用编排器行为。

分派模式

当一条 autopilot 流水线处于激活状态时：

1. 从 AGENT_TASK_BOARD.md 读取当前流水线
2. 选取下一个小型封闭式子切片
3. 启动对应角色
4. 要求返回结构化短报告
5. 完成时：
   • 向用户摘要说明
   • 更新记忆
   • 如不再需要，清理已完成会话
   • 若流水线仍处于激活状态，则立即分派下一子切片

跨角色协同

跨角色依赖模式

当某一角色为另一角色创建了依赖关系时：

• 产出角色必须在 next_role 字段中显式指明后续角色
• 主控制器应自动分派该后续角色，无需等待用户重申
• 不得让相互依赖的任务流水线脱节

示例：

• research → UI integration
• code logic → validation
• code structure → UI presentation

验证（validation）

验证是一个典型的后续角色，通常不作为主流水线。 应在以下情形后触发：

• 一个有意义的 UI 子切片完成后
• 一个有意义的代码子切片完成后
• 用户明确提出需提供证明/检查时

返回协议

请将标准协议维护在 references/SUBAGENT_RECORD_PROTOCOL.md 中，并与本技能配合使用。

要求子代理在短报告正文前包含如下头部字段：

• tag: 取值范围为 autopilot | done | idle | blocked | handoff | need_user 之一
• line: 任务流水线名称，例如 ui-autopilot、code-autopilot、scout-art、archive-worldview
• node: 当前任务流水线节点 ID，例如 code-n4、ui-n5
• goal_status: 仅允许使用 partial | complete | waiting | blocked（禁止自造值，如 half_done、in_progress、done）
• next_role: 自由格式的下一负责人/角色标签，例如 ui、code、verify、research、archive、user、none，或任意项目自定义角色名

随后使用短正文（完整配对格式详见 references/SUBAGENT_RECORD_PROTOCOL.md）：

1. 目标
2. 已完成项（最多 3–4 条）
3. 变更文件
4. 状态
5. 下一步
6. 风险

tag 含义说明

• autopilot：本轮完成，但整条流水线很可能尚未结束；主控制器须比对任务看板，决定继续或关闭
• done：整条流水线已全部完成
• idle：该角色正在等待其他流水线或条件就绪；暂不推进此角色
• blocked：该流水线无法安全地自动继续
• handoff：本轮完成，且下一角色已明确指定
• need_user：需用户做出决策后，方可安全继续

主控制器决策规则

当子代理返回响应时：

1. 若 tag=done

   • 关闭该流水线
   • 写入记忆
   • 清理已完成会话

2. 若 tag=autopilot

   • 比对 AGENT_TASK_BOARD.md
   • 解析当前 line 与 node
   • 忽略正文中模糊的“单次完成”类表述
   • 若 node != end_node，则须在同一控制周期内立即分派下一节点
   • 仅当 current_node == end_node 且流水线完成条件实际达成时，才可关闭流水线

防丢守卫（Anti-drop guard）

对每次 autopilot 返回，主控制器必须同时验证以下三点：

• 该流水线确实在任务看板中存在
• 该流水线尚未标记为完成
• 要么已发出下一阶段分派，要么该流水线已被显式转为 idle、blocked、need_user 或 done

若上述任一条件未满足，则本次控制周期视为不完整，不得视为结束。

更严格的续行规则

局部子切片完成不足以**终止整条流水线**。 不得将诸如“本小闭环已完成”、“本轮通过”、“该模块已完成”等表述视为暂停许可。