promote-deliverablelisted

> 🔧 项目无关骨架版 · 项目专属配置见 PROJECT-PROFILE.md # Skill · promote-deliverable > 一句话定位：**唯一**允许变更交付包状态后缀的入口。每次状态切换前自动跑前置校验（单 active / 验收门槛 / 冷却期），通过后改目录后缀 + 写 `99-状态.md` + 同步 `说明文档.md`，并在违例时锁定包。 ## 触发条件 - PM 评审通过 `.draft`，要派给 Codex（`.draft → .active`） - Codex 完成验收，PM 准备收尾（`.active → .done`） - `.done` 已冷却 ≥ 7 天，PM 归档（`.done → archive/`） - 上游基线 / PRD 推翻本包，需作废（任意状态 → `.superseded`） - 紧急修复包（创建 `.hotfix` 或 `.hotfix → .done`） ## 输入 | 输入 | 是否必填 | 示例 | |---|---|---| | 包路径 | ✅ | `deliverables/<YYYY-MM-DD>-<CHG-XXX>-<中文短名>.draft` | | 目标状态 | ✅ | `active` / `done` / `archive` / `superseded` | | 变更人 | ✅ | PM 姓名 | | 备注 | 选填 | 任意 | | 强制覆盖（跳过校验） | 默认 false，仅 `--force` 时 true | - | ## 状态机（合法路径） ``` .draft ──▶ .active （评审通过） .draft ──▶ .superseded （需求作废） .active ──▶ .done （验收通过） .active ──▶ .superseded （上游推翻） .done ──▶ archive/ （冷却 ≥ 7 天） .done ──▶ .superseded （罕见，验收后才发现废） .hotfix ──▶ .done （紧急修复完成） .hotfix ──▶ .superseded （hotfix 作废） ``` > 任何**非以上箭头**的转移**直接拒绝**（含 `.done → .active` 反向 / `archive → .active` 复活）。 ## 前置校验矩阵 ### A. `.draft → .active` | 校验 | 命令 / 检查 | 通过条件 | |---|---|---| | A1 全空间唯一 active | `ls deliverables/ \| grep '\.active$' \| wc -l` | = 0 | | A2 包内 01 已补完 | grep `<待 PM 填写>` 计数 | = 0（在 01-需求范围与边界.md 内） | | A3 包内 03 已补完 | 同 A2，检查 03-PRD片段.md | = 0 | | A4 包内 06 已补完 | 同 A2，检查 06-验收标准.md | = 0 | | A5 关联 CHG 状态 | 读 baseline/03 内 `<CHG>` 行的"状态"列 | = `已立项` 或更后续 | ### B. `.active → .done` | 校验 | 检查 | 通过条件