SuperAPI AI 工具集

workflow-state

办公与效率

查看项目

更新于 10-16 00:02

技能介绍

用途:为 Exarchos 工作流提供持久化状态,使上下文在自动摘要或会话中断后仍可恢复。状态保存在 MCP 事件存储中,而非文件系统;不要扫描 ~/.claude/workflow-state/*.state.json,该路径为旧版且可能过期。

主要能力:支持四种工作流类型 feature、debug、refactor、oneshot,各自有不同起始阶段。可初始化状态、读取全部或指定字段、更新非保留字段、执行受 HSM 校验的阶段转换,并在恢复时对账 git 实际状态。状态包含 artifacts、tasks、worktrees、planReview、reviews、synthesis 等部分。

使用方式:通过 exarchos_workflow 工具操作。初始化用 action: "init" 并传 featureId、workflowType,oneshot 可选 synthesisPolicy。读取用 action: "get",可加 query 或 fields 做字段投影。更新用 action: "update",仅改非阶段字段。阶段变更必须用 action: "transition" 并传 target,且需先更新守卫依赖的字段。可用 action: "describe" 查询参数模式与 playbook。恢复上下文可运行 /exarchos:rehydrate <featureId>,保存进度用 /exarchos:checkpoint。

限制:phase、workflowType、featureId、createdAt、version 为保留字段,不能直接更新;下划线前缀路径也属保留,需通过事件追加写入。tasks 数组仅支持数字下标,不支持 tasks[id=T-001] 这类键名写法;追加任务只能写到当前长度后一位。若状态与 git 不一致,需先对账再更新。多个活动工作流时系统使用最近更新的非完成工作流。

适用场景:需要跨会话延续的开发工作流、阶段推进、任务与 worktree 跟踪、PR 与评审状态记录,以及上下文摘要后的恢复。