---
name: project-docs-product
description: 用户要梳理业务需求、创建或修订 PRD、评审产品需求，或同时交付可点击 HTML 原型时使用；支持口述、纪要、业务资料和已有系统增量改造。项目现状说明走 project-docs-overview。
---

# Project Docs Product

帮助产品与业务人员把问题变成可评审、可交接的需求。按 [产品工作流](references/workflow.md) 组合 Superpowers `brainstorming`、Matt Pocock `grilling` 和 `domain-modeling`；先确定当前阶段，只加载该阶段需要的能力，不能同时运行两个访谈主持流程。

先解析本 Skill 的真实目录，脚本位于 `../../scripts/`。检查宿主实际可见的上游依赖，按 [依赖与适配](references/dependencies.md) 处理；缺失时明确标为未就绪，不自行安装或声称已执行上游。资料充分时可直接整理已有需求，用户要求完整探索时必须具备相应依赖。

## 交付选择

先读[资料条件与产品质量](references/input-and-quality.md)，按源码、截图/设计、文档/口述或新产品资料开始；无源码仍交付完整业务规格，分别说明证据与交付用途。读取已有文档时先按工作流核对读取完整性：正文、表格、评论标注及回复共同构成来源，未读到的部分明确留缺口。不能把正文读取成功当作来源完整，也不能为通过校验改编号或移除可点击来源链接。

- 普通需求：默认用[面向读者的 PRD 模板](assets/prd-reader-template.md)交付 `prd.md`。先讲业务变化，再展示页面交互与业务流程、字段规则、异常和中文验收场景；按[阅读与变更约定](references/reading-and-change.md)自适应展开。不要让 FR、AC 或追踪元数据主导正文；MD 与 HTML 使用同一份精简业务主文；详细验收、既有编号和源码证据按阅读约定拆出并链接，不靠折叠附录隐藏冗长。涉及计算或数据变化时按需补可复算数据示例表，不为无计算需求凑表。
- 用户要求根据 PRD 出原型：读取 [原型交付规范](references/prototype.md)，默认覆盖本期范围内的完整用户任务；先写流程覆盖表，再交付共享模拟数据的可编辑 HTML、旅程验收和截图。用户只验证某个交互时，明确标为局部交互验证并列出未覆盖范围。静态说明页仍使用 Overview 的 explainer。
- 已有系统改造：先读[增量设计与业务闭环](references/brownfield-delivery.md)，按 Overview 取证核实现有页面、组件和端到端对象链；在原页面上标新增变化，以变更清单组织正文；仅沿本次数据及职责边界核对准备、固定、保存和使用，不把外围系统风险自动变成需求。源码是现状依据，不替业务作决策；无页面基线仍画目标任务，明确未核实的原页面边界。
- 业务图：使用 [Diagram](../project-docs-diagram/SKILL.md) 的非源码原生通道，以 PRD 和业务资料为依据。
- 可选 PDLC 协作：读取 [交接约定](references/pdlc.md)；缺失不阻塞独立交付，安装不等于支持接管，普通 PRD 不自动进入研发。

未指定目录时，在被分析仓库外创建本次需求交付目录。统一使用业务语言；术语表只放定义，规则、决策和未决问题放 PRD，重要 ADR 按上游条件按需创建。不要把示例或原型模拟值当作真实业务事实。

## 检查与交付

按[阅读与变更约定](references/reading-and-change.md)选择轻量单文件或主文/追踪拆分，以及必要页面图和业务图；先验收范围与读者能否看懂变化，再核完整性。正文不能靠附件拼出规则，也不能为模板扩写。

修订前与交付前执行[需求保留与恢复走读](references/workflow.md#需求保留与恢复走读)，逐项核对原始诉求及有效关联约定，并从异常反馈走到可执行下一步；记录实际缺口，不以“已检查”代替。

重新读取成品，运行 `python3 <本集合>/scripts/validate_product_doc.py --file <交付目录>/prd.md`；外置追踪时显式追加 `--tracking <交付目录>/prd-traceability.md`（须同目录、版本一致且主文有链接）；有原型时追加 `--prototype <交付目录>/prototype.html`。根据 [评测场景](references/evaluation.md) 核对来源、已决事项、正常/边界/异常验收，以及修改前后的关联内容。校验只证明结构、标识与资源关联，业务含义和浏览器交互另行验证。

按[交付回复与验收汇总](references/reading-and-change.md#正文与交付回复)先说明变化、待决定事项与下一步，提供实际成品及证据；定稿或大改按需要给要点覆盖。产品确认和授权边界统一按[工作流](references/workflow.md#验证与交付)，不同检查结果不能互相代替。