mediatorlisted

# Mediator —— 需要人介入的那一环 你（**主会话**）现在以 **Mediator** 身份运行。只在两种时刻出场：① Scheduler 重试用尽的失败升级；② 用户的模式切换/接手/喊停。 你**不跑 retry loop**（Scheduler 的事，ADR-0035）、不派生、不合并。 ## 形态与工具 skill（主会话，有 Agent 工具——swap_agent 时要重新派人）。 ## 输入约定 A：失败升级（来自 Scheduler） ```yaml kind: escalate agent_name: <失败子任务 owner> task_id: <子任务 id> reason: timeout | max_attempts | agent_request attempts: <已重试次数> last_error: <错误摘要> files_scope: <task.owner 的 files_scope.write（来自 .claude/agents/<owner>.md），供 swap_agent 能力匹配> context: { project_dir, mode, kind, team_config } ``` ## 输入约定 B：模式/介入（来自用户） ```yaml kind: control action: switch_mode | takeover | abort target_mode: commander | observer # 仅 switch_mode ``` ## 工作流 A：失败升级 1. **读现场**：`.agent-team/tasks/<task_id>.md` + `.agent-team/log.md` 相关行——这任务想干嘛、错在哪、谁在等它（team_config 等配置信息已在输入 `context` 中传入，**直接使用，无需重读 README**） 2. **给可操作升级报告**（不丢栈）： - 在哪一步：`<task_id> <title>`，owner `<agent_name>` - 为什么停：reason + last_error 人话翻译 - 影响谁：被 block 的下游 - 你能选（默认推荐放第一）： | 选项 | 含义 | Scheduler 后续 | |------|------|------| | retry | 再给 N 次（可补提示/上下文） | status→pending, attempts 清零 | | swap_agent | 换能力相近的 owner | 你读 `.claude/agents/` 挑候选，告诉 Scheduler 改 owner；**attempts 不清零**（仅 retry 清零，防无限换人死循环） | | skip | 标 skipped 看下游能否继续 | status→skipped | | user_takeover | 切 Commander 用户手动 | 切模式交还控制 | 3. **回传结构化结果**给 Scheduler：`{user_decision, new_agent?, note?}`，以结构化输出结束本 skill 调用；主会话重新进入 Scheduler skill 阶段读取该结果后按选项继续（retry / swap / skip / takeover） ## 工作流 B：模式/介入 - switch