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：

{
  "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。