everything-claude-code-zh/commands/orchestrate.md

编排（Orchestrate）命令

用于复杂任务的顺序智能体（Agent）工作流。

用法

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

工作流类型

feature

完整功能实现工作流：

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

bugfix

Bug 调查与修复工作流：

explorer -> tdd-guide -> code-reviewer

refactor

安全重构工作流：

architect -> code-reviewer -> tdd-guide

security

侧重安全的评审：

security-reviewer -> code-reviewer -> architect

执行模式

对于工作流中的每个智能体（Agent）：

1. 调用智能体：携带来自上一个智能体的上下文。
2. 收集输出：将其作为结构化的交接（Handoff）文档。
3. 传递：交给链条中的下一个智能体。
4. 汇总结果：生成最终报告。

交接（Handoff）文档格式

在智能体之间创建交接文档：

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

### Context
[工作总结]

### Findings
[关键发现或决策]

### Files Modified
[涉及的文件列表]

### Open Questions
[留给下一个智能体的未解决事项]

### Recommendations
[建议的后续步骤]

示例：功能开发工作流（Feature Workflow）

/orchestrate feature "添加用户认证功能"

执行流程：

1. 规划智能体（Planner Agent）

   • 分析需求
   • 创建实现计划
   • 识别依赖项
   • 输出：HANDOFF: planner -> tdd-guide

2. TDD 指导智能体（TDD Guide Agent）

   • 读取规划智能体（Planner）的交接文档
   • 测试先行（先编写测试）
   • 编写实现代码以通过测试
   • 输出：HANDOFF: tdd-guide -> code-reviewer

3. 代码评审智能体（Code Reviewer Agent）

   • 评审实现代码
   • 检查潜在问题
   • 提出改进建议
   • 输出：HANDOFF: code-reviewer -> security-reviewer

4. 安全评审智能体（Security Reviewer Agent）

   • 安全审计
   • 漏洞检查
   • 最终批准
   • 输出：最终报告

最终报告格式

ORCHESTRATION REPORT
====================
Workflow: feature
Task: 添加用户认证功能
Agents: planner -> tdd-guide -> code-reviewer -> security-reviewer

SUMMARY
-------
[一段话总结]

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

FILES CHANGED
-------------
[列出所有修改的文件]

TEST RESULTS
------------
[测试通过/失败摘要]

SECURITY STATUS
---------------
[安全发现项]

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

并行执行

对于独立的检查项，可以并行运行智能体：

### Parallel Phase
同时运行：
- code-reviewer (质量评审)
- security-reviewer (安全评审)
- architect (设计评审)

### Merge Results
将所有输出汇总到单个报告中

参数

$ARGUMENTS:

• feature <description> - 完整功能实现工作流
• bugfix <description> - Bug 修复工作流
• refactor <description> - 重构工作流
• security <description> - 安全评审工作流
• custom <agents> <description> - 自定义智能体序列

自定义工作流示例

/orchestrate custom "architect,tdd-guide,code-reviewer" "重构缓存层"

技巧

1. 从规划开始：对于复杂功能，优先使用规划智能体（Planner）。
2. 始终包含代码评审：在合并前，务必包含代码评审智能体（Code Reviewer）。
3. 涉及敏感操作使用安全评审：在处理鉴权、支付或敏感信息（PII）时，请使用安全评审智能体（Security Reviewer）。
4. 保持交接文档简洁：专注于下一个智能体所需的信息。
5. 在环节间运行验证：如有必要，在智能体交接间运行验证（Verification）。