核心用法
workflow-orchestrator 是一个结构骨架型技能，旨在为队列驱动的工作流编排提供标准化的执行框架，而非完整的工作流引擎实现。它严格遵循 Wave 2 执行对等原则，强制阶段顺序：detection → understanding → derivation → proposal → generation → validation，并通过持久化配置（ops/derivation.md、ops/derivation-manifest.md、ops/config.yaml）确保可恢复性。
用户可通过 [target] [--handoff] [--batch <id>] [--type <phase>] 参数灵活调用，支持批次处理与显式阶段过滤。无目标时自动列举候选文件，降低认知负担。
显著优点
1. 结构确定性：强制六阶段流水线，消除状态跃迁的随机性
2. 安全优先设计：明确禁止执行用户输入的任意 Shell、禁止失败后继续处理、禁止修改队列 Schema 外字段
3. 可观测性：状态变更显式化（extract → create → reflect → reweave → verify → done），支持 --handoff 生成确定性交接文本
4. 弹性容错：队列文件多格式降级（yaml → yml → json），无队列时提供可操作的修复指引
潜在局限
- 纯骨架无实现：明确声明无插件钩子，生命周期行为仅为"模拟"，无法替代真实工作流引擎
- 依赖外部
install-hooks.sh或openclaw命令才能激活完整功能，当前技能本身无法自举 - 对非 YAML/JSON 队列格式无支持
适合人群
- 需要工作流结构原型验证的架构师
- 追求确定性执行语义的自动化脚本开发者
- 研究队列编排模式、但暂不引入完整引擎的学习者
常规风险
| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 执行安全 | 低 | 明确禁止任意 Shell 执行，但仍需警惕配置文件注入 |
| 配置漂移 | 中 | 多来源加载（manifest/config/queue）可能导致预期外状态 |
| 功能误解 | 高 | 用户可能误将"骨架"当作完整引擎使用，导致生产故障 |