name: t-prd-publish description: After implementation and acceptance, summarize the draft PRD against delivered facts, then revise the existing formal PRD. argument-hint: "[feature-name]" allowed-tools:

• AskUserQuestion
• Read
• Glob
• Grep
• Write
• Bash

metadata: version: "1.0.1"

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 或用户故事写入成功但草稿或决策账本删除失败 → 报告为收尾失败，要求用户手动处理该草稿或账本