问卷式PRD撰写

目标

将当前有效材料整理为清晰、可实现、可验证、可持续更新的唯一主 PRD。文档围绕事实、决策、能力关系和需求单元组织；默认以 Markdown 为维护主稿，只输出当前交付成立所需的内容。

本技能支持：

• 只做需求分析、范围澄清或能力地图梳理；
• 新建一份主 PRD；
• 在原文件中更新已有 PRD；
• 收敛多来源分歧并保留必要证据；
• 材料存在多个关键缺口时按需使用交互式问卷，答案返回后继续原流程；
• 涉及既有产品或源码改造时核对已有、改造和新增能力；
• 用户明确要求时，从 Markdown 主稿导出同内容 DOCX。

职责边界

• 需求事实只来自用户指令、当前有效材料和可核验系统证据。
• 字段是否必填、默认值、可编辑角色、批量处理方式、状态前提和指标计算公式只有材料明确给出时才能写成确定规则。
• 材料提到的每个业务操作都必须在规格、验收或待确认项中找到落点；信息不足时标为待确认，不能静默省略。
• 多条已确认规则可以直接组合时，应形成一个明确结论；只有规则冲突或关键条件缺失时才进入待确认项。
• 待确认事项区分业务决策、验收口径和交付依赖，分别说明影响范围，不把局部缺口写成整份 PRD 无法执行。
• 行业、界面和技术约束只在本次材料明确提供时进入当前 PRD。
• 用户只要求分析时直接答复，不创建目录或文件。
• 用户要求 PRD 时默认只维护一份主 PRD；辅助文档只在长期接力或材料治理确有需要时创建。
• 不主动扩展为 UI 设计、原型制作、前端实现、项目管理或跨项目知识沉淀。

模式判断

不能可靠识别当前主 PRD，或新增辅助文档会改变交付范围时，先确认一个关键决策点。可从材料判断且影响较低的事项不追问。

来源与事实

按事实类型确定权威来源：

1. 用户本轮明确指令决定当前变更和例外。
2. 当前主 PRD 承载稳定需求事实。
3. 真实系统、接口或源码决定已有能力、字段、状态和接口事实。
4. 已确认原型补充呈现和交互细节。
5. 会议纪要、聊天、截图和历史材料按有效性与确认状态使用。

来源冲突时写清冲突事实、采用口径、依据和影响。文件更新时间不能单独决定业务口径。

没有依据但会影响范围、权限、流程、数据、验收或上线责任的内容标为“待确认”，并注明是否阻断；低风险展示细节可使用明确标注的示例或假设。

澄清原则

仅在答案会显著改变需求范围、核心流程、角色责任、权限、数据口径、外部集成或验收方式时暂停询问。先读取材料并删除已有答案的问题，不把检查清单整体变成问卷。

• 1–3 个关键问题使用平台原生提问能力；
• 4–20 个相互关联的关键问题读取 interactive-clarification.md 并调用 open_prd_clarification_questionnaire；
• MCP Apps 不可用时使用工具返回的文本问题分批询问，不能中断 PRD 能力；
• 单轮候选超过 20 个时只保留返工风险最高的 20 个，不为凑数量增加问题。

至少形成以下判断：

• 哪些人或系统受到影响；
• 已知事实和问题证据是什么；
• 交付后应出现什么可观察结果；
• 本期边界和责任如何划定；
• 使用什么场景验证实现正确。

用户要求先出草稿或不追问时，说明关键风险并继续，缺口保留为“待确认”。

执行流程

1. 确定交付：判断只做分析、新建、更新或治理，并确定输出位置。
2. 整理事实与决策：区分有效证据、已确认决策、待确认决策、假设和来源分歧。
3. 按需澄清：只收集会改变范围、规则、责任或验收的答案；答案返回后立即并入当前决策。
4. 绘制能力地图：说明本期能力、业务对象、参与者和上下游关系，不从页面名称推导能力。
5. 编写需求单元：为关键需求分配 REQ-###，按实际需要写触发、规则、结果、承载方式、权限、数据、状态、异常和恢复。
6. 连接验证：每个关键需求至少关联一个可执行的验收场景；跨需求规则只写一次。
7. 合并主稿：把稳定结论回写唯一主 PRD，移除空章节、重复解释和失效口径。

详细流程见 references/workflow.md。

主 PRD 输出结构

内部使用能力地图和需求单元组织信息，最终文档默认按业务推进顺序组织，并使用产品经理、研发和测试容易理解的章节名：

• 文档元信息；
• PRD 概览：背景、目标、范围、参与角色、关键决策和来源；
• 业务流程与功能结构；
• 详细需求：按用户任务或业务推进顺序组织，是正文主体；
• 共用规则与数据：只记录多个需求共同使用的规则；
• 验收与交付：验收场景、依赖、发布、待确认项和风险。

大型产品可以在“详细需求”中按业务模块继续分章，但页面、字段、状态、SLA、通知和异常优先写入对应业务需求，不默认拆成一组平行的顶层章节。标题必须直白描述内容，不把内部方法名、缩写或新造术语写成最终章节名。

按需补充权限、字段、状态、数据口径、成功指标、依赖、发布迁移、既有系统核对、变更影响和需求追溯。模板是裁剪清单，不是固定目录；未触发的章节和字段不输出。

当前有效口径写法

• 标题、文件名和章节名只描述当前需求或当前交付物；历史变化在确有追溯价值时进入变更说明。
• 被否定或删除的方案不留在当前功能规格中；只有它影响兼容、迁移、验收或决策追溯时，才在变更对照中简要记录。
• 主 PRD 只记录当前需求、必要变更影响和验收依据；维护过程与模板研究不进入交付物。
• 非目标和非范围只写与本期边界直接相关的内容，不罗列所有可能但未采用的功能。
• 示例只提供写法和结构；使用时重新建立当前项目的事实、来源、需求和验收。

规格与验收

每个需求单元按实际影响说明：

• 目标结果、参与者、触发条件和前置条件；
• 输入、处理规则、输出和可观察结果；
• 页面承载或流程行为；
• 权限、数据范围、状态变化和副作用；
• 失败、受限、超时、重试或恢复路径；
• 证据、决策状态和验收场景。

验收写结果，不写“体验友好”“性能良好”等愿望。高风险需求覆盖相关失败、越权、部分成功、重试、幂等或回退边界。

字段、状态、权限、操作和异常的按需枚举见 references/prd-analysis-enumerations.md。

既有产品或源码改造

仅在用户任务明确涉及已有产品、真实系统、开源项目或源码二次开发时启用。只读取与当前需求直接相关的页面、接口、字段、状态、权限、操作和命名，并逐项形成：

• 保持：现有能力和当前需求一致；
• 调整：保留现有主体，但需要改变规则、入口、组合或边界；
• 新增：现有能力无法承载当前需求；
• 停用：当前能力需要退出，并明确兼容或迁移影响；
• 待确认：证据不足，暂不下结论。

核对过程和证据可以进入质量记录，稳定结论必须回写主 PRD。

文件与更新

• 用户指定输出目录或文件名时优先遵循。
• 新建 PRD 时按 references/naming-and-files.md 建立目录和主稿。
• 用户未指定文件名时，新建 PRD 使用 YYYYMMDD需求主题PRD-v1.md；日期与主题之间不加分隔符。
• 更新已有 PRD 时沿用原路径和文件名；变更必须同步修改正文。
• 同一需求不创建“最终版”“最新版”等平行主稿。
• 辅助文档只记录基线、检查结果或跨阶段交接，不维护第二套需求事实。

Markdown 与 Word

• Markdown 是唯一可维护主稿。
• 用户未要求 Word 时不额外生成 DOCX。
• 用户明确要求 Word 时，先完成并自检 Markdown，再运行：

python scripts/export-prd-docx.py "主PRD.md" "主PRD.docx"

• 后续变更先更新 Markdown，再覆盖导出同名 DOCX。
• 导出后重新打开 DOCX，核对标题、表格、关键标识、中文和文件完整性。

参考资料

按需读取，不一次性加载全部：

• 详细执行和自检：references/workflow.md
• 交互式需求澄清：仅在存在 4–20 个关键缺口时读取 references/interactive-clarification.md
• 主 PRD 与辅助文档模板：references/templates.md
• 字段、状态、权限、操作与验收枚举：references/prd-analysis-enumerations.md
• 原型反馈和长期迭代回写：references/prototype-prd-governance.md
• 目录与文件命名：references/naming-and-files.md
• 公开方法依据：仅在用户询问方法来源时读取 references/reference-basis.md
• 完整写法示例：仅在用户要求示例或模板仍有歧义时读取 references/example-ecommerce-order-management-prd.md
• 多来源更新示例：仅在多份有效材料存在分歧时读取 references/example-multi-source-change-analysis.md

交付自检

• 当前主 PRD 唯一且术语一致；
• 关键事实有来源，推断与待确认项已区分；
• 目标、范围、能力关系、需求单元、权限或数据边界和验收闭合；
• 验收场景尽量一次验证一个触发和一个主要结果；字段边界、通知接收人和权限边界有对应覆盖；
• 变更已回写正文，标题和章节只描述当前有效口径；
• 没有空章节、空表格、模板说明或无关历史解释；
• 用户未要求的辅助文件没有被创建。

仅在维护本 Skill 后运行 scripts/validate-prd-skill.ps1 和 Skill 结构校验；普通 PRD 任务不运行维护脚本。