publish-baselinelisted
Install: claude install-skill ayouaiyouwei-arch/claude_pm_workflows
> 🔧 项目无关骨架版 · 项目专属配置见 PROJECT-PROFILE.md
# Skill · publish-baseline
> 一句话定位:执行基线刷新检查清单后,发布新的基线版本(B主.次.补丁),把发布记录追加到版本登记表与「说明文档.md」。
## 触发条件
- 用户明确要求「发布新基线」「升基线版本」「刷新基线」
- 一批差异条目集中关闭后,需要发布补丁基线
- 一组变更登记累计达到阈值,需要升 minor 版本
- PRD 主版本切换 / 业务边界扩展,需要升 major 版本
- `periodic-review` 技能产出结论:建议升级基线版本
## 输入
| 输入 | 是否必填 | 示例 |
|---|---|---|
| 当前基线版本号 | ✅ | B1.0.0 |
| 目标基线版本号 | ✅ | B1.0.1 / B1.1.0 / B2.0.0 |
| 触发原因 | ✅ | 「<DIFF-XXX> ~ <DIFF-ZZZ> 已关闭」 |
| 关联 PRD 版本 | ✅ | PRD-vX.Y |
| 关联差异条目 / 变更申请编号 | ✅ | <DIFF-XXX>, <DIFF-YYY>, <CHG-XXX> |
## 步骤
1. **读 `baseline/00-基线管理流程.md`**:确认本次升级的版本递增规则(patch / minor / major)
2. **走 `baseline/04-基线刷新检查清单.md`**:
- 启动前 6 项 ✅
- 过程中 4 项 ✅
- 收尾 9 项 ✅(含 4 项测试相关)
- 任意一项不通过 → 立即停止发布
3. **确认所有「待裁决」差异条目均已闭合**:未闭合的必须先走 `log-diff-entry` 或 `log-change-request`
4. **【M1.7 新增】关联交付包闭环校验**
- 扫 `baseline/03-产品变更登记.md`,找出本次纳入的 CHG-XXX 列表
- 对每个 CHG,读其「关联交付包」列:
- 若指向某 `deliverables/<包>.<状态>/` → 必须是 `.done` 状态,否则中止
- 若为「无」(紧急修复 / 历史遗留)→ 在发布通告备注栏说明免包原因
- 同时跑 `ls deliverables/ | grep '\.active$' | wc -l`,必须 = 0(不能在还有 active 时发布基线)
5. **追加版本登记**:在 `baseline/01-基线版本登记表.md` 表格末尾追加一行(已发布行不可修改)
- 字段:版本号 / 生效日期 / 关联 PRD / 关联变更 / 关联差异 / 主要内容 / 发布人
6. **回写差异台账**:把本次纳入的差异条目状态改为「已关闭-纳入 B1.0.x」
7. **回写变更登记**:把本次纳入的变更申请状态改为「已发布-B1.0.x」
8. **【M1.7 新增】批量归档关联交付包**
- 对所有本次纳入的 `.done` 包,调 `promote-deliverable .done → archive/`
- 默认执行(不需 `--cooldown` 等待,因为本次基线发布意味着已经过验收冷却)
- 归档后 `deliverables/` 顶层应清空(仅余 `_template/` / `archive/` / `README.md`