用途:gsd-path-ship 属于 GSD Path 工作流的收尾阶段,职责是验证已完成的里程碑、管理基于证据的补丁决策、请求最终发布批准,并在批准后归档已校验结果。该技能始终先验证,未获得明确最终批准前不会归档或发布;波次评审由构建编排器负责,本阶段不运行。
主要能力:要求 .project/STATE.md 中标记 pipeline gsd-path/v2,否则返回 $gsd-path 做归属检查。读取本地评审角色与派发契约并解析为绝对路径;解析 scripts/isolation.py 用于验证侧车,解析 scripts/build_state.py 用于已落地任务证明与验证台账。派生跨波次集成风险的稳定编号列表,仅列真实风险,不凑数;PLAN.md 的项目 Verify 作为编号风险 1,由编排器执行一次并写出缺口产物。对每个无复用输出的风险派发一名评审者,使用逻辑任务名 review_gap_<number>,仅分配 .project/review/final-gap-N.md。集成评审使用 review_final,仅分配 .project/review/FINAL.md。
使用方式:运行 python3 <absolute workflow_run.py> prepare-final --repo <absolute primary> --expected-head <HEAD> 完成落地检查、项目 Verify 隔离与执行、输出记录与收集。派发前用 python3 <absolute isolation.py> isolate-verify --repo <absolute primary> --base <HEAD> --name review-gap-<number> 创建侧车;用 collect-artifact 收集返回产物,用 retire 退役侧车。全部收集后运行 python3 <absolute check_handoffs.py> final --repo <absolute repo root>;若有阻塞缺口则写 .project/review/PATCH-FINDINGS.md 并运行 check_handoffs.py patch。归档时用 python3 -B <project>/.gsd-path/status_runtime.py --repo <project> --runtime-path 解析运行时,再用 archive_milestone.py 与 pipeline_state.py 执行 prepare、render-manifest、preflight、record-shipment、validate、integrate、validate-integrated。
适用场景与限制:用于单仓或多成员里程碑的最终验证、补丁决策与归档事务,包含崩溃恢复路径。限制包括:项目 Verify 非零即停止本步;评审者从不修复产品代码;FINAL.md 的 Reviewed HEAD 必须与当前 HEAD 一致;不创建额外 .project/ 执行报告;不得重跑项目 Verify 来修补证据;归档顺序号须与 gsd-path/M00N 分支一致,拒绝 000-* 条目;仅归档校验全部通过且无待办讨论跟进时才请求发布批准,拒绝批准则保持评审活跃且不做归档变更。资料未提及收费、价格或平台支持信息。