用途:本技能负责工作流状态的写入侧,持久化任务详情、worktree 位置、PR URL 与评审状态,使状态在上下文自动摘要后仍能保留。读取/恢复侧由 rehydrate 技能处理。
主要能力:初始化工作流(init,需指定 featureId 与 workflowType,可选 synthesisPolicy);更新非阶段字段(update,如 artifacts、tasks、worktrees);切换阶段(transition,经 HSM 校验并发出 workflow.transition 事件);生成结构化交接输出,包含进度、House Rules、事件提示与恢复说明。工作流类型包括 feature、debug、refactor、oneshot,各自初始阶段不同。
使用方式:通过 exarchos_workflow 工具调用,如 action: "init"、"update"、"transition"、"get"、"describe"、"list"。更新阶段前置字段后再执行 transition。tasks 数组仅支持数字下标(tasks[0]),追加可写至下一空位(最大间隔 1)。状态存于 MCP 事件存储,可用 exarchos_view pipeline 发现活跃工作流,默认按仓库范围,需全部仓库时用 scope: "all"。
适用场景:跨越上下文中断的长流程,如需求开发、调试、重构、轻量改动,在委托完成、PR 创建或多次反馈迭代后建议 checkpoint。
限制:phase、workflowType、featureId、createdAt、version 及下划线前缀路径为保留字段,更新会返回 RESERVED_FIELD;旧路径 ~/.claude/workflow-state/*.state.json 已废弃,不应扫描。恢复时需与 git 状态核对。