Orchestrate 命令¶

用于复杂任务的代理顺序流程。

用法¶

/orchestrate [workflow-type] [task-description]

工作流类型¶

feature¶

完整的功能实现工作流：

planner -> tdd-guide -> code-reviewer -> security-reviewer

bugfix¶

缺陷调查与修复工作流：

planner -> tdd-guide -> code-reviewer

refactor¶

安全重构工作流：

architect -> code-reviewer -> tdd-guide

security¶

聚焦安全性的审查：

security-reviewer -> code-reviewer -> architect

执行模式¶

对于工作流中的每个代理：

调用代理，并携带前一个代理的上下文
收集输出，作为结构化的交接文档
传递给链中的下一个代理
汇总结果，形成最终报告

交接文档格式¶

在代理之间，创建一个交接文档：

## HANDOFF: [previous-agent] -> [next-agent]

### Context
[Summary of what was done]

### Findings
[Key discoveries or decisions]

### Files Modified
[List of files touched]

### Open Questions
[Unresolved items for next agent]

### Recommendations
[Suggested next steps]

示例：功能工作流¶

/orchestrate feature "Add user authentication"

执行：

Planner 代理
分析需求
创建实现计划
识别依赖项
输出：HANDOFF: planner -> tdd-guide
TDD Guide 代理
读取 planner 的交接文档
先编写测试
实现代码以通过测试
输出：HANDOFF: tdd-guide -> code-reviewer
Code Reviewer 代理
审查实现
检查问题
提出改进建议
输出：HANDOFF: code-reviewer -> security-reviewer
Security Reviewer 代理
安全审计
漏洞检查
最终批准
输出：最终报告

最终报告格式¶

ORCHESTRATION REPORT
====================
Workflow: feature
Task: Add user authentication
Agents: planner -> tdd-guide -> code-reviewer -> security-reviewer

SUMMARY
-------
[One paragraph summary]

AGENT OUTPUTS
-------------
Planner: [summary]
TDD Guide: [summary]
Code Reviewer: [summary]
Security Reviewer: [summary]

FILES CHANGED
-------------
[List all files modified]

TEST RESULTS
------------
[Test pass/fail summary]

SECURITY STATUS
---------------
[Security findings]

RECOMMENDATION
--------------
[SHIP / NEEDS WORK / BLOCKED]

并行执行¶

对于独立的检查，并行运行代理：

### Fase Paralela
Executar simultaneamente:
- code-reviewer (qualidade)
- security-reviewer (segurança)
- architect (design)

### Mesclar Resultados
Combinar saídas em um único relatório

对于在 tmux 窗格中运行、使用独立 git worktree 的外部 workers，请使用 node scripts/orchestrate-worktrees.js plan.json --execute。内置编排模式仍保留在当前进程中；该辅助工具用于长会话或跨 harness 场景。

当 workers 需要查看主 checkout 中已修改或未跟踪的本地文件时，请在计划文件中添加 seedPaths。ECC 会在每个 worker 的 worktree 执行 git worktree add 之后，仅对这些选定路径进行 overlay，从而保持分支隔离，同时暴露进行中的脚本、计划或文档。

{
  "sessionName": "workflow-e2e",
  "seedPaths": [
    "scripts/orchestrate-worktrees.js",
    "scripts/lib/tmux-worktree-orchestrator.js",
    ".claude/plan/workflow-e2e-test.json"
  ],
  "workers": [
    { "name": "docs", "task": "Update orchestration docs." }
  ]
}

要将控制平面快照导出到实时 tmux/worktree 会话，请运行：

node scripts/orchestration-status.js .claude/plan/workflow-visual-proof.json

该快照以 JSON 格式包含会话活动、tmux 窗格元数据、workers 状态、目标、已播种的 overlay 以及最近的交接摘要。

操作员 Command Center 交接¶

当工作流跨越多个会话、worktree 或 tmux 窗格时，请在最终交接中添加一个控制平面块：

CONTROL PLANE
-------------
Sessions:
- active session ID or alias
- branch + worktree path for each active worker
- tmux pane or detached session name when applicable

Diffs:
- git status summary
- git diff --stat for touched files
- merge/conflict risk notes

Approvals:
- pending user approvals
- blocked steps awaiting confirmation

Telemetry:
- last activity timestamp or idle signal
- estimated token or cost drift
- policy events raised by hooks or reviewers

这使 planner、实现者、审查者和循环 workers 在操作界面上保持可读。

参数¶

$ARGUMENTS: - feature <description> - 完整功能工作流 - bugfix <description> - 缺陷修复工作流 - refactor <description> - 重构工作流 - security <description> - 安全审查工作流 - custom <agents> <description> - 自定义代理序列

自定义工作流示例¶

/orchestrate custom "architect,tdd-guide,code-reviewer" "Redesign caching layer"

提示¶

从 planner 开始，用于复杂功能
在合并前始终包含 code-reviewer
对身份验证/支付/PII 使用 security-reviewer
保持交接简洁 - 聚焦下一个代理所需的内容
在必要时于代理之间运行验证

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 ev/ECC