SuperAPI AI 工具集

hexabot-workflow-writer

智能体与模型

查看项目

更新于 10-15 22:13

技能介绍

用途:该技能面向 Hexabot v3 的工作流编写与审查,适用于从业务用例生成工作流、审查调试或改进工作流 YAML、设计对话式/手动/定时/事件驱动/系统类智能体自动化,以及设计工作流动作、绑定、记忆需求、LLM 步骤与工具使用。不适用于与 Hexabot 无关的通用聊天机器人文案、通用 AI 策略建议、其他自动化平台,或与工作流/动作/绑定开发无关的 NestJS、React 工作。

事实来源:产出最终 YAML 或动作契约前,应检查当前仓库文件。DSL 与示例见 packages/agentic/DSL.md、dsl.types.ts 及 examples/ 下的 workflow.yml;运行时校验见 workflow.ts、workflow-compiler.ts 与 tests;API 集成见 packages/api/src/workflow/;动作与绑定见 packages/api/src/actions/、extensions/actions/、bindings/;共享类型见 packages/types/src/workflow/**。若当前工作区只有打包技能,应使用内置参考与示例,并说明仍需 Hexabot 仓库或运行中 API 做运行时验证。内置 API 动作并非穷尽,用户可从 npm 安装动作包或在 CLI 项目中创建本地自定义动作,不得虚构不支持的 YAML 字段。

MCP:当 AI 编码代理暴露 Hexabot MCP 服务器时,优先用它获取实时上下文,检查运行时动作、工作流模式、绑定、记忆定义、已配置 MCP 服务器、凭据占位符与现有工作流。若不可用,可继续用仓库文件与内置参考,并建议用户配置:确保应用环境 MCP_ENABLED=false,在 http://localhost:3000/profile 生成 MCP 令牌,再将 Hexabot MCP 服务器加入 OpenCode、Codex、Claude Code 等支持 MCP 的工具。切勿要求用户把令牌粘贴到工作流 YAML 或技能输出中。

YAML 规则:根字段支持 inputs、context、defaults、defs、flow、outputs。对话式与定时工作流应省略根 inputs,因为 API 拥有固定触发输入模式,声明 inputs.schema 会被当作严格解析器,可能拒绝 message_type、message、mid、triggered_at 等运行时字段。名称、描述、WorkflowType、schedule cron、发布状态、布局与版本消息位于 YAML 之外的 API 工作流记录中。defs 是根注册表,任务 def 用 kind: task 并声明 action,非任务 def 用绑定 kind 且必须声明 settings。flow 原语为 do、parallel、conditional、loop,loop 需 type: for_each 或 type: while。以 = 开头的字符串按 JSONata 求值,字面字符串不得以 = 开头,最终 outputs 值必须是表达式字符串。所有 JSONata YAML 标量需用双引号或块标量,尤其含三元冒号、正则、对象/数组字面量及 :、?、{}、[]、#、引号时。表达式可用 $input、$context、$output.<task>、$iteration、$accumulator。不支持任务输出映射,原始动作结果存于 $output.<task>。绑定引用必须指向存在且 kind 匹配的 defs,内置绑定 kind 包括 model(单引用)及 tools、memory、mcp(数组)。

编写流程:先确定工作流类型与触发方式;检查 MCP 可用性;检查动作模式与工作流类型兼容性;手动工作流定义最小 inputs.schema,对话式与定时工作流省略根 inputs 并从 $input 读取触发字段;列出所需动作与外部集成并映射到现有动作名或注明自定义动作设计;仅在动作需要时添加绑定;记忆保持显式,使用现有记忆定义 ID/slug 或单独记录所需定义;先构建小流程,再按需添加分支、并行、循环、重试与人工接管;提交前对确切 YAML 字符串做解析与表达式引号检查,并校验表达式、任务引用、绑定基数与最终输出。

审查流程:先按 YAML 解析,凡以 = 开头的裸 JSONata 标量即失败;用 MCP 做运行时检查,否则说明缺失运行时验证;按 WorkflowDefinitionSchema 检查形状并标记对话式/定时工作流上的根 inputs;核对每个 flow 任务引用与 defs;核对动作名与运行时注册表、MCP 或源码;检查绑定 kind、基数、def 引用、嵌套绑定与允许列表;检查工作流类型适配;检查 LLM 提示的注入暴露、密钥泄露、模糊输出与缺失结构化输出模式;检查 defaults.settings、任务设置、重试、回退分支与人工升级等错误处理;按严重程度报告并给出具体 YAML 路径与仓库引用。

输出格式:生成新工作流时给出简短假设、YAML 外需配置的元数据、围栏 yaml 块中的最终 YAML 与验证说明;审查时先按严重程度列发现,再给开放问题、建议补丁片段与验证步骤;动作设计给出动作名、工作流类型、输入/输出/设置模式、支持的绑定、幂等性、错误、可观测性与测试预期;演示用例设计给出受众、叙事、工作流类型、触发、动作、绑定/记忆、正常路径、失败路径与 UI 展示内容。

限制:资料未提供具体价格、收费、平台支持范围或效果保证;运行时验证依赖 Hexabot 仓库或运行中 API,缺失时不得虚构运行时 ID。