team-executor

Team Executor

轻量级会话执行技能：加载会话 -> 协调状态 -> 启动 team-worker Agent -> 执行 -> 交付。不进行分析，不生成角色——只执行现有的 team-coordinate 会话。

架构

+---------------------------------------------------+
|  Skill(skill="team-executor")                      |
|  args="--session=<path>" [REQUIRED]                |
+-------------------+-------------------------------+
                    | Session Validation
         +---- --session valid? ----+
         | NO                       | YES
         v                          v
    Error immediately          Orchestration Mode
    (no session)               -> executor
                                    |
                    +-------+-------+-------+
                    v       v       v       v
                 [team-worker agents loaded from session role-specs]

---

会话验证（路由前）

重要：必须在任何执行开始前验证会话。

解析参数

从 $ARGUMENTS 中提取：

• --session=<path>：team-coordinate 会话文件夹的路径（必需）

验证步骤

1. 检查是否提供了 --session：

   • 如果缺失 -> 错误：“需要提供会话。用法：--session=”

2. 验证会话结构（参见 specs/session-schema.md）：

   • 路径下的目录存在
   • team-session.json 存在且为有效 JSON
   • task-analysis.json 存在且为有效 JSON
   • role-specs/ 目录至少包含一个 .md 文件
   • team-session.json#roles 中的每个角色在 role-specs/ 中都有对应的 .md 文件

3. 验证失败时：

   • 报告具体缺失的组件
   • 建议重新运行 team-coordinate 或检查路径

---

角色路由器

此技能仅用于执行。工作者不会调用此技能——而是直接以 team-worker Agent 的形式启动。

分派逻辑

情况	操作
未提供 --session	立即报错
--session 无效	报错并说明具体原因
会话有效	编排模式 -> executor

编排模式

调用：Skill(skill="team-executor", args="--session=<session-folder>")

生命周期：

Validate session
  -> executor Phase 0: Reconcile state (reset interrupted, detect orphans)
  -> executor Phase 1: Spawn first batch team-worker agents (background) -> STOP
  -> Worker executes -> SendMessage callback -> executor advances next step
  -> Loop until pipeline complete -> Phase 2 report + completion action

用户命令（唤醒暂停的执行器）：

命令	操作
check / status	输出执行状态图，不推进执行
resume / continue	检查工作者状态，推进下一步

---

角色注册表

角色	文件	类型
executor	roles/executor/role.md	内置编排器
（动态）	<session>/role-specs/<role-name>.md	从会话加载

---

执行器启动模板

v2 工作者启动（所有角色）

执行器启动工作者时，使用 team-worker Agent 和角色规格路径：

Agent({
  subagent_type: "team-worker",
  description: "Spawn <role> worker",
  team_name: <team-name>,
  name: "<role>",
  run_in_background: true,
  prompt: `## Role Assignment
role: <role>
role_spec: <session-folder>/role-specs/<role>.md
session: <session-folder>
session_id: <session-id>
team_name: <team-name>
requirement: <task-description>
inner_loop: <true|false>

## Progress Milestones
session_id: <session-id>
Report progress via team_msg at natural phase boundaries (context loaded -> core work done -> verification).
Report blockers immediately via team_msg type="blocker".
Report completion via team_msg type="task_complete" after final SendMessage.

Read role_spec file to load Phase 2-4 domain instructions.`
})

---

完成操作

当流水线完成（所有任务均已完成）时，执行器会显示交互式选项：

AskUserQuestion({
  questions: [{
    question: "Team pipeline complete. What would you like to do?",
    header: "Completion",
    multiSelect: false,
    options: [
      { label: "Archive & Clean (Recommended)", description: "Archive session, clean up team" },
      { label: "Keep Active", description: "Keep session for follow-up work" },
      { label: "Export Results", description: "Export deliverables to target directory, then clean" }
    ]
  }]
})

操作处理程序

选项	步骤
归档并清理	更新会话状态为 status="completed" -> TeamDelete -> 输出包含制品路径的最终摘要
保持活动	更新会话状态为 status="paused" -> 输出：“通过以下命令恢复：Skill(skill='team-executor', args='--session=')”
导出结果	AskUserQuestion(target path) -> 将制品复制到目标路径 -> 归档并清理

---

与 team-coordinate 集成

情况	技能
新任务，没有会话	team-coordinate
现有会话，恢复执行	team-executor
会话需要新角色	team-coordinate（带 resume）
纯执行，不进行分析	team-executor

---

错误处理

情况	解决方案
未提供 --session	立即报错并显示用法消息
找不到会话目录	报错并显示路径，建议检查路径
缺少 team-session.json	报错，会话不完整，建议重新运行 team-coordinate
缺少 task-analysis.json	报错，会话不完整，建议重新运行 team-coordinate
会话中没有 role-specs	报错，会话不完整，建议重新运行 team-coordinate
找不到角色规格文件	报错并显示预期路径
报告了 capability_gap	仅警告，无法生成新的角色规格
快速推进启动了错误任务	执行器在下一次回调时协调状态
完成操作失败	默认选择“保持活动”，记录警告