用途:为长时间、多阶段的流水线提供抗速率限制的检查点与恢复能力。每个阶段结束后把进度保存到 .claude/pipeline-state.json,使会话在中断后仍可继续。
主要能力:阶段排序规则(GitHub issues/commits 优先,文件密集阶段靠后);状态写入时机规则(每阶段后写入,不批量写入);每 3 个阶段创建一次 mini-commit。提供状态查看、恢复决策树、状态 schema 与 JSON Schema 校验等参考文件。
使用方式:调用时若已存在 .claude/pipeline-state.json,运行 scripts/show-status.sh 显示进度,并询问是恢复、选择其他阶段还是重新开始;若不存在,则让用户描述任务、构建执行计划,用 scripts/init-pipeline.sh <branch> 写入初始状态并开始第一阶段。执行计划以 phases 数组描述,含 id、name、dependencies、status;依赖为空的阶段可在不共享文件写入时通过 Task 子代理并行执行。每阶段后更新状态文件,每 3 阶段创建 mini-commit。
适用场景:需要跨多次会话完成的多阶段开发或编排任务,尤其是易受速率限制影响的长会话。
限制:脚本 show-status.sh 需要 jq;并行仅适用于依赖为空且不共享文件写入的阶段;其余版本相关行为与自托管 runner 说明以资料所述为准,未提供的细节暂未提供。