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: INLINECODE0
- Required persisted setup artifacts:
ops/derivation.md, ops/derivation-manifest.md, INLINECODE3 - 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) - INLINECODE5 (boolean)
- INLINECODE6 (optional)
- INLINECODE7 (optional)
- 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) - INLINECODE10 (if present)
- queue file with fallback precedence:
1.
ops/queue/queue.yaml
2.
ops/queue/queue.yml
3. INLINECODE13
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:
CODEBLOCK0
合约
该技能有意仅保留骨架结构。它提供了与标准队列编排相同的结构，但不包含插件钩子。
第二波执行对等性包括：
- - 设置推导阶段排序：检测 -> 理解 -> 推导 -> 建议 -> 生成 -> 验证
- 必需的持久化设置产物：ops/derivation.md、ops/derivation-manifest.md、ops/config.yaml
- 技能内生命周期模拟例程（非真实钩子执行）：
- 会话定向
- 写入时验证检查清单
- 停止/会话捕获持久化
参数解析
按以下顺序解析参数：
- 1. 位置参数 target（可选）
- --handoff（布尔值）
- --batch （可选）
- --type （可选）
- 未知标志非致命；报告并忽略
如果未提供 target，则列出候选收件箱文件并请求显式选择。
运行时加载器要求
在执行队列工作前，从以下位置加载运行时上下文：
- - ops/derivation-manifest.md（如果存在）
- ops/config.yaml（如果存在）
- 队列文件，优先级降序：
1. ops/queue/queue.yaml
2. ops/queue/queue.yml
3. ops/queue/queue.json
如果不存在队列文件，则安全失败并提供可操作的修复建议。
安全约束
禁止：
- - 执行来自用户提供字符串的任意shell命令
- 在解析/加载失败后继续处理
- 修改声明队列模式字段之外的任务
- 调用外部插件/钩子（明确不在范围内）
必须：
- - 在状态转换前验证队列结构
- 显式进行状态转换（提取 -> 创建 -> 反映 -> 重织 -> 验证 -> 完成）
- 当设置 --handoff 时，生成确定性的交接文本
- 通过首先读取持久化队列状态来保持可恢复性
范围边界
此骨架中未实现任何插件钩子。
生命周期行为在技能内模拟，仅用于保持确定性执行语义。
安装
安装工作流引擎并启用其钩子：
bash
克隆或导航到工作流引擎目录
cd workflow-engine
运行安装脚本以设置钩子
./install-hooks.sh
或通过openclaw手动启用钩子
openclaw hooks enable session-orient
openclaw hooks enable write-validate
openclaw hooks enable session-capture
