用途:teammode 是 Codex 专用的团队编排工作流,用一名 leader(主会话)协调多名协作的 Codex worker,团队状态持久保存在磁盘上。它不依赖外部终端运行器,而是通过 Codex 自身的协作工具加一个内置状态脚本工作。
主要能力:支持两种传输方式,需在创建团队前先选定——MultiAgentV2(首选,需扁平 spawn_agent 等 V2 工具齐全)或 Codex App threads(回退方案)。团队状态由无依赖的 Node 脚本管理,生成 .omo/teams/{session_id}/,内含 team.json、guide.md 和 artifacts/ 共享交换目录。支持成员增删、绑定、状态设置、worktree 隔离、集成合并与归档。
使用方式:先检查当前会话可见工具,确定传输方式并告知用户,再运行 init(--transport multi_agent_v2 或 codex_app),随后逐个 add-member,并按传输方式 spawn 或创建线程后 bind。常用命令形如 node "<skill-root>/scripts/team.mjs" init --name "<team>" --session-name "<session>" --transport multi_agent_v2|codex_app,以及 add-member、bind-agent、bind-thread、set-status、worktree-add、integrate、archive、delete、status 等子命令。
适用场景:工作无法拆成完全隔离的片段但并行更便利、成员需互相看到彼此发现;或目标已明确但仍需并行探索。若工作完全隔离或目标仍模糊,应改用普通 subagent。
限制:仅限 Codex;团队至少两名成员;传输方式在团队生命周期内不可变,不得混用;两种工具集都不存在时无法运行,不得伪造团队;leader 只做编排与集成,不写产品代码;成员间通信使用英文,面向最终用户时用用户语言。