t-prd-publish

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"]

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

运行时边界统一参考：${CLAUDE_PLUGIN_ROOT}/protocols/runtime-boundaries.md 需求来源边界统一参考：${CLAUDE_PLUGIN_ROOT}/protocols/requirement-source-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 草稿。

该 skill 聚焦“代码实现后，如何把通过草稿沉淀的新需求同步回长期 PRD”。输出应体现已稳定的产品事实、业务规则、用户场景和验收目标。

输出文件：

• docs/prd/<domain>/<feature>.md
• 可能更新：docs/prd/00-index.md
• 可能更新：docs/user-stories/**/*.md

使用方式

/t-prd-publish [feature]

核心约束

• 固定在实现、测试和 Demo 验收完成之后运行，服务于实现后的正式文档发布。
• 核心动作是先做发布总结，再修正增补现有正式 PRD；正式 PRD 不存在时才创建。
• 发布总结用于确认写入范围；长期 PRD 只沉淀稳定产品事实。
• 以差异归纳和事实合并为主；只把仍然成立、且属于长期产品语义的内容写入 docs/prd。
• 写入前先摘要：草稿、正式 PRD、实现后证据之间的差异，现有正式 PRD 需要修正的问题，索引影响和风险项；用户确认后才写入。
• 发布后删除对应 .ai/prd/<domain>/<feature>.md 和 .ai/user-stories/<domain>/<feature>.md（如存在）。
• 正式 PRD 内容聚焦产品语义，端点明细、schema、建表、代码类型和实现进度状态留在设计、任务或实现证据中。
• 缺少实现、测试或 Demo 验收证据时停止。
• 发布范围限定为正式 PRD、正式用户故事、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/task/<feature>/.state.json — 可选实现阶段背景材料（如存在）
• .ai/quality/**/*.md — 相关 check / accept 报告（如存在）
• ${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] 非空且符合文件名规则
• 文件名仅允许英文、数字、空格、下划线、连字符
• 拒绝 .., /, \
• 长度限制 1 到 50 字符

2. 定位草稿和目标

• 在 .ai/prd/**/*.md 中按文件名精确匹配 [feature]
• 如多个 domain 匹配，停止并让用户选择一个明确路径
• 目标路径固定为 docs/prd/<domain>/<feature>.md

3. 发布前检查

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

• 草稿核心章节是否完整
• 草稿引用的用户故事是否存在
• draft 用户故事是否符合 INVEST、GWT 和内容边界规则
• 草稿内容是否符合 PRD 内容边界
• 草稿、draft 用户故事、正式 PRD / 用户故事和实现后证据的一致性与已说明差异
• 现有正式 PRD / 用户故事是否存在缺失、过期或与已交付产品语义不一致的问题
• 草稿中哪些内容应写入、删去、降级或仅作为发布摘要说明
• draft 用户故事中哪些故事应追加、合并、改写、删去或仅作为发布摘要说明
• docs/prd/00-index.md 是否需要新增或更新条目
• 是否已有实现、测试和 Demo 验收完成证据

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

4. 生成发布摘要并确认

写入前先向用户展示：

• 草稿路径和目标正式 PRD 路径
• 修正增补类型：revise / append / create-if-missing
• 与现有正式 PRD 的关键差异
• 与现有正式用户故事的关键差异
• 草稿内容与实现后证据的对齐结论
• 现有正式 PRD / 用户故事需要修正的问题清单
• 将写入正式 PRD 的长期产品事实
• 将写入正式用户故事的角色、场景和验收标准
• 正式 PRD 内容边界：实施过程、临时状态和技术细节归属设计、任务或实现证据
• 用户故事引用变化
• 实现与验收完成证据摘要
• 索引更新计划
• 阻塞风险或"无"

使用 AskUserQuestion 请求确认。获得确认后进入正式文档写入；未获得确认则结束本轮发布。

5. 写入正式 PRD

用户确认后：

• 基于草稿、正式 PRD 和实现后证据，修正/增补 docs/prd/<domain>/<feature>.md
• 基于 draft 用户故事、正式用户故事和实现后证据，修正/增补 docs/user-stories/**/*.md
• 保留正式 PRD 中仍然有效的既有内容，只修正缺失、过期、冲突或需要增补的部分
• 保留正式用户故事中仍然有效的既有故事；新增或合并 draft story 时保持角色引用、INVEST 和 GWT 验收标准
• 写入内容采用当前产品能力、业务规则或验收目标表述，避免用“已完成/已实现/本次交付”等实施进度表述承载长期事实
• 目标正式 PRD 不存在时，才创建 docs/prd/<domain>/<feature>.md
• 如索引存在，更新 docs/prd/00-index.md 的对应条目；索引维护遵循目标项目现有索引文件
• 删除 .ai/prd/<domain>/<feature>.md
• 删除 .ai/user-stories/<domain>/<feature>.md（如存在）
• 若 .ai/prd/<domain>/ 删除草稿后为空，可删除该空目录
• 若 .ai/user-stories/<domain>/ 删除草稿后为空，可删除该空目录

6. 发布后验证

• 重新检查正式 PRD 是否可读且路径正确
• 确认对应 .ai/prd/<domain>/<feature>.md 已不存在
• 确认对应 .ai/user-stories/<domain>/<feature>.md 已不存在或本轮不存在 draft 用户故事
• 运行或建议运行 /t-html-show docs/prd/<domain>/<feature>.md 生成正式 PRD Preview
• 建议运行 /t-prd-check [feature] 对正式 PRD 做发布后校验

收尾输出

完成后明确说明：

• 修正增补类型
• 正式 PRD 路径
• 正式用户故事更新路径（如有）
• 已删除的草稿路径
• 是否更新索引
• 发布后建议命令：/t-prd-check [feature] 做正式 PRD 校验；通过后可进入 /t-release [version]

失败处理

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