team-agent-orchestration

# Team Agent Orchestration 当智能体像团队而不是单个助手一样被管理时，使用此技能。目标是让团队式编排可靠：清晰 work items、明确 ownership、agent Kanban 状态、branch 隔离、control pane 可见性和 merge gates。 ## 何时激活 - 任务跨多个智能体、工具、harness、branches 或 worktrees。 - 用户提到 team orchestration、agent Kanban、squad、conductor、control pane、manager、desktop app、Zellij、tmux、Hermes、Devin、Codex、Claude Code 或 multi-agent work。 - 项目需要人和智能体共享工作流状态。 - 现有 agent fan-out 产出了内容，但没有可合并产品。 ## 运行模型 把每个智能体当成有窄合同的队友： - **Owner**：对 work item 负责的人或智能体。 - **Scope**：文件、branch、tool surface 和禁区。 - **State**：backlog、ready、running、review、blocked、merged 或 archived。 - **Evidence**：tests、screenshots、logs、review notes 或 eval reports。 - **Merge gate**：允许集成的精确条件。 ## Agent Kanban 当工作必须跨会话可见时，使用 agent Kanban。 | 列 | 含义 | 退出标准 | | --- | --- | --- | | Backlog | 候选 work item，尚未成形 | 已写 acceptance criteria | | Ready | 已成形，可分配 | 已分配 owner 和 branch/worktree | | Running | 智能体正在工作 | 存在 handoff artifact 和 changed files | | Review | 工作完成但未合并 | tests、diff review 和 risk check 通过 | | Blocked | 需要外部输入或 gate 失败 | blocker 有 owner 和 next action | | Merged | 已集成到 mainline | PR merged 或本地 main 已更新 | | Archived | 不再相关 | 已记录原因 | 每张卡片应符合此 schema： ```json { "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" } ``` ## 团队式编排流程 1. **Shape the board**：把模糊目标转成带 owner 和 merge gates 的 work items。 2. **Pick execution mode**：选择 single-agent、dynamic workflow mode、dmux/tmux、worktree fan-out 或外部 desktop orchestrator。 3. **Assign boundaries**：每张卡一个 owner，文件范围清楚；没有 integrator 时避免重叠写入。 4. **Run agents**：每个智能体写 evidence 和 handoff notes，而不只是代码。 5. **Review in sequence**：先 tests，再 diff review，再 security/risk checks，最后 content/product polish。 6. **Merge deliberately**：由一个 integrator 解决冲突并更新 control pane 或 status artifact。 7. **Extract reusable skill**：如果卡片模式重复，把它提升到 `skills/`。 ## Control Pane 要求 有用的团队编排 control pane 应显示： - 活跃 work items 及其 agent Kanban state。 - Owner、harness、branch、worktree 和 last heartbeat。 - handoff artifacts、tests、screenshots 和 PRs 的链接。 - 按 owner 和 unblock action 分组的 blockers。 - 按 gate 展示的 merge readiness，而不是凭感觉。 - 应变成 shared skills 的 reusable workflow candidates。 在操作者能回答这些问题前，不要增加更多自动化：谁拥有它、改了什么、哪个 gate 失败、什么能安全合并？ ## Dynamic Workflow 兼容性 当卡片需要 dynamic workflow mode： - 把任务本地 harness 放在卡片 owner 名下。 - 在卡片上存储输入和输出。 - 从 Running 移到 Review 前要求一次 eval。 - 只有重复使用后，才把 harness 提升为 shared skill。 ## 需要警惕的失败模式 - **Agent soup**：许多智能体在跑，但没有 owner 或 merge gate。 - **Invisible work**：有用输出只存在于 chat transcript。 - **Board theater**：有 Kanban board，但卡片没有 acceptance criteria。 - **Overlapping writes**：并行智能体在没有 worktrees 的情况下编辑同一文件。 - **No product artifact**：流程产出文档，但没有可运行或可发布表面。 ## 输出标准 每次编排 pass 结束时包含： - Board/card changes。 - 已合并或待处理 branches。 - Tests 和 eval evidence。 - 带 owner 和 next action 的 blockers。 - 新的 shared skill candidates。