关于 workflow-builder
workflow-builder 是用于编写精简适配器的技能,可对明确提供的独立操作各执行一次,适合需要直接执行而不引入编排逻辑的调用方。
主要功能
- 01显式提供输入、执行器、作用域和输出
- 02每项操作最多分派一次
- 03并行操作须有互不重叠的写入范围
- 04逐项报告输出或错误
- 05不含重试、选择或编排状态
适用场景
- 01分派一组固定的独立操作
- 02在写入范围互不重叠时并行执行操作
- 03通过试运行展示分派次数和错误报告
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ boshu2/ agentops --skill workflow-builder安装后在 Claude Code 中输入/workflow-builder确认已加载。
详细介绍
工作流构建器 — 一次性适配器编写
只有在调用方需要调度一组明确的独立操作时,才构建轻量适配器。工作流只是便利代码,不承担正确性或生命周期权威。
针对明确输入的至多一次调度,是全部安全依据:无法重试或选择工作项的工作流不会扩大故障影响,因此最坏情况是每项操作报告一个错误。
命名故障模式 — 框架引力:一次性脚本逐渐加入配置文件、插件钩子和状态存储,最终变成一个未经请求的编排器。
反模式:添加“失败时重试”,称其只是为了提高健壮性。纠正方式:报告每项操作的错误并停止;是否再次运行由调用方决定。
契约
- 输入、执行器、写入范围和输出均由调用方明确提供。
- 每项操作最多调度一次。
- 并行操作必须具有经调用方确认互不重叠的写入范围。
- 工作流报告每项操作的输出或错误,然后停止。
- 不包含工作选择、重试、预算、队列、跟踪器、验证、Git、集成、收尾、发布或交付逻辑。
- 可选的底层状态无法转换为 RPI 或判定状态。
优先选择目标运行时支持的最小脚本。提供演示精确调度次数和错误报告的试运行或测试夹具。除非调用方明确要求,否则不要创建新的框架或 SDK 抽象。
评论
支持 Markdown