技能介绍

要解决的问题

需求很少只存在于一个文件里：功能清单躺在 Excel 表格中，产品说明写成 Word，结构草图画在 XMind 中，真实意图则留在聊天记录里。人工整理时需要反复复制粘贴，同一个需求在两份文档中表述不一致也难以察觉，最后写出的 PRD 要么漏掉字段，要么带着未解决的矛盾进入开发。

这个技能填补的是「零散输入」到「结构化 PRD」之间的空白。它把多来源文档解析为统一的中间格式，做语义去重和冲突标注，再按模板生成 PRD.md。

核心能力与工作流程

多格式解析。 支持自然语言描述、Markdown、Word（.docx）、Excel（.xlsx/.xls）和思维导图（.xmind/.mm/.mmap）。解析有优先级：直接对话描述 > Markdown > Word > Excel > 思维导图。扫描工作区时会排除 node_modules、.git、build 等目录。

对话式澄清。 当输入只是功能清单甚至一句模糊想法时，技能会反推业务场景、补全隐含功能，并通过渐进式追问明确边界条件。每次最多问 5 个问题，按 🔴 必须回答 / 🟡 建议回答 / 🟢 可选标注优先级，确认后复述自己的理解。

语义整合而非文本匹配。 去重基于语义相似度判断，「用户登录」和「用户登录系统」会被合并为一条；字段定义或必填属性不一致时不自动裁决，而是把所有版本列进 PRD 并标注「⚠️ 待确认」。整合后按 INVEST 六维（独立性、可协商、价值、可估算、粒度、可测试）为每条功能打星评级，结果写入附录。

三种工作模式。 标准模式走完整的 8 阶段流程并逐项澄清；快速模式跳过大部分交互，对模糊项填默认值并在 PRD 中标注「默认值待确认」；增量模式在根目录已存在 PRD.md 时自动启用，对比新旧版本输出差异。生成后可选推送到飞书（CLI / Open API / Webhook 三种接入方式）、Git、FTP/SFTP、本地路径、Obsidian 仓库或剪贴板。

适用边界与注意点

技能只做需求结构化，不做技术方案设计。冲突和「待确认」项必须由人最终裁决，🔴 级别的逻辑矛盾解决前不会生成 PRD。增量模式依赖现有 PRD.md 的格式一致性，手动改过格式可能导致对比偏差；新旧差异超过 70% 时会建议按全新版本处理。解析 Word 需要 python-docx，Excel 需要 openpyxl 或 in2csv，缺失依赖时对应文件会被跳过。文档建议 UTF-8 编码，超过 5MB 的文件会先询问再处理。