编排器允许你定义多步骤任务,并通过依赖管理将它们分发到多个 AI 代理(Claude、Codex、Gemini)执行。

什么是编排器?

可以把它理解为 AI 编程代理的任务 DAG(有向无环图)。你定义任务和提示词,选择由哪个代理和模型执行每个任务,并指定任务之间的依赖关系。编排器会按照正确的顺序执行任务,并尽可能并行化。

创建运行

编排器运行通过移动端应用API 创建。每次运行包含:
  • 任务 — 独立的工作单元,每个任务包含:
    • 描述要做什么的提示词
    • 提供者(Claude、Codex 或 Gemini)
    • 模型选择
    • 可选的工作目录
    • 对其他任务的依赖
  • 依赖图 — 任务之间可以有依赖关系,形成 DAG

如何使用

在任意 Happy 会话中发送自然语言提示,描述你想要编排的内容。AI 会自动调用编排器来分发任务。关键短语:
意图关键词
并行执行任务”同时”、“并行”、“一起”
控制执行顺序”先……然后……”、“完成后”
使用不同代理”分发给 Claude/Codex/Gemini”
后台运行”异步模式”、“在后台”
指定模型”使用 opus”、“用 gpt-5.4”

示例

并行:多角度代码审查

将同一个文件分发给三个代理,从不同角度审查:
同时分发三个任务来审查 orchestratorRoutes.ts:
- 一个负责安全性(注入、权限、输入验证)
- 一个负责性能(N+1 查询、不必要的 await)
- 一个负责正确性(边界情况、竞态条件、错误处理)
分别分配给 Claude、Codex 和 Gemini。汇总结果。

DAG:设计 → 实现 → 验证流水线

通过依赖关系串联任务,使每一步都基于前一步的成果:
帮我开发一个"数据导出"功能,按以下顺序安排:
1. 先分发给 Claude:设计 API 接口(Zod schema,支持 CSV/JSON)
2. 设计完成后,并行分发:Codex 实现后端(happy-server),前端(happy-app)
3. 两者完成后,运行类型检查进行验证

使用编排器来编排这个流水线。

并行:PR 提交前检查

在提交 Pull Request 之前并行运行所有检查:
我即将提交一个 PR。安排并行检查:
1. TypeScript 类型检查(所有包)
2. 单元测试
3. lint 和类型检查都通过后,运行集成测试
汇总所有结果。

跨提供者:让不同 AI 竞争

将相同的任务分配给不同代理,比较它们的方案:
将同一个任务分发给 Claude、Codex 和 Gemini:各自独立设计一个 REST API
分页方案。我会比较后选择最佳方案。

DAG:Bug 调查

从多个角度同时调查一个 Bug:
有一个 Bug:用户登录后 token 偶尔会过期。安排三个并行调查:
- 检查 token 生成和验证逻辑
- 检查会话过期和刷新机制
- 检查相关中间件和错误处理
并行调查,然后汇总发现。

DAG 可视化

一个带依赖关系的典型编排器运行:
Task 1: "设计 API schema" (Claude, opus-4-6)

Task 2: "实现后端" (Claude, sonnet-4-6)    依赖 Task 1
Task 3: "实现前端" (Codex, gpt-5.4)       依赖 Task 1

Task 4: "运行测试" (Gemini, gemini-2.5-pro)        依赖 Task 2 + 3
Task 2 和 Task 3 在 Task 1 完成后并行运行。Task 4 等待两者都完成。

监控

从移动端应用跟踪编排器运行:
  • 查看每个任务的实时状态(等待中、运行中、已完成、失败)
  • 查看任务输出和日志
  • 根据需要取消运行
  • 向单个任务发送后续消息

使用 API

通过编程方式创建和管理编排器运行。详见 编排器 API