npx skills add ...
npx skills add mitscherlich/skills --skill xmind
当用户要求"解析 xmind"、"打开思维导图"、"创建 xmind"、"新建思维导图"、"更新 xmind"、"修改思维导图"、"xmind 转 markdown"、"查看 xmind 内容"时,应使用此技能。此技能提供 XMind 思维导图文件的解析、创建和更新能力,支持 XMind 8 和 XMind Zen/2020+ 两种格式,并将内容转换为 Markdown 作为会话记忆,方便持续交流。
npx skills add mitscherlich/skills --skill xmind
此技能提供 XMind 文件(.xmind)的完整处理能力:解析、创建和更新。通过配套的 Python 工具脚本实现文件操作,将思维导图内容转换为 Markdown 格式作为会话级记忆,便于用户与模型持续交流和编辑。
本技能依赖 scripts/xmind_tool.py(相对于本技能目录),使用 Python 标准库(零第三方依赖)。执行方式:
所有命令都需要 --session <id> 参数,用于隔离不同会话的记忆文件。
会话 ID 获取规则(按优先级):
f47ac10b-58cc-4372-a567-0e02b2c3d479),并在后续调用中持续复用/tmp/skills-xmind-parsed/<session-id>/<filename>.md| 格式 | 版本 | 内部结构 | 检测方式 |
|---|---|---|---|
| Zen | XMind Zen / 2020+ | ZIP 内含 content.json | 自动检测 |
| Legacy | XMind 8 | ZIP 内含 content.xml | 自动检测 |
创建新文件时默认使用 Zen 格式;更新已有文件时保留原格式。
解析后的 Markdown 使用缩进列表式结构,格式如下:
格式说明:
# Sheet: 标题 — 工作表标题(多工作表之间用 --- 分隔)## 标题 — 中心主题- 内容 — 节点,使用 2 空格缩进表示层级{labels: ...} — 行内标签元数据{link: ...} — 行内超链接元数据{markers: ...} — 行内标记/图标元数据> 内容 — 节点备注(blockquote 形式,紧跟在节点下方)> Labels:, > Link:, > Markers:)触发词:"解析 xmind"、"打开思维导图"、"查看 xmind 内容"、"xmind 转 markdown"
步骤:
确认文件路径:确认用户提供的 .xmind 文件路径是否存在
执行解析:运行工具脚本
展示结果:将输出的 Markdown 内容展示给用户,包括:
记录记忆路径:输出末尾的 <!-- memory_file: ... --> 注释包含记忆文件路径,记住该路径以便后续操作使用
引导交互:提示用户可以继续对思维导图内容进行提问、修改或导出
触发词:"创建 xmind"、"新建思维导图"、"生成 xmind"
步骤:
收集需求:与用户交流,明确思维导图的结构:
生成 Markdown:根据用户描述,按照上述 Markdown 规范生成内容
写入临时 Markdown 文件并执行创建:
确认创建结果:向用户报告文件创建成功,展示文件路径
保持记忆:记忆文件已自动创建,后续可继续编辑
格式选择:
--format legacy 参数触发词:"更新 xmind"、"修改思维导图"、"编辑 xmind"
步骤:
加载当前内容:
首先尝试读取记忆文件(如果之前已解析过):
如果没有记忆文件,先执行解析:
理解修改需求:与用户确认要进行的修改,例如:
修改 Markdown:在记忆文件的基础上进行修改,确保格式符合规范
写入修改后的 Markdown:将修改后的内容写入临时文件
执行更新:
确认结果:向用户报告更新成功,展示变更摘要
当用户在同一会话中再次提到已解析的 xmind 文件时:
memory 命令获取之前解析的内容/tmp/skills-xmind-parsed/<session-id>/,会话结束后可能被系统清理