| name | aceharness-workflow-creator |
| description | ACEHarness workflow creation skill. Helps reason about serial workflow states, per-state steps, parallel step groups, and scoped workflow patches. |
| descriptionZH | ACEHarness 工作流创建技能。用于判断状态拆分、步骤并发、Agent 分工、检查点和工作流补丁质量。 |
| tags | ["ACEHarness","Workflow","State Machine","Planning"] |
| source | aceharness |
ACEHarness Workflow Creator
你负责帮助设计 ACEHarness 工作流的流程结构、Agent 分工、检查点和失败恢复策略。机器输出格式由系统机制另行指定；本 skill 只提供领域判断和质量标准。
状态与并发
- 状态是串行推进的流程节点。不要把不同状态设计成并发关系。
- 并发只发生在同一状态的步骤里；需要并发时，多个步骤应表达为同一状态内的一组并行工作。
- 状态名要短、稳定、适合状态图展示。
- 终止状态只表达完成、汇总、交付或异常终止意图，不承担新的复杂工作。
- 非终止状态应有清晰的通过、带条件通过、失败重试或回退语义。
状态拆分
优先用 3 到 5 个状态覆盖主流程：
- 准备/澄清：确认输入、范围、风险和验收口径。
- 设计/计划：形成方案、任务切片和检查点。
- 实现/执行：完成核心变更或交付动作。
- 验证/审查：运行检查、红蓝审查、裁决是否可进入下一步。
- 完成：汇总结果、证据和剩余风险。
只有当业务确实需要独立人工审批、独立失败回退或独立可视化进度时，才新增状态。
步骤设计
- 每个非终止状态默认采用 3 步红蓝裁决结构：蓝方/defender 产出当前状态交付物，红方/attacker 挑战漏洞、边界和反例，judge 汇总双方证据并给出
pass|conditional_pass|fail。
- 只有在极简状态、纯人工等待状态或用户明确要求简化时，才可少于红蓝 judge 三步；少于三步时仍必须保留 judge 作为流转出口。
- 每个状态通常 3 个步骤；确有并发执行或补充验证时可扩展到 4 个步骤。
- 步骤 task 要写清输入、动作、输出和验收证据。
- Agent 优先使用系统提供的可用 Agent、推荐 Agent 或模板中的既有 Agent。
- Supervisor 只放在 workflow.supervisor 中负责调度、审阅和检查点建议；不要把 supervisor/default-supervisor 编排为任何步骤的执行 Agent。
- 红蓝审查应放在同一状态内：执行者完成工作，审查者找问题，裁决者判断能否流转。
- judge 是状态出口。非终止状态的 transitions 应读取当前状态 judge 的 verdict，不要让 defender 或 attacker 直接决定状态流转。
- 需要并发时，并发步骤必须共享同一业务目标，并且都能在当前状态内完成。
转移语义
- 非终止状态默认提供
pass、conditional_pass、fail 三条转移，条件都来自当前状态的 judge 输出。
pass 表示当前状态验收标准已满足，可以进入下一状态或完成。conditional_pass 通常表示“已有方向但仍需迭代”，默认回到当前状态继续补充、修正或扩展，不要把它当作无条件前进。fail 表示当前状态的前提、方向或证据不成立，应回到当前状态、上游恢复状态或异常终止；不要跳过必要验证。- 转移条件应描述当前状态裁决结果，例如
condition: { verdict: conditional_pass }；转移 label 再说明为什么留在当前状态或回退。
Spec 追踪
- 如果系统提供 SpecCoding 任务，步骤应绑定真实叶子任务。
- 一个步骤可绑定多个需求或任务，但不要绑定无关任务来“凑完整”。
- 验证、审查、交付类步骤应绑定 tasks 和相关 requirements/design 证据。
补丁质量
设计页优化时只修改目标范围：
- workflow 级：可以调整整体状态/阶段、步骤拆分、Agent 分工和转移。
- state 级：只调整当前状态的说明、步骤、审查和转移语义。
- step 级：只调整当前步骤的 agent、task、skills、检查命令和 spec 绑定。
补丁要保留运行时上下文、工作目录、workspaceMode、已有 skills/mcp 设置和用户未要求变更的配置。
