问卷式PRD撰写

问卷式PRD撰写 是一款专为 Codex 设计的插件（Plugin），旨在将零散的需求说明、会议纪要、原型反馈和既有文档，转化为一份结构严谨、可追溯、可验收的标准化产品需求文档（PRD）。其核心创新在于引入了交互式问卷机制，在信息缺失时主动澄清关键决策，而非盲目生成假设，从而确保产出的 PRD 既符合业务逻辑又具备工程落地性。

核心价值：从“模糊输入”到“精准交付”

• 智能缺口填补：
  • 当材料中存在 4-20 个影响范围、角色、流程或验收标准的关键缺口时，插件会自动生成交互式问卷。
  • 问卷直接在 Codex 对话中展示，支持单选、多选及文本输入，集中确认后再继续撰写，避免反复追问打断心流。
• 单一事实来源 (Single Source of Truth)：
  • 只维护一份主稿：新建时使用规范命名，更新时直接回写原文件，杜绝“最终版_v2_真的最终版.doc”的混乱。
  • 动态更新：支持根据新会议结论或原型反馈，收敛多来源分歧，同步修改详细需求、共用规则及验收场景。
• 全链路可追溯：
  • 建立 REQ-### (需求) → 来源 → 当前规格 → AC-### (验收场景) 的对应关系。
  • 研发和测试可直接通过编号定位需求背景与验收标准，减少沟通成本。
• 严格控制事实边界：
  • 对于字段必填项、默认值、权限、批量失败策略等关键规则，若无明确来源，绝不补造，而是标记为“待确认”，确保文档的严谨性。

功能亮点

1. 交互式问卷澄清

• 集中确认：将分散的关键问题打包成问卷，一次性解决不确定性。
• 原生体验：问卷嵌入 Codex 对话流，支持翻页、自动定位，长内容自然换行。
• 智能触发：仅在涉及核心业务逻辑（如范围、权限、数据口径）缺失时触发，不因低风险细节打扰用户。

2. 标准化 PRD 架构

默认生成的 Markdown PRD 遵循以下专业结构：

• 00 文档元信息：版本、作者、变更记录。
• 01 PRD 概览：背景、目标、范围。
• 02 业务流程与功能结构：流程图、功能模块图。
• 03 详细需求 (REQ-###)：按业务过程组织，包含页面、字段、状态、权限、异常处理。
• 04 共用规则与数据：全局通用的数据字典、校验规则。
• 05 验收与交付 (AC-###)：具体的验收场景、依赖项、发布计划及风险提示。

3. 多场景支持

• 新建 PRD：从零散材料生成完整初稿。
• 更新 PRD：识别现有主稿，增量更新并保留历史追溯。
• 纯分析模式：仅输出范围、冲突和风险分析报告，不生成文档文件。
• Word 导出：支持将 Markdown 主稿一键导出为同内容的 .docx 文件。

安装与使用

前置要求

• 已安装并配置好 Codex。
• 已安装 Git 和 Node.js 20+（用于本地 MCP Server）。

安装步骤

git clone https://github.com/lin96008-maxlin/prd-outputs-interactive.git
cd prd-outputs-interactive
codex plugin marketplace add .
codex plugin add prd-outputs-interactive@bettle-juice

安装成功后，请新建一个 Codex 任务以加载新的 Skill 和 MCP 工具。

常用指令

1. 新建 PRD：

   $prd-outputs-interactive，读取 C:\path\to\需求材料.md，生成一份可供评审的 PRD。
   

2. 更新已有 PRD：

   $prd-outputs-interactive，根据本轮会议纪要更新 C:\path\to\现有PRD.md。
   

3. 仅做需求分析：

   $prd-outputs-interactive，只分析这些材料的范围、关键决策和冲突，暂不创建文件。
   

数据安全与隐私

• 本地运行：MCP Server 通过 stdio 与 Codex 通信，不开放公网端口。
• 内存处理：问卷内容与答案仅存在于当前对话上下文中，不写入磁盘。
• 敏感信息警示：严禁在问卷或 PRD 中填写密码、密钥、Token 等敏感凭据。

适用人群

• 产品经理 (PM)：需要从杂乱的需求中快速产出结构化文档，并确保需求无歧义。
• 技术负责人 (Tech Lead)：希望获得带有明确验收标准和数据规则的 PRD，便于评估工作量。
• 测试工程师 (QA)：需要清晰的需求-验收映射关系，以便编写测试用例。