XMind 思维导图生成与读取

技能文档

---
name: xmind-skill
title: XMind 思维导图生成与读取
description: 通过 MCP 服务器生成和读取 XMind（.xmind）文件，支持根据大纲、计划、PRD、测试方案等生成真正的思维导图文件，也能读取并解析已有导图内容、导出为 Markdown。当用户需要生成思维导图、XMind 文件、读取导图、梳理结构化思路、导出大纲时触发。触发词：思维导图、XMind、xmind、脑图、导图生成、导图读取、大纲导图。
category: 办公效率
---

# XMind 思维导图生成与读取

通过 MCP 服务器 `xmind-generator-mcp`（npm）生成和读取 **XMind** `.xmind` 文件。

本技能以对话为先：
- 「为这份大纲生成一个思维导图（可选：保存到…）」→ 生成 `.xmind` 文件并回传。
- 「读取这个 XMind，讲讲它讲了什么」→ 先解读导图，再提供 Markdown 导出。

## 适用场景
- 用户需要：「根据这份大纲 / 计划 / PRD / 测试方案生成一个 XMind 文件」。
- 输出必须是能用 XMind 打开的真实 `.xmind` 文件。

## 技能工作流

### 步骤1：解析用户意图与输出设置

1. 判断用户是「生成导图」还是「读取导图」。
2. 解析用户是否指定了保存位置/路径：
   - 已指定 → 使用该位置。
   - 未指定 → 默认保存到 `~/Desktop`。
3. 确定输出语言：
   - 用户指定了语言 → 按指定执行。
   - 未指定 → 与用户消息语言保持一致（中文提问生成中文主题，英文提问生成英文主题），仅当用户明确要求切换时才改变。
4. 确定文件名：
   - 用户提供了文件名/路径 → 直接使用。
   - 未提供 → 按请求语言生成简短文件名，不带日期；中文用简短短横风格，英文用短 slug（如 `hong-kong-1-day-itinerary`）。
   - 清理非法文件名字符：`\ / : * ? " < > |` 一律替换为 `-`。

### 步骤2：构造 Schema A JSON

MCP 工具 `generate-mind-map` 接受如下 Schema A JSON：

```json
{
  "title": "根主题",
  "filename": "mindmap-name-no-date",
  "topics": [
    {
      "title": "主题标题（核心信息保留在标题里）",
      "note": "可选：仅在标题写不下时少量使用",
      "labels": ["可选标签"],
      "markers": ["Arrow.refresh"],
      "children": [{"title": "子主题"}]
    }
  ]
}
```

构造要点：
- 控制规模合理，避免一次性塞进上千个节点。
- `note`：**少量使用**。只有当内容会让标题过长或嘈杂时才放进 note；属于计划核心的内容应保留在标题中。
- `labels`：用于轻量分类（如 必做/可选/雨天备选/预算内/亲子友好）。
- `relationships`：**少量使用**（Schema A 模式），仅用于真正能提升清晰度的跨分支关联。

### 步骤3：调用 MCP 生成 XMind

使用 `npx xmind-generator-mcp@0.1.2` 作为 MCP 服务器命令（stdio 方式，经由 mcporter）：

```bash
mcporter call --stdio "npx -y xmind-generator-mcp@0.1.2" generate-mind-map --args '{...}'
```

将第 2 步的 JSON 写入临时文件（如 `/tmp/xmind-<时间戳>.json`）后传入，记录/计算输出的文件路径。

### 步骤4：交付结果

1. 在对话中回传生成的 `.xmind` 文件。
2. 同时告知用户文件在磁盘上的保存位置。

### 步骤5：读取 XMind（Markdown 导出）

```bash
mcporter call --stdio "npx -y xmind-generator-mcp@0.1.2" read-mind-map --args '{"inputPath":"/path/to/file.xmind","style":"A"}'
```

对话中的读取体验要求：
1. 先详细解读导图内容（概要 + 结构 + 关键点 + 可执行项 + 缺口）。
2. 之后再询问用户是否需要导出。
3. 用户需要导出时，默认导出为 **Markdown**。

使用说明

# XMind 思维导图生成与读取

基于 MCP 服务器的 XMind 文件工具：可以从大纲、计划、PRD、测试方案等一键生成能被 XMind 打开的 `.xmind` 文件，也能读取已有导图并解读其内容、导出为 Markdown。

## 依赖

- Node.js（技能通过 `npx xmind-generator-mcp` 调用，无需单独安装）
- mcporter CLI

## 快速上手

生成导图——直接说：

```text
根据下面的大纲生成一个思维导图，保存到桌面：
- 旅行准备
  - 证件
  - 行李
- 行程安排
```

读取导图——把 `.xmind` 文件发给助手并说：

```text
读取这个 XMind，讲讲它的结构
```

需要导出时可追加：

```text
导出为 Markdown
```

## 说明

- 未指定语言时，生成的导图主题语言自动跟随你的提问语言。
- 未指定保存位置时，默认保存到 `~/Desktop`。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。