用途:本技能记录 Relayflows v1 引擎(@relayflows/core 的 WorkflowBuilder),供阅读或维护既有 v1 工作流的人参考。v1 已被取代,新工作应转向 v2 引擎:@relayflows/surface 的 flow()、由 @relayflows/sdk 编译的 YAML/JSON 方言、CLI 二进制 flows、2.0.x 包;编写面见 writing-relayflows,v2 校验形态见 relay-80-100-workflow。failOnError、captureOutput、{{steps.X.output}}、.onError()、idleThresholdSecs 在 v2 中均不存在,照本技能写 v2 流程将无法编译。
主要能力:通过类型化 DAG 工作流编排多个 AI 代理(Claude、Codex、Gemini、Aider、Goose)。可用 TypeScript(首选)、Python 或 YAML 编写,语言偏好 TypeScript > Python > YAML。包从 @relayflows/core 导入;@agent-relay/sdk/workflows 已移除,旧引用与手写 ambient 声明桩都应改指向 @relayflows/core 并删除桩。createGitHubStep 位于 @relayflows/core/integrations/github。
使用方式:本地运行 relayflows run <file>;仅校验不运行 relayflows run --dry-run <file>;云端运行 agent-relay cloud run <file> --file-type ts(无 --dry-run)。没有 agent-relay run 子命令。
适用场景:多代理步骤依赖、编排不同 AI CLI、DAG/流水线/扇出等模式、验证门与重试、步骤输出串联、可修复的产品契约工作流、动态频道管理、Slack 人工介入提问、订阅 Relayfile 集成事件(GitHub PR 评审、状态检查、Linear、Slack 回复)、事件启动或事件门控工作流。
限制:本页为废弃文档,v1 细节仅供维护旧流程;v2 的完整能力、收费、平台与效果资料暂未提供。humanAssistance 与 HUMAN_QUESTION 协议需 @relayflows/core >= 1.1.0,1.0.x 会静默忽略;提问代理必须为交互式,非交互 preset 无处理;humanAssistance 应配置在 swarm 层而非步骤层;Slack 凭据需可写 /slack 授权与挂载。