workflow
工作流引擎核心命令。管理工作流生命周期(创建、确认、拒绝、跳过、重试、提交、恢复),以及在人工节点等待时通过 workflow_choice 工具解读用户自然语言意图。
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 603
- Forks
- 82
01 前言 Front Matter
- name
- workflow
- description
- 工作流引擎核心命令。管理工作流生命周期(创建、确认、拒绝、跳过、重试、提交、恢复),以及在人工节点等待时通过 workflow_choice 工具解读用户自然语言意图。
- command-tool
- workflow_engine_dispatch
- user-invocable
- true
- command-arg-mode
- raw
- command-dispatch
- tool
03 SKILL.md 正文
工作流引擎核心命令
管理工作流生命周期,支持以下子命令:
子命令
| 子命令 | 说明 | 示例 |
|---|---|---|
run |
启动工作流 | /workflow run <workflow-id> |
confirm |
确认人工节点(可带 choice) | /workflow confirm --flow-id <id> |
confirm choice: <value> |
选择分支并确认 | /workflow confirm choice: fast --flow-id <id> |
reject |
拒绝当前节点 | /workflow reject --flow-id <id> |
skip |
跳过当前节点 | /workflow skip --flow-id <id> |
retry |
重试当前节点 | /workflow retry --flow-id <id> |
revise |
修改并重新提交 | /workflow revise --flow-id <id> |
submit |
提交表单数据 | /workflow submit --flow-id <id> |
resume |
恢复挂起的工作流 | /workflow resume --flow-id <id> |
workflow_choice 工具
当人工节点处于 waiting 状态且 L1 关键词匹配未命中时,Agent 应使用 workflow_choice 工具解读用户自然语言意图。
参数
flowId(string, required): 等待中的工作流 IDchoice(string, required): 解读后的选择值,必须匹配 inputSchema 中的 enum 值reason(string, optional): 选择原因或用户附加说明
使用时机
- 工作流有人工节点处于 waiting 状态
- 用户发送了自然语言消息(如「批准」「快速处理」「我选深入分析」)
- L1 Hook 关键词匹配未命中(inputSchema 无 keywordAliases 或关键词未匹配)
- Agent 需要解读用户意图并调用 workflow_choice 完成选择
示例
- 用户说「批准」→
workflow_choice(flowId="...", choice="approve") - 用户说「我选方案B」→
workflow_choice(flowId="...", choice="thorough") - 用户说「算了不要了」→ 调用
/workflow reject --flow-id <id>
意图识别规则
- 用户输入
/workflow <子命令>→ 调用 workflow_engine_dispatch 工具,command 参数为原始输入 - 用户在等待中工作流上下文说自然语言 → 先尝试 L1 关键词匹配,未命中则使用 workflow_choice 工具
04 同仓库更多 Skills
clawbench-bcn
使用成套 Case/Profile 执行 BCN 群协作评测,归档真实群消息与成员证据、按单 Agent 模板进行代码或模型评分并生成成功或失败报告。当前仅支持本地 POC,评测由独立 Agent 完成。
bbs-topic-handler
【仅由 Topic 子 Session 触发】处理一个 BBS Topic。收到 [BBS-TOPIC-HANDLER] 且包含 backend、bot_id、browse_id、单个 topic_id 时使用;以详情接口的 topic_type 决定上下文、回复形态和作者管理:DISCUSSION 可读完整讨论并允许楼中楼,SHARE/HELP 参与者只基于主帖回复,POLL 提交结构化选择,HELP 原作者独立 Review 一级回复、标 helpful 并在解决后 close。历史回复只阻止重复回帖,不跳过作者管理。只调用内部 `/api/v1/**`,本地 BBS API 必须通过 OpenClaw `exec` 执行 `curl`,禁止 `web_fetch` 或 `browser` 访问。不选择其它 Topic,不创建子 Session。
bbs-create-topic
专门创建一个有明确类型的 BBS Topic。当用户要求发帖、发起讨论、分享、投票或求助时使用;整理 title/body,确定 DISCUSSION、SHARE、POLL 或 HELP,并按类型补齐 topic_config 后调用 Bot 内部 CreateTopic 接口。只调用内部 `/api/v1/**`;本地 BBS API 必须通过 OpenClaw `exec` 执行 `curl`,禁止 `web_fetch` 或 `browser` 访问。不浏览、不回帖、不派生子 Session、不管理订阅或 cron。
bbs-browse
Avernet 开源本地 Demo 的 BBS Browse Run 编排 skill。收到 [BBS-BROWSE]、用户单次触发、周期任务或可信运行时事件提供的一次性 Browse Run 指令时使用;分页读取内部 /api/v1/collaboration/tasks/bbs/topics 的全部 OPEN Topic,Demo 规则下每个去重后的 OPEN Topic 都派发给 bbs-topic-handler 子 Session,保证每个 Bot 对每个主题完成一次有内容的强制首轮回复;最多 3 个并发。只调用内部 `/api/v1/**`;本地 BBS API 必须通过 OpenClaw `exec` 执行 `curl`,禁止 `web_fetch` 或 `browser` 访问。不创建订阅或 cron,不代替子 Session 回复、沉淀或结帖。
avernet-collaboration-help
解答 Avernet 自定义协作问题,编写或修改 BCS state_machine YAML,解释校验诊断,并通过固定版本短引用提供只读预览。
undercover-game-referee
主持谁是卧底,按当前节点或唤醒执行事实层命令与主持稿,保持发言、投票、遗言和终局流程。