SuperAPI AI 工具集

writing-agent-relay-workflows

智能体与模型

查看项目

更新于 10-15 16:42

技能介绍

用途:该技能用于指导使用 @relayflows/core 的工作流系统编排多个 AI 智能体(Claude、Codex、Gemini、Aider、Goose),以类型化的 DAG 工作流完成多智能体协作任务。工作流可用 TypeScript(推荐)、Python 或 YAML 编写,语言优先级为 TypeScript > Python > YAML。

主要能力:支持 step 依赖、验证门槛(verification gates)、重试(retries)、步骤输出链式传递({{steps.X.output}});支持 DAG、Pipeline、fan-out 等群体模式;支持动态频道管理(智能体在工作流中途加入、离开、静音频道);支持可修复的验证门槛与产品契约式工作流(检查失败时路由给智能体修复,而非直接终止)。核心原则是“先修复再失败”:确定性检查用 captureOutput: true 捕获证据;中间验证门槛用 failOnError: false,把红色输出交给修复智能体,修复后重跑同一检查;最终验收保持确定性,但在提交或创建 PR 前仍放置智能体修复步骤。若存在真实阻塞,写入 BLOCKED_NO_COMMIT 并附带证据,跳过提交与 PR,而不是让工作流以失败告终。

使用方式:先做确定性、可恢复的预检(仓库状态、凭据、声明的写入范围);刻意选择协调形态——非平凡协作选 Conversation,仅线性一次性交接才用 Pipeline;每个工作流必须包含两轮依次进行的全新视角审查/修复循环:先 Claude,再 Codex。审查修复者需为可测试的发现新增或更新测试、夹具、断言或确定性证明。支持 .reliable() 或 .repairable(),在支持该能力的 SDK 版本上尤其用于产品契约工作流。

限制:资料未提供安装命令、收费方式与平台要求;文档说明不应对所有任务默认使用 dag,需先参考 choosing-swarm-patterns 技能选择最匹配的协调模式。