team-agent-orchestration

Team Agent Orchestration 是一个用于团队式智能体编排的技能。当智能体被当作一个团队而非单一助手来管理时，可以使用该技能。其目标是让基于团队的编排变得可靠：清晰的工作项、明确的归属、智能体看板状态、分支隔离、控制面板可见性以及合并门禁。

何时启用

任务跨越多个智能体、工具、执行框架、分支或工作树。
用户提到团队编排、智能体看板、小队、指挥者、控制面板、管理器、桌面应用、Zellij、tmux、Hermes、Devin、Codex、Claude Code 或多智能体工作。
项目需要跨人和智能体共享工作流状态。
现有的智能体分发产生了输出，但没有可合并的产物。

运行模型

把每个智能体视为拥有狭窄契约的队友：

负责人：对工作项负责的人或智能体。
范围：文件、分支、工具面以及禁止区域。
状态：backlog、ready、running、review、blocked、merged 或 archived。
证据：测试、截图、日志、评审记录或评估报告。
合并门禁：允许集成的确切条件。

智能体看板

当工作必须跨会话可见时，使用智能体看板。

列	含义	退出标准
Backlog	候选工作项，尚未成形	已编写验收标准
Ready	已成形且可分配	已分配负责人和分支/工作树
Running	智能体正在积极工作	存在交接产物和已更改文件
Review	工作已完成但未合并	测试、差异评审和风险检查通过
Blocked	需要外部输入或门禁失败	阻塞项有负责人和下一步行动
Merged	已集成到主线	PR 已合并或本地 main 已更新
Archived	不再相关	已记录原因

每张卡片应符合以下结构：

{
  "id": "agent-card-001",
  "title": "Build dynamic workflow skill",
  "owner": "codex",
  "state": "running",
  "branch": "product/dynamic-workflow-team-orchestration",
  "worktree": ".",
  "acceptance": [
    "Skill exists",
    "Tests cover required concepts",
    "Content artifact contains video and article angles"
  ],
  "merge_gate": "lint, focused tests, and catalog check pass",
  "handoff": "path/to/handoff.md"
}

基于团队的编排流程

塑造看板：把模糊的雄心转化为带有负责人和合并门禁的工作项。
选择执行模式：单智能体、动态工作流模式、dmux/tmux、工作树分发或外部桌面编排器。
分配边界：每张卡片一个负责人，清晰的文件范围，没有集成者时不得重叠写入。
运行智能体：每个智能体写入证据和交接说明，而不仅仅是代码。
按顺序评审：先测试，再差异评审，然后安全/风险检查，最后内容/产品打磨。
审慎合并：由一名集成者解决冲突并更新控制面板或状态产物。
提取可复用技能：如果卡片模式重复出现，将其提升到 skills/ 中。

控制面板要求

一个有用的团队编排控制面板应显示：

活跃工作项及其智能体看板状态。
负责人、执行框架、分支、工作树和最后心跳。
指向交接产物、测试、截图和 PR 的链接。
按负责人分组的阻塞项及解除阻塞行动。
按门禁而非感觉判断的合并就绪状态。
应成为共享技能的可复用工作流候选。

在操作者能够回答以下问题之前，不要增加更多自动化：谁拥有这个、改了什么、哪个门禁失败了、什么可以安全合并？

动态工作流兼容性

当卡片需要动态工作流模式时：

将任务本地执行框架放在卡片负责人之下。
在卡片上存储输入和输出。
在从 Running 移动到 Review 之前要求进行评估。
仅在重复使用后才将执行框架提升为共享技能。

需要警惕的失败模式

智能体大杂烩：许多智能体在运行，但没有负责人或合并门禁。
不可见的工作：有用的输出只存在于聊天记录中。
看板表演：存在看板，但卡片没有验收标准。
重叠写入：并行智能体在没有工作树的情况下编辑相同文件。
没有产品产物：流程产生了文档，但没有可运行或可发布的界面。

输出标准

每次编排完成后应包含：

看板/卡片变更。
已合并或待处理的分支。
测试和评估证据。
带有负责人和下一步行动的阻塞项。
新的共享技能候选。