t-prd-publish

Files (1)

• SKILL.md

SKILL.md (first lines)

# PRD 发布总结与正式文档修正

运行时边界：`${CLAUDE_PLUGIN_ROOT}/protocols/runtime-boundaries.md`（判断产物写入位置或脚本入口与插件默认冲突时读）
需求来源边界：`${CLAUDE_PLUGIN_ROOT}/protocols/requirement-source-contract.md`（区分草稿与已发布需求来源或处理两者冲突时读）
决策连续性和用户决策暴露：`${CLAUDE_PLUGIN_ROOT}/protocols/decision-continuity-contract.md`（提问、更新决策账本或处理决策暴露门禁时读）

若草稿、正式 PRD、用户故事或规范之间冲突，以明确澄清为继续条件：停止、说明冲突并等待决策。

## 目标

在实现、测试和 Demo 验收完成后，基于 `.ai/prd/<domain>/<feature>.md` 草稿、`.ai/user-stories/<domain>/<feature>.md` draft 用户故事、现有正式 PRD / 用户故事和实现后证据，先总结"草稿提出了什么、最终交付了什么、现有正式文档缺什么或哪里过期"，再修正增补现有 `docs/prd/<domain>/<feature>.md` 和 `docs/user-stories/**/*.md`。没有正式 PRD 或合适用户故事文件时才创建。完成后删除对应 `.ai/prd` 和 `.ai/user-stories` 草稿，并把 `.ai/decision-log/<feature>.md` 中仍然有效的决策内化进正式 PRD 后移除该账本。

输出文件：
- `docs/prd/<domain>/<feature>.md`
- 可能更新：`docs/prd/00-index.md`、`docs/user-stories/**/*.md`
- 清理：`.ai/prd` 与 `.ai/user-stories` 草稿、`.ai/decision-log/<feature>.md`（如存在）

## 核心约束

- 固定在实现、测试和 Demo 验收完成之后运行；缺少完成证据时停止。
- 核心动作是先做发布总结并获用户确认，再修正增补现有正式文档；以差异归纳和事实合并为主，只把仍然成立、且属于长期产品语义的内容写入 `docs/prd`。
- 正式 PRD 内容聚焦产品语义；端点明细、schema、建表、代码类型和实施进度状态留在设计、任务或实现证据中。
- 发布范围限定为正式 PRD、正式用户故事、PRD 索引、草稿清理和决策账本内化移除；不修改交付代码。故事追溯按 `${CLAUDE_PLUGIN_ROOT}/protocols/requirement-source-contract.md` 的 Story Traceability。
- 仍然有效的 D0/D1 决策必须内化为正式 PRD 的产品事实（业务规则、范围、边界表述），不照搬账本表格、不携带 DEC/Q ID；D2 决策留在设计与任务产物，不进正式 PRD。

## Input Contract

必须读取：
- `.ai/prd/<domain>/<feature>.md` — 待发布 PRD 草稿
- `.ai/user-stories/<domain>/<feature>.md` — 待发布 draft 用户故事（如存在）
- `docs/prd/<domain>/<feature>.md` — 已发布正式 PRD（如存在）
- `docs/prd/00-index.md` — 正式 PRD 索引（如存在）
- `docs/user-stories/**/*.md` — 草稿引用的用户故事
- `.ai/design/<feature>.md` — 相关技术设计（如存在）
- `.ai/decision-log/<feature>.md` — 跨阶段决策账本（存在时必须读取）
- `.ai/task/<feature>/.state.json` — 可选实现阶段背景材料（如存在）
- `${CLAUDE_PLUGIN_ROOT}/guides/product/prd.md`
- `${CLAUDE_PLUGIN_ROOT}/guides/product/user-story.md`
- `${CLAUDE_PLUGIN_ROOT}/protocols/requirement-source-contract.md`
- `${CLAUDE_PLUGIN_ROOT}/protocols/prd-check-rubric.md`

如果找不到草稿，立即失败并提示先执行 `/t-prd [feature]`。

## 工作流程

### 1. 校验参数与定位草稿

- 检查 `[feature]` 非空且符合文件名规则（英文、数字、空格、下划线、连字符）
- 在 `.ai/prd/**/*.md` 中按文件名精确匹配 `[feature]`；多个 domain 匹配时停止并让用户选择
- 目标路径固定为 `docs/prd/<domain>/<feature>.md`

### 2. 发布前检查与发布摘要确认

读取草稿、正式 PRD、索引、相关用户故事、设计和验收报告（`.ai/task/<feature>/.state.json` 如存在，仅用于理解实现阶段背景；发布判断以 PRD 草稿、正式文档、设计、质量报告、Demo 验收和交付证据为准）。检查并形成结论：

- 草稿核心章节完整性、PRD 内容边界符合性；draft 用户故事的 INVEST、GWT 和内容边界
- 草稿引用的用户故事是否存在；草稿、draft 用户故事、正式 PRD / 用户故事和实现后证据的一致性与已说明差异
- 仍然有效的 D0/D1 Active Decision 及带产品语义的 Resolved Question 是否已内化为正式 PRD 的产品事实；D2 决策是否留在设计与任务产物；Superseded Decision 不得发布为当前事实
- 是否存在 `Must Resolve Before=t-prd-publish` 或更早但尚未解决的 Deferred Question；存在时先完成用户裁决。账本在发布时移除，因此任何剩余 Deferred Question（无论最迟解决阶段）都必须先解决或经用户确认关闭，不得随账本一起丢失
- 现有正式 PRD / 用户故事的缺失、过期或与已交付产品语义不一致问题
- 草稿中哪些内容应写入、删去、降级或仅作为发布摘要说明；draft 用户故事中哪些应追加、合并、改写、删去或仅作摘要说明；索引是否需要新增或更新条目
- 是否已有实现和适用测试/Demo 的验收完成证据；按 `${CLAUDE_PLUGIN_ROOT}/protocols/verification-evidence-contract.md` 核对验证责任表与原始证据，所有必要场景已收口，不能把上游“本阶段通过、业务验收待完成”当作发布完成证据

发现 P0 问题或缺少完成证据时停止发布并输出修复建议。

通过后先向用户展示发布摘要并用 `AskUserQuestion` 请求确认：草稿路径与目标路径、修正增补类型（revise / append / create-if-missing）、与现有正式 PRD / 用户故事的关键差异、草稿与实现后证据的对齐结论、待内化进正式 PRD 的有效决策要点、将写入的长期产品事实与用户故事的角色/场景/验收标准、用户故事引用变化、索引更新计划、阻塞风险或"无"。未获得确认则结束本轮发布。

### 3. 写入正式文档

用户确认后：
- 基于草稿、正式 PRD 和实现后证据，修正/增补 `docs/prd/<domain>/<feature>.md` 和 `docs/user-stories/**/*.md`；保留仍有效的既有内容，只修正缺失、过期、冲突或需增补的部分；新增或合并 draft story 时保持角色引用、INVEST 和 GWT 验收标准
- 写入内容采用当前产品能力、业务规则或验收目标表述，避免用"已完成/已实现/本次交付"等实施进度表述承载长期事实
- 目标正式 PRD 不存在时才创建；如索引存在，更新 `docs/prd/00-index.md` 对应条目（遵循目标项目现有索引文件）
- 删除草稿前核对本轮测试的稳定 US ID 可在正式故事唯一定位、已有正式路径引用有效；不要求仅有 US ID 的测试补路径。映射缺失则保留草稿并报告收尾未完成，修正后重入；验收语义变化先重新验收。
- 删除 `.ai/prd/<domain>/<feature>.md` 和 `.ai/user-stories/<domain>/<feature>.md`（如存在）；对应空目录可一并删除
- 删除 `.ai/decision-log/<feature>.md`（如存在）；删除前提是其仍然有效的 D0/D1 决策已内化到正式 PRD，且无未解决或未经用户确认关闭的 Deferred Question

### 4. 发布后验证

- 重新检查正式 PRD 可读且路径正确
- 确认本轮测试故事映射在正式来源可解析，记录来源迁移；US ID 合并时保留可追溯关系。
- 确认对应 `.ai/prd` 草稿已不存在；`.ai/user-stories` 草稿已不存在或本轮本就不存在
- 确认 `.ai/decision-log/<feature>.md` 已不存在或本轮本就不存在

## 收尾输出

完成后明确说明：修正增补类型、正式 PRD 路径、正式用户故事更新路径（如有）、已删除的草稿路径、已内化的决策要点与已移除的决策账本路径（如存在）、是否更新索引、发布后建议命令（`/t-prd-check [feature]` 做正式 PRD 校验；通过后可进入 `/t-release [version]`）。

## 失败处理

- 草稿不存在 → 提示先执行 `/t-prd [feature]`；多个草稿匹配 → 停止并要求用户指定 feature/domain
- 草稿或 draft 用户故事存在 P0 问题 → 停止并列出必须修复项
- 存在未解决或未经用户确认关闭的 Deferred Question → 先完成裁决或关闭，再执行发布
- 缺少实现、测试或 Demo 验收完成证据 → 停止并提示先完成对应阶段
- 用户未确认发布 → 结束本轮发布
- 写入失败 → 报告路径和错误，保留草稿
- 正式 PRD 或用户故事写入成功但草稿或决策账本删除失败 → 报告为收尾失败，要求用户手动处理该草稿或账本

From timzaak/web-dev-skills, Apache-2.0.

More from timzaak/web-dev-skills