multi-agent-team

name	multi-agent-team
description	用户要求用 multi-agent-team-skill 初始化、升级、检查项目，或需要受控多 Agent 并行、长期领域任务、队列、心跳、Token 与失败恢复时触发。普通单文件修改和纯咨询不触发。
metadata	{"version":"2.0.4"}

Multi-Agent Team v2.0.4

主任务默认是唯一 control-plane-only 控制面：只做只读判断、拆分、派发、监控、验收、汇报和受管调度状态写入，不写生产代码。 用户给出项目路径后，无需询问 orchestrator 等内部术语，必须先执行：

python3 scripts/inspect_team.py --project <项目根目录>

inspect-first 同时按 README 第一处有效 H1、可读 project/package manifest、目录名确定显示名，输出 主控｜<项目显示名>。路由成功后主控必须调用 codex_app__set_thread_title（当前任务可省略 threadId）；脚本只输出 RENAME_ACTION 建议，不能伪造成功。客户端不支持时继续安装/健康检查并明确 TITLE_RENAME=pending。

inspect 结果	动作
new / existing-project	读对应 workflow，dry-run team_init.py
existing-team:v1 / v2-upgrade	读 schema-migration.md，dry-run team_upgrade.py
existing-team:audit	运行只读 team_audit.py，未知 schema 失败关闭
existing-team:v2	运行 team_doctor.py 与 orchestrator health；AGENTS 非受管区冲突必须失败关闭

用户明确要求“升级并开启受控自动”时，可用 team_upgrade.py --thread-mode controlled-auto；指定当前主控后，客户端真实重命名/置顶成功，再用 bind_control_task.py 持久化绑定。

Goal 隔离（硬约束）

“主控任务/主控线程/项目主控/当前对话设为项目主控”均是普通 Codex 对话控制面，绝不等价于 Goal；project state 固定 goal_policy=explicit-only、control_plane_is_goal=false，默认 controlled-auto。除非用户明确要求创建 Goal、使用目标模式或设置目标预算，否则不调用 Goal、goal-writer 或 /goal。初始化/升级措辞即无冲突 dry-run 后 apply 授权，无需二次确认。

若当前线程已有 Goal，报告 GOAL_MODE=unsupported_for_control_plane_setup，建议普通新线程；不复用、新建、完成或删除已有 Goal。project task/长期领域任务不是 Codex Goal。静态 Skill 无法从代码层绝对阻止客户端违规，只能依赖 AGENTS/Skill 硬约束与审查。

dispatch-and-return（硬约束）

• 成功 spawn 一个或一批 Agent 后，立即回传任务编号、角色、状态并结束当前 turn；多个 Agent 必须先批量 spawn，再一次性 ACK，禁止边 spawn 边 wait。
• 同一派发 turn 禁止 wait_agent、重复 read/status polling、长测试或继续集成；同步等待仅限用户明确要求，且必须先告知会阻塞输入。
• 完成通知、健康巡检、验收和重派只能在后续用户 turn、完成事件 turn 或自动化唤醒中处理；用户新消息优先，依赖队列与路径所有权防冲突。
• Python 只能校验并输出契约，无法控制客户端 turn 结束；不得伪造真实 UI 并发证明。

双通道

• fast lane：普通任务直接派一次性 Agent，完成即释放；轻任务用最小派发包，默认 on-failure review。
• project lane：复杂、持续、独立领域任务创建或复用长期任务；长期任务只能再派一次性 Agent，禁止更深嵌套。
• 项目 [agents].max_depth=1；registry 深度 2 是主控制面代 project task 派发 one-shot 的受管关系，不是 Agent 递归嵌套。
• 高风险任务始终使用全新只读 reviewer；主任务不复用实现上下文做审查。

编排前读 references/runtime-orchestration.md，使用 plan -> enqueue -> dispatch。队列不限，总运行并发默认 6、写实例 2；依赖、所有权或容量不满足时保持排队。

运行规则

• Luna/Terra/Sol 对应 fast/standard/advanced；模型重配置遇到活动/可恢复实例必须输出 replacement_required，不得原地改模型。
• 同因失败两次：保存 handoff，停止旧实例，用 replace 创建更高档新实例；禁止原地换脑。
• 心跳、超时、依赖、状态、证据、Token 与文件锁写入 .codex/team/；interaction_policy 默认 dispatch-return；默认 dry-run。
• 外部发布、生产写入、付费动作和凭据变更始终单独取得明确批准。

完成闸

声明主控就绪前执行 team_doctor.py --strict、orchestrator health、项目测试和高风险 fresh reviewer；runtime_smoke.py 只记录真实证据，无法运行时保持 pending/partial。修改 Skill 后运行 deep health、官方 validator（若存在）及 README 链接检查。