第4章：工作流实战 — 让 Agent（智能体） 为你高效运转
适合读者: 效率追求者, 技术负责人, Agent工程师(AE)
本章从概念走向实战，学习和掌握 OpenCode 提供的多种工作流模式，让 AI Agent 真正成为你的高效协作伙伴。
本章部分工作流模式（Team Mode、自定义工作流）需要 OMO v4.0+，具体依赖见各篇文章开头标注。
章节概述
第 4 章的核心目标是“让 Agent 干活“。我们从最成熟的 Ultrawork 模式入手，掌握“分配-执行-验证“的高效循环。然后深入多 Agent 协作场景，理解如何拆分任务、合并结果、处理冲突。接下来学习自定义工作流的编写方法，将你的团队流程固化到 Workflow 定义中。最后，探讨 Agent 派生模式（从一个 Agent 动态生成子 Agent）和 Teams 并行 Agent 协作（同一进程内多 Agent 实例协同），这两项新能力为复杂工程场景提供了强大的扩展性。
本章包含以下文章（建议按顺序阅读）：
价值声明
| 维度 | 内容 |
|---|---|
| 目标读者 | 已掌握 OpenCode 基础、想将 AI Agent 应用到真实开发流程中的效率开发者和技术 Lead。 |
| 前驱知识 | 完成第 1-3 章阅读，已成功运行过 OpenCode 基本任务，了解 Agent 和 Skill（技能） 的概念。 |
| 读完能做什么 | 能根据任务复杂度选择 Ultrawork/Prometheus/Team Mode 等工作流模式，编写自定义 Workflow（工作流） DSL，并用 Agent 派生和 Teams 协作处理跨模块复杂任务。 |
| 业务指标关联 | 正确选择工作流模式可使单功能开发效率提升 2-3 倍，多 Agent 协作将跨模块重构的交付周期从天级压缩到小时级。 |
| 文章 | 说明 |
|---|---|
| Ultrawork 模式 | 高效的分配-执行-验证循环，oh-my-openagent 的旗舰工作流 |
| Prometheus 规划模式 | 访谈式需求收集与 Atlas 执行指挥工作流 |
| 多 Agent 协作 | 任务拆分、依赖管理、结果合并与冲突解决策略 |
| 交接架构设计 | 跨会话 Handoff 四层架构：文件式 + 选择性阅读 + Schema 验证 + Hook 被动加载 |
| 自定义工作流 | 使用 Workflow DSL 定义自定义流程、门禁和回滚逻辑 |
| Agent 派生模式 | 从父 Agent 动态生成子 Agent 处理子任务的设计模式 |
| Teams 并行 Agent 协作 | 同一进程内多 Agent 实例的并行协作机制与通信协议 |
| oh-my-opencode-slim：轻量级 Agent 编排方案 | 轻量级 Agent 编排方案：Hub-and-Spoke 架构，预设驱动，$30 预算控制 |
工作流模式统一选择矩阵
面对多种工作流模式，选哪个？下面这张表帮你快速定位。
对比总览
| 维度 | 传统 Prompt（提示词） 模式 | Ultrawork Mode（Ralph Loop） | Prometheus Mode（Plan → Execute） | Team Mode（多 Agent 协作） | 7-Agent Pipeline（完整流水线） |
|---|---|---|---|---|---|
| 适用复杂度 | 简单 | 中等 | 中等偏复杂 | 复杂 | 极复杂 |
| 团队规模 | 1人 | 1人 | 1-2人 | 2-5人 | 5-20人 |
| 审计需求 | 无 | 轻度 | 中度 | 中度 | 严格 |
| Token 消耗 | 低（<5K） | 中（5K-20K） | 中（10K-30K） | 高（30K-150K） | 极高（100K-500K） |
| 人工介入 | 全程 | 关键节点 | 关键节点 | 仅审批 | 仅审批 |
| 实施难度 | 低 | 低 | 中 | 高 | 极高 |
| 典型场景 | 修一行 typo、加个注释 | 单文件功能开发、Bug 修复 | 跨模块重构、中型功能开发 | 前后端同步开发、安全审计 | 生产级全栈交付、严格合规变更 |
各模式的详细介绍见本章对应文章：→ Ultrawork 模式、→ Prometheus 规划模式、→ 多 Agent 协作
三步决策流程
拿到一个任务，按下面三步走：
- 任务复杂度如何？ 单文件修改、改个配置这种“简单活“，传统 Prompt 模式就够了。复杂一点的功能开发，进入第二步。
- 需要多 Agent 协作吗？ 一个人能搞定的事，用 Ultrawork（持续执行场景）或 Prometheus（需要前期规划的场景）。如果任务确实需要多人分工，进入第三步。
- 团队规模和审计要求？ 2-5 人团队、中度审计需求选 Team Mode；5 人以上、需要严格审计轨迹的生产变更用 7-Agent Pipeline。
快速选择参考
| 你的场景 | 推荐模式 | 理由 |
|---|---|---|
| 改几行代码、修 typo | 传统 Prompt | 杀鸡不用牛刀 |
| 实现一个独立功能 | Ultrawork | 持续循环直到完成，效率最高 |
| 重构涉及多模块 | Prometheus | 先规划再执行，避免遗漏 |
| 前后端同时开发 | Team Mode | 并行分工，各自专注 |
| 生产环境关键变更 | 7-Agent Pipeline | 七角色把关，审计可追溯 |