| 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
拿到用户输入后，在开始写作之前先做内部推理：
- 核心问题识别：这个产品要解决什么问题？谁有这个问题？
- 目标用户推断：根据 idea 描述，猜测目标用户群体（如有多个层次，区分 Primary/Secondary）
- 市场方向判断：to B / to C / to B2B2C？消费品还是工具类？
- 阶段判断：是 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 中用  引用。
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
文档质量自检清单
在输出前对照检查：
写作风格规范
语言：
- 简洁直接，避免空话（"用户体验友好"不是需求，"操作步骤不超过 3 步"才是）
- 量化优先：凡是能量化的地方都给出数字
- 假设透明：凡是推断而非确认的数据，标注"待验证"
结构：
- 每个章节开头用 1-2 句话说明"这一章回答什么问题"
- 使用表格组织对比信息，使用代码块组织模板内容
- 图表优先于文字描述（能用图说清楚的不用段落）
常见错误清单（避免）：
- ❌ 把解决方案写成问题陈述
- ❌ 用户画像只有人口属性，没有行为和任务
- ❌ 竞品分析只列功能，不分析定位和失败边界
- ❌ 需求列表没有优先级，或所有需求都是 P0
- ❌ 没有"Won't Have"章节
- ❌ 假设隐藏在正文中，没有显式列出
- ❌ 成功指标只有一个层次
触发示例
以下都应触发本 Skill：
- "帮我写个 MRD，我想做一个 AI 驱动的个人财务管理 App"
- "我有个想法：给独立开发者做一个客服自动化工具，帮我生成 MRD"
- "产品想法：B2B SaaS，帮中小企业做供应链协同，需要 MRD"
- "写 MRD：一个帮助远程团队做异步视频沟通的产品"
- "我想做一个结合 AI 的健身计划生成器，帮我写市场需求文档"
