# mindmap-to-prd

> 将 Markdown 格式的产品功能结构思维导图转换为详细的产品功能描述文档（PRD）。适用于产品设计、需求分析、产品规划等场景，能够将层级结构的功能列表扩展为完整的功能描述。

- Author: samuel
- Repository: samuel750/xmind2prototype_demo
- Version: 20260125123032
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/samuel750/xmind2prototype_demo
- Web: https://mule.run/skillshub/@@samuel750/xmind2prototype_demo~mindmap-to-prd:20260125123032

---

---
name: mindmap-to-prd
description: 将 Markdown 格式的产品功能结构思维导图转换为详细的产品功能描述文档（PRD）。适用于产品设计、需求分析、产品规划等场景，能够将层级结构的功能列表扩展为完整的功能描述。
---

# Markdown 思维导图转 PRD

## 任务目标
- 本 Skill 用于：将 Markdown 格式的产品功能结构思维导图转换为详细的产品功能描述文档（PRD）
- 能力包含：
  - 理解 Markdown 格式的产品功能结构（层级结构、功能点）
  - 将功能结构扩展为详细的功能描述文档
  - 支持从文本输入和文件上传两种方式获取输入
- 触发条件：用户需要将产品功能思维导图扩展为详细的功能描述文档时

## 前置准备
无需额外依赖或前置准备。

## 操作步骤

### 1. 获取输入内容

根据用户提供的输入方式，获取产品功能结构思维导图：

**方式一：文本输入**
- 直接使用用户在对话中输入的 Markdown 文本

**方式二：文件上传**
- 调用 `scripts/read_markdown.py` 读取用户上传的 Markdown 文件
  ```bash
  python3 /workspace/projects/mindmap-to-prd/scripts/read_markdown.py --file <文件路径>
  ```
  该脚本会返回文件的完整内容

### 2. 分析思维导图结构

智能体分析获取到的 Markdown 思维导图，识别：
- 产品的整体层级结构
- 各个功能模块的划分
- 具体功能点的关联关系
- 功能的优先级和依赖关系（如果有）

### 3. 生成详细功能描述

基于分析结果，生成符合以下规范的 PRD 文档：

#### 输出格式要求

**文档结构**：
```markdown
# 产品功能描述文档（PRD）

## 1. 产品概述
- 产品定位
- 核心价值
- 目标用户

## 2. 功能模块总览
- 功能架构图（文字描述）
- 模块列表

## 3. 详细功能描述

### 3.1 [模块名称]
#### 功能概述
- 功能定位和目标

#### 功能列表
##### [功能点名称]
- **功能描述**：详细说明功能的作用和意义
- **用户场景**：典型使用场景描述
- **操作流程**：用户如何使用该功能
- **前置条件**：使用该功能需要满足的条件
- **输出结果**：功能执行后的结果

### 3.2 [模块名称]
...

## 4. 非功能需求
- 性能要求
- 安全要求
- 可用性要求

## 5. 实现优先级
- P0：核心功能
- P1：重要功能
- P2：次要功能
```

#### 内容质量要求

每个功能点必须包含：
- **功能描述**：清晰说明功能的作用、目标和价值（50-100字）
- **用户场景**：描述典型的使用场景和用户痛点（30-80字）
- **操作流程**：详细的用户操作步骤（步骤清晰、逻辑完整）
- **前置条件**：使用该功能前需要满足的条件
- **输出结果**：功能执行后用户能够获得的具体结果

#### 转换规则

1. **层级映射**：
   - 一级标题 → 功能模块
   - 二级标题 → 功能点
   - 三级及以上标题 → 功能细节或子功能

2. **内容扩展**：
   - 对每个功能点进行详细描述，补充背景、目的、价值
   - 基于功能名称推断合理的用户场景
   - 设计完整的用户操作流程
   - 识别功能之间的依赖关系

3. **语言风格**：
   - 使用清晰、准确的产品语言
   - 避免技术术语堆砌
   - 面向产品团队和开发团队

### 4. 输出与确认

- 输出生成的完整 PRD 文档
- 根据用户反馈进行优化调整
- 支持多次迭代完善

## 资源索引

- 必要脚本：见 [scripts/read_markdown.py](scripts/read_markdown.py)（用途：读取 Markdown 文件内容）
- 领域参考：见 [references/conversion-guide.md](references/conversion-guide.md)（何时读取：需要了解详细的转换规则和示例时）

## 注意事项

- 确保输出的 PRD 文档结构完整、层次清晰
- 功能描述要具体可执行，避免模糊表述
- 保持产品思维，从用户价值和业务目标出发
- 当思维导图信息不足时，基于产品常识进行合理推断
- 如需调整生成内容，用户可直接提出具体要求进行优化

## 使用示例

### 示例一：文本输入

**用户输入**：
```
# 电商系统
## 用户模块
- 注册
- 登录
## 商品模块
- 商品列表
- 商品详情
```

**输出**：生成完整的电商系统 PRD 文档，包含用户模块和商品模块的详细功能描述。

### 示例二：文件上传

**用户指令**：
"上传了产品思维导图文件 product.md，请生成详细的功能描述"

**执行方式**：
1. 调用脚本读取文件
2. 分析思维导图结构
3. 生成完整的 PRD 文档

**输出**：生成符合规范的详细功能描述文档。

### 示例三：迭代优化

**用户反馈**：
"商品详情功能的描述不够详细，请补充商品规格、评价信息等内容"

**执行方式**：
基于用户反馈，对商品详情功能点进行扩展和完善

**输出**：更新后的 PRD 文档，包含更详细的功能描述