SuperAPI AI 工具集

writing-agent-relay-workflows

智能体与模型

查看项目

更新于 10-15 16:42

技能介绍

用途:该技能面向使用 relay broker-sdk 编排多个 AI 智能体(Claude、Codex、Gemini、Aider、Goose)的场景,通过带类型的 DAG 工作流完成多步骤、有依赖关系的任务。工作流可用 TypeScript(首选)、Python 或 YAML 编写;除非项目仅用 Python 或需要简单配置驱动,否则推荐 TypeScript。

主要能力:支持 DAG、pipeline、fan-out 等 swarm 模式;可编排不同 AI CLI;提供验证门、重试、步骤输出串联({{steps.X.output}});支持动态频道管理(加入、离开、静音);支持 product-contract 式工作流,检查失败时路由给修复智能体而非直接终止。文档强调“先修复再失败”:确定性检查以 captureOutput: true 捕获证据,中间门用 failOnError: false 把红色输出交给修复智能体,修复后重跑同一检查;最终验收保持确定性,但在提交/创建 PR 前仍保留智能体修复步骤;若存在真实阻塞,写 BLOCKED_NO_COMMIT 并跳过提交与 PR,而不是让工作流以 FAILED 结束。若工作流负责发布,则把分支、提交、推送、PR 创建与 PR URL 验证建模为显式确定性步骤。

使用方式:先做确定性、可恢复的 preflight(检查仓库状态、凭证、写入范围),再选择协调形态。Conversation(对话式):智能体共享频道,通过消息、@提及和氛围感知协调,lead 与 worker 并行启动并自组织,适用于多文件工作、同伴评审循环、跨智能体反馈、动态重规划、多 PR 协调及有人工介入出口的 swarm。Pipeline(一次性 DAG):每步是一次性子进程(如 claude -p、codex exec),步骤间靠文本注入传递,无智能体同时存活,适用线性、明确规格、无需实现期间实时协调的任务。非平凡工作默认用 Conversation。两种形态可混用:确定性 preflight → 中间对话 → 末尾提交与 PR。文档称,若工作流只用 preset: 'worker' 且靠 {{steps.X.output}} 串联,那其实是在用 claude -p | codex exec,而非真正用 relay。

评审深度:确定性证明、可修复验证、最终硬验证、范围化 diff 证据、阻塞态处理和最终签核始终保留;深度只改变 LLM 新鲜视角评审的遍数。深度层级工作流采用 Claude 评审/修复/终审/终修,随后 Codex 评审/修复/终审/终修;轻量工作流可缩减,但关键路径上须保留确定性门、硬验证和至少一次独立的 Claude 评审/修复。评审修复者需为可测试发现补充测试、fixture、断言或确定性证明。发现项字段包括 verdict、finding_id、severity、file、issue、fix_required、test_required、status、evidence。SDK 在支持版本上可用 .reliable() 或 .repairable();截至 AgentWorkforce/relay#827,带智能体的重试模式工作流默认具备修复感知。

限制:本资料提供的是技能说明与示例代码,未说明收费、价格、平台支持范围或实际效果;具体可用性取决于 relay broker-sdk 版本与所编排 CLI 的可用性。较长代码示例不在此展开,必要命令保持原样(如 git rev-parse --show-toplevel >/dev/null && echo PREFLIGHT_OK)。