AgentSkillsCN

mindm-mindmap

通过 mindm-mindmap CLI 或 python -m mindmap.actions，实现 MindManager 思维导图的高级操作。当您需要读取思维导图、提取选区信息、或将思维导图转为 Mermaid 格式，或从 Mermaid 中重新生成思维导图时，此技能都能助您事半功倍。

SKILL.md
--- frontmatter
name: mindm-mindmap
description: High-level MindManager mindmap operations via the mindm-mindmap CLI or python -m mindmap.actions. Use when a map must be read (mindmap, selection, grounding info), serialized to Mermaid, or created from Mermaid.
version: 1.0.0
requires:
  - mindm
platforms:
  - macos
  - windows

Mindm Mindmap

Overview

Use the mindm-mindmap CLI to query the current MindManager map or create a new map from Mermaid. This skill targets high-level map operations that mirror the MCP server capabilities.

Quick start

Get the current mindmap as JSON:

bash
uvx --from mindm mindm-mindmap get-mindmap --mode content

Get the current selection:

bash
mindm-mindmap get-selection --mode content

Get grounding information:

bash
mindm-mindmap get-grounding-information --mode content

Serialize to Mermaid:

bash
mindm-mindmap serialize-mermaid
mindm-mindmap serialize-mermaid --mode full --id-only

Create a map from Mermaid:

bash
mindm-mindmap create-from-mermaid --input /tmp/map.mmd

Create a map from Mermaid (full metadata or simplified indentation). The CLI auto-detects the format.

Round-trip test (serialize → create):

bash
mindm-mindmap serialize-mermaid --mode full | mindm-mindmap create-from-mermaid

Notes

  • •Keep MindManager open with the target map active before running the CLI.
  • •For macOS, use --macos-access applescript (default) or appscript.
  • •For full flag details, read references/cli.md.
  • •For full Mermaid metadata (notes, links, icons, tags), read references/mermaid.md.
  • •JSON responses return the raw data for the command. Errors return {"error": "...", "message": "..."}.

Troubleshooting

ProblemSolution
"No active document" errorOpen a map in MindManager before running the CLI
Empty response or timeoutEnsure MindManager is responsive (not showing a modal dialog)
Permission denied (macOS)Grant Accessibility permissions to Terminal/IDE in System Settings → Privacy & Security
appscript import errorInstall with pip install appscript or use --macos-access applescript
Mermaid parse errorCheck syntax; use --mode full output as reference for valid format
Icons not appearingVerify stock icon index exists (see references/mermaid.md)