用途:作为 Story 执行编排器,按确定性顺序处理 Story 下的任务,负责任务排序、worktree 生命周期、任务/分组检查点,以及最终把 Story 转为 To Review(绝不转为 Done)。
主要能力:输入 storyId(必填)与可选 --rework-focus;状态过滤为 Todo、In Progress、To Rework、To Review;执行顺序为 To Review → To Rework → Todo;仅当显式标记时才并行运行 Todo 分组;每个执行/返工步骤后强制立即评审;运行时状态持久化在 .hex-skills/story-execution/runtime/,可恢复。
使用方式:通过运行时 CLI 启动与推进,例如 node references/scripts/story-execution-runtime/cli.mjs start --story {storyId} --manifest-file .hex-skills/story-execution/manifest.json,以及 status、checkpoint、record-worker、record-group、record-stage-summary、record-loop-health、advance 等子命令。工作流分阶段:配置、发现、worktree 设置、选择工作、任务执行、分组执行、状态校验、场景验证、Story 转 To Review、自检,可选元分析。执行器与返工者通过 task-worker-runtime 隔离运行,评审器 ln-402 内联运行。
适用场景:Story 已有规划好的任务、准备进入实现阶段时使用。
限制:运行时状态是编排的单一事实来源,看板是任务状态的事实来源;不得批量评审;不得将 Story 移至 Done;每个 worker 结果必须从 summary JSON 读取;重复相同错误或无进展时运行时会暂停;场景验证最多 2 轮,仍失败则暂停等待用户复核。部分细节(如具体 agent 可用性)依赖环境,资料未提供更多说明。