DevSpace workflows 面向具有可重复多智能体计划的任务。资料建议：一次性委派使用 subagents 命令，需要反复执行的多智能体流程才编写为工作流。命名工作流存放在当前项目的 .devspace/workflows/ 目录中。
编写工作流前，应先阅读同目录下的 reference.md，其中定义了沙箱接受的唯一语法与原语，包括 agent、phase、parallel、pipeline、workflow、log、args，以及元规则、智能体选项、结构化输出 schema 和各项限制，不应猜测 API。随后可阅读 patterns.md 中经过验证的工程循环模式进行改编，例如：带评审者的计划、实现-评审-修复直至通过、循环至测试通过的 QA 关卡、先探索后综合、多视角评审并核实发现、智能体之间的对比评测、将一项变更映射到多个单元、用竞争性假设调试，以及这些模式的组合。
运行方式：按名称运行或指定文件运行，可传入 JSON 参数或参数文件：
devspace workflow run --name <name> [--args '<json>'] devspace workflow run --file <path> [--args-file <path>]
命令返回紧凑的 <workflow id="..." status="..."/> 回执，应保留该 ID。工作流代码默认只读，仅当工作流必须修改项目时才加 --write-mode allowed。
等待时每次最多 60 秒；若返回状态仍为 running，可重复 wait，不要循环轮询状态：
devspace workflow wait <id> --timeout 60
按需检查当前状态、调用或单个完整调用：
devspace workflow status <id> devspace workflow calls <id> devspace workflow call <id> <index> devspace workflow events <id> --after <last-sequence> devspace workflow ls
events 最多返回 100 条持久化的日志和阶段条目，保留最大的 sequence，并在下次分页时通过 --after 传入。
仅在父任务不再需要该运行时才取消：
devspace workflow cancel <id>
中断或失败的运行可从持久调用历史恢复；恢复复用原始参数和写模式：
devspace workflow run --resume <id>
仅在脚本需要结构化输出时使用 --json。
适用场景包括需要稳定复现的多智能体协作流程，例如计划与评审、实现与修复循环、测试关卡、多视角审查、批量变更映射和假设竞争调试等。限制与注意事项：必须遵循 reference.md 定义的沙箱语法与原语，不应猜测 API；默认只读，写操作需显式开启；事件分页需按 sequence 续取；资料未提供具体语法细节、智能体选项清单与限制数值，暂未提供。