Xmind CLI 思维导图

要解决什么问题

在 Agent 对话里起草的思维导图内容，往往停留在 Markdown 或口头结构：层级是否完整、分支是否互不重叠、备注是否抢了主层级，这些都要人眼再审一遍。直接手改 .xmind 里的 ZIP/XML 既脆弱又难追溯；而「先出图再补内容」又容易让机械校验替代内容判断，产出结构残缺或 recipe 错配的图。

技能如何工作

本技能把 内容先行 和 CLI 执行 分开：你负责理解目标、选 recipe、写 CommonMark 草稿，以及用自然语言描述 route、baseline 与 anchors；xmind generate 负责落成本地文件、选结构与配色、应用局部强调与图片，并以 JSON 报告 回报 validation、anchors.applied 与 billing。

典型丰富生成路径可以概括为：

• 用 xmind skill show 加载 effective recipe 与 visual 规则，按密度与自检要求起草 /tmp/xmind-draft-<slug>.md
• 需要结构建议时调用 xmind advise（骨架排名或指定 skeleton 的子布局建议）
• 编写 spec 后先做 Semantic Quality Gate（recipe 是否匹配、顶层维度是否完整、anchor 是否对应真实标题等），再 xmind generate check，必要时 dry-run
• 以 validation.ok === true 且必需 anchors 全部成功为交付门槛；失败则改同一份 Markdown/spec 重试，不绕过门槛

浅层概览可走 recipe/quick-map 的 xmind create 快速路径；编辑已有文件则先 read/validate，布局与样式变更再加载 visual 规则，优先 xmind batch 批量改。

边界与注意点

• 仅处理 本地 .xmind，不用 xmind-cloud，也不生成 AI 图片
• 国区固定 cn 登录；文件类命令前须完成登录，且不记录用户 token
• 不为省 Xmind credits 而砍内容或视觉质量；扣费、降级以 CLI JSON 的 billing / downgraded 为准
• 丰富生成后图片应写在 spec 的 anchors.image，由 generate 统一附加，而非默认逐个 xmind image 打补丁