← ClaudeAtlas

agent-switchboard-opslisted

以"管理者—执行者"模式运维 agent-switchboard MCP:受管 Claude supervisor 生命周期、跨模型委派(Codex/Claude/Gemini)、验收纪律与已知陷阱对策。 用于存在任一可用委派通道(mcp__agent-switchboard__* 工具或宿主原生 subagent),且用户要求委派执行、监督长任务、跨模型审查、回收多 agent 会话成果,或询问"怎么让 Codex/Claude 帮我做"的场景。 不用于单会话即可完成的普通修改;未安装 agent-switchboard 时仍可经原生 subagent 通道触发,但不要猜测工具名。
ooooooooooooooooooop/agent-tools · ★ 2 · AI & Automation · score 66
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. **逐级降级**:所需路由