帮助创业者和产品经理在投入时间之前系统评估商业方向是否值得做。该工具通过6个核心问题（动机/用户/竞品/优势/投入/最小可行版本）引导用户完成自我诊断，结合爬虫采集的真实市场数据生成结构化BRD文档，所有结论必须挂数据索引。适用于已有初步产品想法但不确定方向可行性的早期决策阶段，产出包含商业机会/目标市场/可行性评估/决策建议等完整章节。
BRD商业需求文档生成器：数据驱动的产品方向评估工具
【适用场景】
适用对象
- 创业者：有一个产品想法，想在投入开发前验证方向可行性 - 产品经理：需要向上级或投资人呈现商业决策依据 - 内部创新团队：评估新业务方向是否值得资源投入 - 投资人：快速评估早期项目的商业逻辑典型使用情境
- 「我想做XX，你觉得行吗？」——帮用户判断方向是否值得做 - 「帮我写个BRD」——生成结构化商业需求文档 - 「这个方向靠谱吗？」——给出明确判断并说明理由 - 「可行性分析」——评估市场规模、竞品格局、自身优势核心产出
- `BRD.md` 商业需求文档，包含： - 商业机会描述 - 目标市场初判（含用户原声数据索引） - 可行性评估（竞品分析/切入机会/资源约束） - 决策建议（✅值得做 / ⚠️有条件做 / ❌建议暂缓） - 关键假设与已知风险【操作步骤】
第一步：判断用户类型与准备状态
探索型用户（想法模糊，说不清为什么想做） - 工具用最简单的选择题引导 - 主动补充他可能没考虑到的角度
实践型用户（有初步想法但缺验证） - 重点帮他们发现盲区 - 引导从直觉走向数据判断
成熟型用户（方向清晰，有数据支撑） - 直接挑战假设、查漏补缺 - 重点在压力测试而非基础引导
第二步：确认数据源（硬性要求）
BRD的所有结论必须有数据支撑，不允许凭感觉编造。数据来源优先级：
1. 用户已有数据：粘贴的原声、上传的文件、`./market_data/` 下的报告 2. 爬虫自动采集：调用 `fetch_market_data.py` 脚本抓取真实用户讨论 3. 用户手动跳过：允许但必须在文档头部标注「⚠️无数据支撑，结论仅供参考」
爬虫采集命令： ```bash python3 ~/.codex/skills/brd-writing/scripts/fetch_market_data.py "关键词1" "关键词2" "关键词3" --max 10 ```
第三步：完成核心问题诊断
工具会依次询问6个关键问题（根据用户类型自适应跳过部分问题）：
| 问题 | 核心价值 | 典型选项 |
|---|---|---|
| Q1.你为什么想做这个？ | 理解动机，判断投入意愿 | 我自己遇到这个问题/看到市场机会/直觉觉得可以 |
| Q2.谁会为这个买单？ | 明确目标用户 | 有具体画像/模糊但有人群概念/还没想清 |
| Q3.现在他们怎么解决？ | 理解替代方案 | 用某竞品/土办法拼凑/基本没有好方案 |
| Q4.你有什么独特优势？ | 评估竞争壁垒 | 我就是用户/有技术资源/发现切入角度/没有特别优势 |
| Q5.你打算投入多少？ | 设定合理预期 | 周末验证/1-2周MVP/1个月以上认真做 |
| Q6.最小可卖版本是什么？ | 判断方向聚焦程度 | 单功能MVP/现有工具插件/手动服务验证 |
第四步：生成BRD文档
基于问答结果和数据支撑，生成完整的BRD文档，包含以下章节：
```markdown
[项目名称] — 商业需求文档 (BRD)
1. 商业机会
- 我们在做什么（一句话） - 为什么现在做（背景+数据索引） - 市场规模感知（定性描述+数据索引）2. 目标市场初判
- 目标用户（角色/场景/痛点程度+索引） - 用户声音（原声引用表格+索引）3. 可行性评估
- 现有替代方案对比表 - 我们的切入点（差异化+索引） - 资源与约束4. 决策建议
- 综合判断（✅/⚠️/❌+理由） - 下一步建议（最重要的一步） - 关键假设（假设错了结论翻转） - 已知风险5. 数据索引附录
- 所有引用的原文条目和链接 ```第五步：自动自审
文档生成后自动检查： - 每个结论是否挂了数据索引 - 逻辑链是否连贯（动机→痛点→切入点→决策建议） - 是否有红旗信号（伪需求/感兴趣≠会用/市场增长率≠你能赢）
【代码模板】
BRD触发词
- 「写BRD」「商业需求文档」「可行性分析」 - 「帮我判断要不要做」「评估一下这个方向」 - 「这个方向靠谱吗」「该不该做这个」索引引用格式
所有结论必须挂索引： - ✅ `核心痛点是信息过载 [X3, R1, W5]` - ✅ `用户对现有方案不满 [Z2, H7]` - ❌ `我觉得用户会很需要这个`（无索引，禁止）无数据警告标签
如果用户跳过数据采集，文档头部必须保留： ```markdown > ⚠️ 重要警告：本报告在没有真实数据支撑的情况下生成，所有结论仅来自对话推断。请在做重要决策前补充数据验证。 ```【复盘要点】
常见失败模式
模式1：没有数据就写BRD - 后果：结论都是编的，做决策时会误导自己 - 解决：必须先采集或粘贴真实用户数据
模式2：方向太大无法聚焦 - 红旗信号：用户说不出「最小可卖版本」 - 解决：追问到能说清楚最小MVP为止
模式3：目标用户太抽象 - 红旗信号：用户全程说不出一个具体的人名或场景 - 解决：要求描述一个具体的用户故事
自检清单
- [ ] 所有结论挂了数据索引 - [ ] 没有编造市场规模/用户比例/增长率数字 - [ ] 决策建议给出了明确判断（不是「看情况」） - [ ] 逻辑链连贯（动机→痛点→差异化→结论） - [ ] 覆盖了主要已知风险
来源：wbx125133/codex-skills · GitHub https://github.com/wbx125133/codex-skills/blob/main/brd-writing/SKILL.md