agent-switchboard-opslisted
Install: claude install-skill ooooooooooooooooooop/agent-tools
# Agent Switchboard 运维手册
本 Skill 是使用 `agent-switchboard` MCP(本地跨 agent 协作桥)的操作契约,全部经验来自真实生产使用的事故与验收记录。只负责编排规则;任务本身的修改纪律交给 `minimal-implementation`,范围澄清交给 `clarify-before-change`。
## 适用范围与触发边界
触发边界:存在任一可用委派通道即可触发;随后按任务类型进入相应路由:
1. 存在任一可用委派通道:`mcp__agent-switchboard__*` 工具,或宿主原生委派机制(如后台 subagent);
2. 任务属于以下之一:跨模型委派(审查/实现/辩论)、受管长任务执行、监督或收取其他 agent 会话的成果、多窗口并行编排。
## 不适用场景
- 单会话可直接完成的小型或中型修改:不要为普通任务起 supervisor。
- 环境未安装 agent-switchboard 且也无原生委派通道:不要猜测工具名或要求用户临时安装,安装属于高风险操作,需用户明确授权。
- 纯只读问答:直接回答,不经 broker 绕道。
## 核心模式:管理者—执行者边界
- 会话管理者(你自己)只负责:定目标与阶段顺序、写完整派工提示词、审阅执行者证据、下返修指令、判定阶段是否通过、向用户汇报。
- 任务规模一律由 `task-mode-router` 判级,不由"我已经在做了"反推:判为中型及以上的动手操作(调查、读大量文件、编码、改配置、跑构建/测试/数据扫描、Git 提交)委派给受管执行者;判为小型的单会话修改可直接最小修改并验证。执行前记录所选路由与理由(写入派工单或 broker 记录)。
- 管理者允许做**有界、只读的独立验收**:复跑只读校验脚本、`git show`/`git diff --check`、读文件核对哈希/行号/输出。禁止实现、提交、扩大调查范围。
- 执行者自报的 PASS 不是验收依据;验收以独立证据为准(上述只读核验的结果)。
- 互不冲突的任务应主动并行多个受管窗口,无需用户提醒;存在同一文件或同一数据冲突风险的任务在同一窗口排队。
- 执行者窗口验收完成或确认不再需要后立即 `close_supervisor` / `stop_managed_claude_supervisor`,不得长期悬挂闲置窗口。
## 路由规则:确定性选择委派通道
按以下顺序判定,命中即停;执行前记录所选路由与理由:
1. **小型任务直接执行**:经 `task-mode-router` 判级为小型的单会话修改,不走任何委派,直接最小修改并验证。
2. **同厂劳动 native subagent 优先**:与当前会话同厂(同厂商/同宿主)的执行类劳动,优先使用宿主原生委派机制(如后台 subagent)。这不是"switchboard 失败后的降级",而是 broker 自身要求的默认路由。
3. **异厂咨询/审查走 switchboard**:跨厂商模型的审查、评审、辩论、咨询,经 `route_agent_task` / `consult_*` / `queue_*_request` 走 broker。
4. **受管 Claude 长任务走 supervisor**:需要跨多轮、可归档续接的 Claude 长任务,用 `start_managed_claude_supervisor` 受管执行。
5. **逐级降级**:所需路由