write-mrd

star 8.5k

输入一个产品 idea(一句话或详细描述均可),自动生成图文并茂、结构完整的 MRD(市场需求文档),以 Markdown 格式保存到当前项目 markdown/ 目录,同时输出配套 SVG 图表文件。触发条件:用户提到"写 MRD"、"帮我写市场需求文档"、"生成 MRD"、"写产品市场需求"、"我有个产品想法"、"帮我把这个 idea 写成 MRD"、"市场需求文档模板"、"产品立项文档"、"帮我写需求文档"。即使用户只给出一句简短的产品描述如"我想做一个 XX 产品",也应立即使用本 skill 生成 MRD。本 skill 面向产品经理、创业者、产品负责人,输出可直接用于团队评审和立项决策的专业文档。

digoal By digoal schedule Updated 6/9/2026

name: write-mrd description: 输入一个产品 idea(一句话或详细描述均可),自动生成图文并茂、结构完整的 MRD(市场需求文档),以 Markdown 格式保存到当前项目 markdown/ 目录,同时输出配套 SVG 图表文件。触发条件:用户提到"写 MRD"、"帮我写市场需求文档"、"生成 MRD"、"写产品市场需求"、"我有个产品想法"、"帮我把这个 idea 写成 MRD"、"市场需求文档模板"、"产品立项文档"、"帮我写需求文档"。即使用户只给出一句简短的产品描述如"我想做一个 XX 产品",也应立即使用本 skill 生成 MRD。本 skill 面向产品经理、创业者、产品负责人,输出可直接用于团队评审和立项决策的专业文档。

Write MRD Skill

将一个产品 idea 转化为结构严谨、图文并茂的 MRD(市场需求文档)。


工作流总览

用户输入 idea
      ↓
Step 1: 解析 idea,提炼核心问题与目标用户
      ↓
Step 2: 搜索行业背景 & 竞品信息(web search)
      ↓
Step 3: 构建 MRD 各章节内容
      ↓
Step 4: 生成 SVG 图表文件(至少 2 个)
      ↓
Step 5: 输出 Markdown 文件到 markdown/ 目录

Step 1:解析 Idea

拿到用户输入后,在开始写作之前先做内部推理:

  1. 核心问题识别:这个产品要解决什么问题?谁有这个问题?
  2. 目标用户推断:根据 idea 描述,猜测目标用户群体(如有多个层次,区分 Primary/Secondary)
  3. 市场方向判断:to B / to C / to B2B2C?消费品还是工具类?
  4. 阶段判断:是 0→1 的新产品,还是已有产品的新功能?

如果 idea 过于模糊(少于 10 个字且无任何上下文),可以向用户追问一个关键问题:"这个产品主要服务谁,解决他们在什么场景下的什么问题?";但如果能合理推断,应该直接开始写,在文档中标注推断假设。


Step 2:背景调研(使用 Web Search)

在写作之前,必须使用 web search 搜索以下信息:

  • 市场规模数据:搜索 [行业关键词] market size 2024 2025 或中文 [行业] 市场规模
  • 竞品信息:搜索主要竞品的产品定位、用户评价、融资情况
  • 行业趋势:搜索最新的行业报告、政策变化、技术趋势
  • 用户痛点:搜索相关论坛、App Store 评论、社交媒体上的用户抱怨

如无网络条件,基于已知知识推理,但需在文档中明确标注"数据待验证"。


Step 3:MRD 文档结构规范

3.1 文档头部(必填)

# [产品名称] MRD

> [一句话核心洞察:为谁解决什么问题,产生什么价值]

| 属性 | 内容 |
|------|------|
| 文档版本 | v1.0 |
| 创建日期 | [当前日期] |
| 产品阶段 | 0→1 新产品 / 功能迭代 / 战略探索 |
| 目标市场 | [简短描述] |
| 文档状态 | 草稿 / 评审中 / 已批准 |

3.2 执行摘要(Executive Summary)

格式要求:不超过 200 字,必须包含:

  • 核心问题(1句话):[目标用户] 在 [场景] 下面临 [痛点]
  • 我们的解法(1句话):通过 [核心能力] 帮助 [目标用户] 实现 [结果]
  • 市场机会(量化):目标市场规模 + 当前渗透率 + 增长趋势
  • 成功标准(3个指标):上线 X 个月内达成 [指标1/指标2/指标3]

3.3 背景与战略对齐

必须回答以下问题:

  • 为什么现在做?(时机判断:市场拐点、技术成熟度、竞争窗口)
  • 为什么我们做?(差异化优势:我们有什么独特的资源/能力/数据)
  • 不做的代价是什么?(机会成本分析)
  • 与公司/团队战略的对齐点(对于独立创业者可忽略此项)

3.4 用户与市场分析(核心章节)

3.4.1 目标用户画像(使用 JTBD 框架)

每个主要用户角色必须包含:

用户角色卡
─────────────────────────────────────────
角色名称:[给用户一个有画面感的昵称]
人口特征:年龄 / 职业 / 收入段 / 地域
使用场景:[具体的时间、地点、触发事件]

JTBD 三层任务:
  功能性任务:[他们实际要完成什么行动]
  情感性任务:[他们希望在过程中感受到什么]
  社会性任务:[他们希望在他人眼中呈现什么]

期望结果(验收标准来源):
  - [可量化的成功标准 1]
  - [可量化的成功标准 2]

现有替代方案的缺陷:
  - [当前他们怎么解决这个问题]
  - [这个方案哪里让他们失望]
─────────────────────────────────────────

3.4.2 市场规模

必须包含 TAM / SAM / SOM 三层拆解,每层给出数字来源或推导过程。

TAM(理论最大市场):所有可能有此需求的用户 × 人均年付费意愿
SAM(可服务市场):我们能实际触达并服务的子集
SOM(可获取市场):未来 12-18 个月实际能拿到的份额

呈现方式:使用 ASCII 或 Mermaid 图表可视化三层关系。

3.4.3 竞品分析

必须包含

  • 竞品对比矩阵(Markdown 表格)
  • 竞品定位地图(使用 SVG 或 ASCII 二维坐标图)
  • 每个竞品的"失败边界"(他们在哪个场景下让用户失望)
  • 我们的差异化定位(1句话:我们是"为[目标用户]服务的[类别],区别于竞品的是[差异化]")

竞品对比维度:根据产品类型选择 5-7 个最关键的维度,避免"大而全"的无意义对比。

3.5 核心需求(功能需求章节)

3.5.1 需求场景(User Stories)

格式:作为 [用户角色],我希望 [完成某个行动],以便 [实现某个结果]

每个 User Story 必须包含

  • 验收标准(AC):2-4 条具体可测试的标准
  • RICE 评分:Reach × Impact × Confidence / Effort
  • MoSCoW 分类:Must Have / Should Have / Could Have / Won't Have

3.5.2 非功能需求

必须覆盖以下维度(根据产品类型选择相关项):

性能需求:页面加载 < X 秒 / 接口响应 < X ms / 并发支持 X 用户
可用性:SLA X% 可用性 / 故障恢复时间 < X 分钟
安全与合规:数据加密标准 / 用户隐私合规(GDPR/个人信息保护法)
扩展性:支持 X 倍用户增长无需重构
国际化:支持语言 / 时区 / 货币
无障碍:WCAG 合规等级

3.5.3 优先级矩阵(使用 MoSCoW)

必须明确列出 "Won't Have (This Version)" 的内容——这是 MRD 最容易被忽视但最有价值的部分。

3.6 约束与里程碑

技术约束:
- 必须使用 / 禁止使用的技术栈(如有)
- 必须集成的第三方服务
- 数据迁移 / 兼容性要求

资源约束:
- 团队规模与角色
- 预算范围(可用区间或相对描述)
- 时间硬限制

里程碑规划:
│ 里程碑  │ 目标              │ 时间    │ 关键指标  │
│ MVP     │ 验证核心假设      │ +8周    │ [指标]   │
│ V1.0    │ 满足主流用户场景  │ +16周   │ [指标]   │
│ V1.5    │ 扩大用户规模      │ +24周   │ [指标]   │

3.7 核心假设清单(重要)

每个假设必须包含:假设内容、验证方式、风险等级(高/中/低)、验证截止时间。

至少包含以下类型的假设:

  • 用户行为假设(使用频率、付费意愿、渠道偏好)
  • 市场假设(竞争格局稳定性、市场增长速度)
  • 技术假设(实现可行性、第三方 API 可靠性)
  • 商业假设(变现路径、单位经济模型)

3.8 成功指标与监控

定义三个层次的指标:

北极星指标(1个):最能代表产品核心价值的单一指标,例如"每用户每周完成的[核心任务]次数"

驱动指标(3-5个):支撑北极星指标的先行指标

护栏指标(2-3个):确保在优化北极星指标时不损害的底线指标(如用户留存、NPS、崩溃率)

3.9 附录

  • 用研摘要(访谈对象、核心发现)
  • 关键数据分析(漏斗数据、竞品数据来源)
  • 待决事项(Open Questions)清单
  • 名词解释(Glossary)

Step 4:SVG 图表生成规范

每份 MRD 必须包含至少 2 个 SVG 图表,优先生成以下类型:

4.1 必选图表

图表 A:竞品定位地图(二维坐标)

  • X轴:根据产品特点选择最关键的差异化维度(如"价格:低→高")
  • Y轴:另一个关键维度(如"功能复杂度:简单→专业")
  • 在坐标系上标注各竞品位置和我们的目标位置
  • 文件命名:[product]-competitive-map.svg

图表 B:用户旅程 / 核心流程图

  • 展示用户完成核心任务的步骤
  • 标注每个步骤的情感曲线(开心/中性/痛点)
  • 标注我们的产品介入点
  • 文件命名:[product]-user-journey.svg

4.2 可选图表(根据产品类型选择)

  • TAM/SAM/SOM 同心圆图(to C 产品必选)
  • 功能优先级矩阵(Impact vs Effort 四象限)
  • 商业模式画布简化版
  • 系统架构概念图(to B 产品建议包含)

4.3 SVG 制作规范

尺寸:viewBox="0 0 800 500"(宽图)或 "0 0 600 600"(方图)
字体:font-family="'PingFang SC','Helvetica Neue',Arial,sans-serif"
配色方案:
  主色调:#4F46E5(靛蓝)
  辅色1:#16A34A(绿)
  辅色2:#EA580C(橙)
  辅色3:#BE185D(粉红)
  背景:#F8FAFC 或深色 #0F172A
  文字:#111827(深)/ #6B7280(次)/ white(反色)

每个 SVG 文件保存到 markdown/ 目录,在 Markdown 中用 ![描述](filename.svg) 引用。


Step 5:输出文件规范

目录结构

markdown/
├── [product-name]-mrd.md          ← 主 MRD 文档
├── [product-name]-competitive-map.svg    ← 竞品定位图
├── [product-name]-user-journey.svg       ← 用户旅程图
└── [product-name]-[其他图表].svg         ← 其他图表(如有)

文件命名

  • 主文档:[product-name]-mrd.md,全小写,连字符分隔
  • SVG:[product-name]-[chart-type].svg

文档质量自检清单

在输出前对照检查:

  • 执行摘要是否在 200 字内,包含问题/解法/机会/成功标准?
  • 用户画像是否包含 JTBD 三层任务分析?
  • 市场规模是否给出 TAM/SAM/SOM 三层且有数字?
  • 竞品分析是否包含"失败边界"而非只有功能对比?
  • 每个 User Story 是否有 AC 验收标准?
  • 是否明确列出"Won't Have"的内容?
  • 核心假设清单是否包含用户/市场/技术/商业四类假设?
  • 是否包含至少 2 个 SVG 图表且正确引用?
  • 成功指标是否包含北极星指标/驱动指标/护栏指标三层?
  • 文件是否已存储到 markdown/ 目录?

写作风格规范

语言

  • 简洁直接,避免空话("用户体验友好"不是需求,"操作步骤不超过 3 步"才是)
  • 量化优先:凡是能量化的地方都给出数字
  • 假设透明:凡是推断而非确认的数据,标注"待验证"

结构

  • 每个章节开头用 1-2 句话说明"这一章回答什么问题"
  • 使用表格组织对比信息,使用代码块组织模板内容
  • 图表优先于文字描述(能用图说清楚的不用段落)

常见错误清单(避免)

  • ❌ 把解决方案写成问题陈述
  • ❌ 用户画像只有人口属性,没有行为和任务
  • ❌ 竞品分析只列功能,不分析定位和失败边界
  • ❌ 需求列表没有优先级,或所有需求都是 P0
  • ❌ 没有"Won't Have"章节
  • ❌ 假设隐藏在正文中,没有显式列出
  • ❌ 成功指标只有一个层次

触发示例

以下都应触发本 Skill:

  • "帮我写个 MRD,我想做一个 AI 驱动的个人财务管理 App"
  • "我有个想法:给独立开发者做一个客服自动化工具,帮我生成 MRD"
  • "产品想法:B2B SaaS,帮中小企业做供应链协同,需要 MRD"
  • "写 MRD:一个帮助远程团队做异步视频沟通的产品"
  • "我想做一个结合 AI 的健身计划生成器,帮我写市场需求文档"
Install via CLI
npx skills add https://github.com/digoal/blog --skill write-mrd
Repository Details
star Stars 8,510
call_split Forks 1,914
navigation Branch main
article Path SKILL.md
More from Creator