SuperAPI AI 工具集

workflow-builder

智能体与模型

查看项目

更新于 10-15 20:21

技能介绍

用途:为 Claude Code 的 Workflow 工具编写可运行的确定性多智能体编排脚本(.claude/workflows/ 下的 .js 文件),把工作扇出到新上下文的子智能体,只在叶子 agent() 调用消耗 token,主会话保持干净且整体可恢复。

主要能力与流程:

  1. 先做 intake(不可跳过):询问可自动化的重复多步任务、单个子智能体的工作单元、单元数量、后续步骤是否需要全部先前结果、是否需要结构化返回、token 规模等。
  2. 输入模糊时不阻塞,用脚本给出 1-2 个具体方案:python scripts/workflow_intake.py --task "描述" --units unknown --stages unknown --needs-all unknown --structured unknown。引擎返回推荐拓扑(fan-out / pipeline / loop / barrier / judge-panel)、模型选择、预算守卫与理由。
  3. 与用户确认拓扑、阶段、并行或流水线后再写文件,这是唯一审批关口。
  4. 脚手架:python scripts/scaffold_workflow.py --topology pipeline --name pr-triage --description "Triage open PRs" > .claude/workflows/pr-triage.js。
  5. 写文件:先纯字面量 meta 块,再写异步主体,使用注入的全局量 agent()、pipeline()、parallel()、phase()、log()、budget、args、workflow()。
  6. 校验:python scripts/validate_workflow.py .claude/workflows/pr-triage.js。
  7. 运行:export CLAUDE_CODE_WORKFLOWS=1,保存到 .claude/workflows/,用 /workflows 启动观看;P 暂停/恢复,X 跳过子智能体,失败自动重试。

适用判断:单子智能体单任务用 Agent 工具;可复用且由 Claude 动态选步骤用 Skill;固定拓扑、确定性且可恢复的大量子智能体用 Workflow。并行、多阶段、需可复现、易中途失败或需上下文隔离时 Workflow 才划算,一次性任务直接使用 Claude。

硬性规则(校验器强制):meta 必须是纯字面量且为首条语句;禁止 Date.now()、Math.random()、无参 new Date() 等不确定性;编排器中禁用 require、fs、process、网络等 Node API;parallel() 接 thunk;开放循环须有计数或 budget.remaining() 守卫,否则触及 1000 个智能体上限;过滤用 results.filter(Boolean)。

工具:scripts/workflow_intake.py、scripts/validate_workflow.py、scripts/scaffold_workflow.py,assets/templates/ 与 assets/examples/;脚本支持 --sample 与 --help。

限制:收费、价格、平台等信息暂未提供。