工作流编排器：队列驱动的 AI 智能体框架 - Openclaw Skills

什么是 工作流编排器？

工作流编排器是一个技术框架，旨在为工作流上下文中的队列驱动编排提供结构对等性。它是开发人员构建需要严格阶段顺序和状态管理的复杂 AI 智能体时的基础组件。通过在 Openclaw Skills 生态系统中使用此技能，用户可以确保其智能体工作流遵循标准化的生命周期，包括检测、理解、推导、提案、生成和验证。

该技能特别注重执行对等性和确定性行为。它通过特定的持久化产物（如推导清单和配置文件）管理运行时上下文，从而实现可靠的会话恢复和移交。虽然它作为一个不带外部插件钩子的骨架运行，但它模拟了关键的生命周期例程，以维持高标准的写入时验证和会话捕获。

下载入口:https://github.com/openclaw/skills/tree/main/skills/plgonzalezrx8/workflow-engine

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install workflow-engine

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 workflow-engine。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

工作流编排器 应用场景

• 通过结构化的 YAML 或 JSON 队列管理大规模批处理任务。
• 编排需要明确状态转换的多步骤 AI 开发工作流。
• 标准化不同 AI 智能体或人工在环会话之间的移交过程。
• 实现可恢复的长运行任务，跨会话捕获持久化状态。
• 在文件写入阶段执行验证清单，防止数据损坏。

工作流编排器 工作原理

1. 该技能解析传入参数以识别目标、批次 ID 和特定阶段类型（例如：提取、创建或验证）。
2. 它通过检查 ops 目录中的配置文件和推导清单来加载运行时环境。
3. 编排器根据特定的回退优先级搜索队列文件，从 ops/queue/queue.yaml 开始。
4. 进入执行阶段，严格遵循设置的推导顺序：检测、理解、推导、提案、生成和验证。
5. 在执行期间，它模拟生命周期例程，如会话定位和写入时验证清单。
6. 完成或中断后，它会生成确定性的移交文本并持久化当前状态以供未来恢复使用。

工作流编排器 配置指南

要将工作流编排器集成到您的 Openclaw Skills 设置中，请按照以下步骤操作：

# 进入 workflow-engine 目录
cd workflow-engine

# 执行安装脚本以配置钩子
./install-hooks.sh

您也可以使用 CLI 手动启用所需的生命周期钩子：

openclaw hooks enable session-orient
openclaw hooks enable write-validate
openclaw hooks enable session-capture

工作流编排器 数据架构与分类体系

该技能使用结构化的目录模式组织其操作，以确保数据完整性和可追溯性。

产物	路径	描述
推导状态	ops/derivation.md	跟踪推导逻辑和当前阶段的主文件。
清单	ops/derivation-manifest.md	关于设置产物和推导历史的元数据。
配置	ops/config.yaml	全局设置和工作流参数。
任务队列	ops/queue/queue.yaml	主要任务列表（支持 .yml 和 .json 扩展名）。
会话日志	ops/session-capture	用于恢复中断工作流的持久化状态。

name: workflow-orchestrator
description: Structural parity skeleton for queue-driven orchestration in a workflow context.
user-invocable: true
version: "0.1"
allowed-tools: Read, Write, Edit, Grep, Glob, Bash
argument-hint: "[target] [--handoff] [--batch ] [--type ]"

Contract

This skill is intentionally skeleton-only. It provides structure parity with canonical queue orchestration without plugin hooks.

Wave 2 execution parity includes:

• Setup derivation phase ordering: detection -> understanding -> derivation -> proposal -> generation -> validation
• Required persisted setup artifacts: ops/derivation.md, ops/derivation-manifest.md, ops/config.yaml
• In-skill lifecycle emulation routines (not real hook execution):
  • session orient
  • write-time validation checklist
  • stop/session capture persistence

Argument Parsing

Parse arguments in this order:

1. positional target (optional)
2. --handoff (boolean)
3. --batch (optional)
4. --type (optional)
5. unknown flags are non-fatal; report and ignore

If no target is supplied, list candidate inbox files and request explicit selection.

Runtime Loader Requirements

Before doing queue work, load runtime context from:

• ops/derivation-manifest.md (if present)
• ops/config.yaml (if present)
• queue file with fallback precedence:
  1. ops/queue/queue.yaml
  2. ops/queue/queue.yml
  3. ops/queue/queue.json

If no queue file exists, fail safely with actionable remediation.

Safety Constraints

Never:

• execute arbitrary shell from user-provided strings
• continue processing after parse/load failures
• mutate tasks outside declared queue schema fields
• call external plugins/hooks (explicitly out of scope)

Always:

• validate queue structure before state transitions
• make state transitions explicit (extract -> create -> reflect -> reweave -> verify -> done)
• produce deterministic handoff text when --handoff is set
• preserve resumability by reading persisted queue state first

Scope Boundary

No plugin hooks are implemented in this skeleton. Lifecycle behavior is emulated in-skill to preserve deterministic execution semantics only.

Installation

To install the workflow-engine and enable its hooks:

# Clone or navigate to the workflow-engine directory
cd workflow-engine

# Run the install script to set up hooks
./install-hooks.sh

# Or manually enable hooks via openclaw
openclaw hooks enable session-orient
openclaw hooks enable write-validate
openclaw hooks enable session-capture