创建新文件时默认使用 Zen 格式；更新已有文件时保留原格式。

Markdown 表示规范

解析后的 Markdown 使用缩进列表式结构，格式如下：

# Sheet: 工作表标题

## 中心主题

> Labels: 标签1, 标签2
> Link: https://example.com
> Markers: priority-1
> 这里是中心主题的备注内容

- 分支1  {labels: 重要}  {link: https://example.com}
  > 这是分支1的备注
  > 备注可以有多行
  - 子节点1.1  {markers: task-done, priority-1}
    - 子子节点1.1.1
  - 子节点1.2
- 分支2
  - 子节点2.1
  - 子节点2.2

格式说明：

• # Sheet: 标题 — 工作表标题（多工作表之间用 --- 分隔）
• ## 标题 — 中心主题
• - 内容 — 节点，使用 2 空格缩进表示层级
• {labels: ...} — 行内标签元数据
• {link: ...} — 行内超链接元数据
• {markers: ...} — 行内标记/图标元数据
• > 内容 — 节点备注（blockquote 形式，紧跟在节点下方）
• 中心主题的元数据使用顶层 blockquote（> Labels:, > Link:, > Markers:）

核心流程

场景一：解析 XMind 文件

触发词 ："解析 xmind"、"打开思维导图"、"查看 xmind 内容"、"xmind 转 markdown"

步骤：

1. 确认文件路径 ：确认用户提供的 .xmind 文件路径是否存在

2. 执行解析 ：运行工具脚本

   python skills/xmind/scripts/xmind_tool.py --session <session-id> parse <file.xmind>

3. 展示结果 ：将输出的 Markdown 内容展示给用户，包括：

   • 思维导图的整体结构概览
   • 各节点的层级关系
   • 附带的标签、备注、链接等元数据

4. 记录记忆路径 ：输出末尾的 <!-- memory_file: ... --> 注释包含记忆文件路径，记住该路径以便后续操作使用

5. 引导交互 ：提示用户可以继续对思维导图内容进行提问、修改或导出

场景二：创建 XMind 文件

触发词 ："创建 xmind"、"新建思维导图"、"生成 xmind"

步骤：

1. 收集需求 ：与用户交流，明确思维导图的结构：

   • 中心主题是什么？
   • 有哪些主要分支？
   • 各分支下有哪些子节点？
   • 是否需要添加标签、备注、链接等？

2. 生成 Markdown ：根据用户描述，按照上述 Markdown 规范生成内容

3. 写入临时 Markdown 文件并执行创建 ：

   将 markdown 内容写入临时文件，然后执行创建

python skills/xmind/scripts/xmind_tool.py --session <session-id> create <output.xmind> <temp.md> [--format zen|legacy]

1. 确认创建结果 ：向用户报告文件创建成功，展示文件路径

2. 保持记忆 ：记忆文件已自动创建，后续可继续编辑

格式选择：

• 默认创建 Zen 格式（现代格式，兼容性更好）
• 如果用户明确要求 XMind 8 兼容格式，使用 --format legacy 参数

场景三：更新 XMind 文件

触发词 ："更新 xmind"、"修改思维导图"、"编辑 xmind"

步骤：

1. 加载当前内容 ：

   • 首先尝试读取记忆文件（如果之前已解析过）：

          python skills/xmind/scripts/xmind_tool.py --session <session-id> memory <file.xmind>
     

   • 如果没有记忆文件，先执行解析：

          python skills/xmind/scripts/xmind_tool.py --session <session-id> parse <file.xmind>
     

2. 理解修改需求 ：与用户确认要进行的修改，例如：

   • 添加新分支或子节点
   • 删除某个节点
   • 修改节点内容、标签或备注
   • 调整节点层级关系

3. 修改 Markdown ：在记忆文件的基础上进行修改，确保格式符合规范

4. 写入修改后的 Markdown ：将修改后的内容写入临时文件

5. 执行更新 ：

   python skills/xmind/scripts/xmind_tool.py --session <session-id> update <file.xmind> <modified.md>

6. 确认结果 ：向用户报告更新成功，展示变更摘要

场景四：基于记忆继续交流

当用户在同一会话中再次提到已解析的 xmind 文件时：

1. 读取记忆文件 ：使用 memory 命令获取之前解析的内容
2. 基于内容回答 ：根据 Markdown 内容回答用户问题
3. 支持操作 ：
   • 总结思维导图要点
   • 搜索特定节点
   • 分析结构和层级关系
   • 提出改进建议
   • 将内容转换为其他格式（大纲、表格等）

注意事项

• 解析和创建操作涉及文件 I/O，执行前确认路径有效
• 更新操作会覆盖原文件，如用户未明确要求，建议先备份或另存为新文件
• 记忆文件存储在 /tmp/skills-xmind-parsed/<session-id>/，会话结束后可能被系统清理
• 如遇到损坏的 xmind 文件（非有效 ZIP 或缺少关键内容文件），向用户报告具体错误
• XMind 文件中的图片附件不会包含在 Markdown 中，仅处理文本结构和元数据
• 整个流程中使用中文与用户交互

Weekly Installs

226

Repository

mitscherlich/skills

First Seen

Feb 2, 2026

Security Audits

Gen Agent Trust HubPassSocketPassSnykPass

Installed on

opencode215

codex210

gemini-cli209

kimi-cli208

cursor208

github-copilot208