商业化产品需求文档审查与设计要点梳理
任务目标
- 本 Skill 用于：自动化审查商业化产品需求文档（PRD），快速校验需求逻辑准确性、闭环性，提取需设计的核心内容并划分优先级
- 能力包含：文档解析、逻辑审查、设计要点提取、优先级划分、标准化输出
- 触发条件：用户提供 PRD 文档并请求审查、梳理设计要点、划分优先级
前置准备
依赖说明
scripts 脚本所需的依赖包及版本：
python-docx==1.1.0
PyPDF2==3.0.1
文档来源支持
| 来源类型 | 支持格式 | 处理方式 |
|---|---|---|
| 本地上传 | .docx, .pdf, .txt, .md | 调用 scripts/doc_parser.py 解析 |
| 粘贴内容 | 纯文本 | 直接读取分析 |
文档内容要求
PRD 文档需包含以下核心内容：
- 需求背景
- 需求目标
- 核心功能描述
- 业务逻辑
- 用户场景
操作步骤
步骤一：需求文档解析与信息提取
根据用户提供的文档形式，选择对应的处理方式：
情况一：用户上传本地文档
判断文档格式：
- Word 文档（.docx）→ 调用 scripts/doc_parser.py
- PDF 文档（.pdf）→ 调用 scripts/doc_parser.py
- 纯文本（.txt/.md）→ 直接读取
python scripts/doc_parser.py <文档路径>
情况二：用户粘贴文档内容
直接使用粘贴内容进行分析。
情况三：用户提供在线文档链接
引导用户：
- 复制文档内容并粘贴
- 或下载文档后上传本地文件
提取信息维度（详见 references/review_checklist.md）：
- 基础信息：需求名称、提出人、背景、核心目标
- 业务逻辑：核心功能描述、用户操作流程、业务链路
- 约束条件：技术限制、时间节点、资源限制、合规要求
- 预期效果：量化指标、定性要求
步骤二：需求逻辑审查
基于提取的信息，执行双重逻辑校验。详细审查标准见 references/review_checklist.md。
2.1 逻辑准确性审查
- 校验需求目标与需求背景的匹配性
- 校验业务逻辑的合理性（排查矛盾点）
- 校验量化指标的可行性
- 校验商业化逻辑合规性
2.2 逻辑闭环审查
- 需求输入-处理-输出闭环检查
- 异常场景闭环检查（付费失败、操作失误、权限不足等）
- 商业化链路闭环检查（引流-转化-留存-复购）
审查结果输出：
- 通过：逻辑清晰，无明显问题
- 需优化：存在小问题，不影响整体推进
- 存在漏洞：存在重大逻辑缺陷，需修正后再进行设计
步骤三：设计要点提取
基于审查通过的需求逻辑，按设计师工作流维度提取设计要点：
界面设计要点：
- 页面布局：核心页面、关键模块、信息架构
- 组件设计：表单、卡片、列表、弹窗
交互设计要点：
- 操作流程：步骤拆解、跳转逻辑、返回路径
- 触发反馈：点击响应、加载状态、成功/失败提示
视觉设计要点：
- 视觉层级：重点突出、信息分层
- 商业化元素：付费入口、价格展示、优惠标识
状态设计要点：
- 正常状态：默认展示、数据完整
- 异常状态：空状态、错误状态、边界情况
- 角色状态：不同用户角色、权限差异
每个设计要点需对应需求中的具体描述，明确设计范围。
步骤四：设计优先级划分
结合商业化优先级、需求紧急程度、设计难度，采用「高-中-低」三级划分：
| 优先级 | 判定条件 | 预估工时参考 |
|---|---|---|
| 高 | 影响商业化核心目标、阻塞开发流程、涉及合规性 | 1-3天 |
| 中 | 辅助核心功能、影响部分用户体验 | 0.5-1天 |
| 低 | 优化类、补充类、可后续迭代 | 0.5天内 |
每个设计要点标注：划分依据、前置依赖、建议启动时间。
步骤五：输出设计师友好的梳理文档
将审查结果、设计要点、优先级划分整理成标准化文档，便于设计师直接参考。输出格式见 references/review_checklist.md 中的「输出文档模板」。
文档结构：
- 需求概览（一句话总结 + 核心目标）
- 逻辑问题清单（问题位置 + 影响范围 + 严重程度 + 修复建议）
- 设计要点清单（按界面/交互/视觉/状态分类）
- 优先级排期表（优先级 + 设计要点 + 预估工时 + 前置依赖）
- 补充建议与风险提示
输出形式选择：
- 简洁版：适合快速对接，聚焦高优先级设计要点
- 详细版：适合存档和团队同步，完整呈现所有内容
资源索引
- 本地文档解析：见 scripts/doc_parser.py（用途：解析 Word/PDF/TXT 文档）
- 审查标准与模板：见 references/review_checklist.md（何时读取：执行审查、提取要点、生成输出时）
注意事项
异常处理
- 文档解析失败：提示用户检查文档格式或直接粘贴内容
- 需求逻辑漏洞较多：建议用户先优化需求逻辑，列出核心漏洞
- 设计要点不明确：提示用户补充相关细节
商业化重点关注
- 付费流程合规性（付费提示清晰、无虚假宣传）
- 数据收集合规性（用户隐私保护）
- 商业化链路完整性（引流-转化-留存-复购无断裂）
- 异常场景覆盖（付费失败、余额不足、权限不足等）
设计师视角要点
- 输出文档结构清晰，便于快速定位
- 逻辑问题明确标注位置和修复建议
- 设计要点按工作流组织，便于任务拆解
- 优先级包含工时预估，便于排期规划
使用示例
示例一：本地文档审查
用户请求：帮我审查这份 Word 文档的需求逻辑
执行方式：
1. 调用 scripts/doc_parser.py 解析文档
2. 执行逻辑准确性 + 闭环性审查
3. 输出逻辑审查报告
输出：逻辑问题清单（含位置、影响范围、修复建议）
示例二：粘贴内容审查
用户请求：审查这份 PRD，梳理设计要点
用户操作：直接粘贴 PRD 内容
执行方式：
1. 直接读取粘贴内容
2. 执行逻辑审查
3. 提取设计要点并划分优先级
4. 输出设计师友好的梳理文档
输出：逻辑问题清单 + 设计要点清单 + 优先级排期表
示例三：仅提取设计要点
用户请求：梳理这份 PRD 的设计要点和优先级
执行方式：
1. 读取文档内容
2. 提取设计要点（界面/交互/视觉/状态）
3. 划分高-中-低优先级
4. 输出设计要点清单 + 优先级排期表
输出：分类设计要点清单 + 优先级排期表（含工时预估）
