pdlc-ship

发布工作流

串联发布一个版本所需的所有步骤：跑测试 → 升级 VERSION → 更新 CHANGELOG → 创建 tag → 推送触发 CI/CD。

⛔ 发布是破坏性·不可逆操作：打 tag / bump 版本 / 触发 CI/CD 属破坏性范畴。--autonomous 对本命令无效——即使带该参数，§1.1（未完成功能）与 §1.2（测试门）的人工确认仍必须真实由人应答。自主循环（/pdlc-loop-run）的终态是 review_done，永不进入本命令。

段一：执行

1.1 前置检查

1. 确认当前分支不是 master / main（参考 CLAUDE.md §5）

2. 确认工作区干净（git status clean）

3. 检查 docs/.pdlc-state/ 下是否有未完成的功能（current_stage 不在 [*_done] 的）

   • 有 → 列出来并询问是否继续（用户明确同意才继续）
   • 无 → 直接进入下一步

4. 质量闸门检查（若项目有 docs/00_standards/quality-targets.yml）： 读 docs/07_reviews/quality/ 下最近一份 .md 报告（同名 .html 只是视图， 闸门一律以 .md 为准——两者若不一致，信 .md）：

   • 无任何报告 → 提示先跑 /pdlc-quality，询问是继续还是先出报告
   • 报告总判定未达标 → 默认不放行；要发必须由人显式 override 并写明理由， 该理由需记入本次发布的 CHANGELOG 或发布说明（不允许无声跳过）
   • 报告过期——分两档处理，不是所有过期都等价（见下）
   • 达标且未过期 → 在发布报告里引用该报告路径、日期与 commit SHA 作为质量证据

   过期判定：按「改动了什么」分两档

   报告头部记着生成时的 <!-- 仓库版本: <commit SHA> -->（由 /pdlc-quality 落盘时写入）。 取该 SHA，跑 git diff --name-only <SHA>..HEAD 看这期间动了什么：

   这期间改动命中	判定	理由
   docs/01_requirements/prd/、docs/00_standards/quality-targets.yml、docs/00_standards/e2e-flow-map.yml、docs/00_standards/test-commands.yml	硬闸·不放行	报告里的 PRD ↔ core_flows 对账与 E2E 覆盖矩阵的输入变了，结论不再成立。重跑单测补不回对账——必须重跑 /pdlc-quality
   只有其它代码 / 文档	提示已过期，建议重跑	对账仍成立，测量数字可能略旧
   报告里没有 仓库版本 字段，或该 SHA 在本仓库解析不了	按「不可判」处理：明确告知无法核对新鲜度，建议重跑	与三态语义同一条纪律——「查不了」不等于「没问题」，不得静默当作未过期

   ⛔ 硬闸同样允许人显式 override 并写明理由（与「总判定未达标」同一条通道，理由须记入 CHANGELOG 或发布说明），但不得无声跳过。

   quality-targets.yml 变动要单独看一眼「闸门是不是被调松了」

   若上表命中的文件里包含 quality-targets.yml，除了要求重跑，还必须把 git diff <SHA>..HEAD -- docs/00_standards/quality-targets.yml 原样展示给人， 并逐条点出下列「变松」信号——命中任何一条都要人明确确认，不得只当作普通过期：

   • 覆盖率目标数字下降（如 85 → 70）
   • core_flows 条目减少（核心流被移出闸门视野）
   • lint 策略放宽（如 zero-warnings 改为允许若干 warning）
   • 新增了豁免声明（把某些 PRD / 流程排除在对账之外）