SuperAPI AI 工具集

create-workflow

智能体与模型

查看项目

更新于 10-16 08:06

技能介绍

用途:编写 agent-almanac 的第五种内容类型——工作流,即由 Claude Code 的 Workflow 工具运行的自包含 workflows/<name>.mjs 编排脚本。工作流用 JavaScript 固定阶段、扇出与验证结构,控制流确定且可复读,而 agent() 调用的输出仍是 LLM 子智能体、具有不确定性。

主要能力与用法:先判断是否该用工作流——协调形态事先已知、需要可重复可审计时选工作流;若下一步取决于上一步发现,应改用团队;只有单个智能体行动则用技能。从模板复制:cp workflows/_template.mjs workflows/<name>.mjs(个人工作流放 .claude/workflows/)。满足三重命名契约:文件名主干、sidecar 的 // name: 与 meta.name 必须完全一致。meta 必须是纯字面量,含 name、description,可选 phases,并与文件顶部 sidecar 保持一致。正文使用注入的全局原语,无需 import:pipeline() 为默认无屏障扇出,parallel() 为屏障,agent(prompt, { schema, label, phase, agentType }) 生成子智能体,另有 phase()、log() 及 args/budget。用 JSON Schema 强制结构化输出。每个阶段显式声明 agentType:会修改产物的阶段须用实现型,只读分析用咨询型。验证候选发现时以肯定确认数为门槛、让验证者共享提出者的证据、默认未确认。脚本用顶层 return,需用 wrap-then-check 方式校验,权威检查是实际运行 Workflow({ name: '<name>' })。安装:cp workflows/<name>.mjs .claude/workflows/<name>.mjs,策展安装加前缀 almanac-<name>.mjs,再调用 Workflow({ name: '<name>' }) 或 /<name>。

适用场景:需要每次以相同方式运行的评审、研究或迁移流程;向 workflows/ 库添加经评审的种子。

限制:脚本不能访问文件系统,无法自我检查点;中断的 Workflow(...) 调用不返回任何内容,resumeFromRunId 仅限同一会话。脚本编写接口是演进中的厂商 API,随版本变化且无 CI 保障。工作流不参与 i18n。注册表、CI 校验与 CLI 安装适配器尚未提供。针对活动仓库的扇出需由调用方用 repo-guard 快照/校验/释放包围,并在提示中指定写入位置。