xmind-file

Name: xmind-file
Author: xmindltd

github.com/xmindltd生産性10252 回インストール14 週間前に更新

リポジトリ

xmind-file について

xmind-fileは、ローカルの.xmindファイルを生成・編集するスキルです。マインドマップを作成・修正する際、内容や視覚面の判断とCLIによる実行を分けて扱います。

主な機能

01レシピに基づくマップ生成
02既存の.xmindファイルの編集
03画像とリンクの追加
04マップの検証と確認
05複数編集の一括実行

活用シーン

01テーマに沿った構造的なマップの作成
02既存マップのノードや視覚スタイルの修正
03マップのトピックへの画像やリンクの追加

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/xmindltd/xmind-cli --skill xmind-file

インストール後、Claude Code で/xmind-fileを入力して読み込まれたか確認します。

詳細

Xmind ファイル

ローカルの .xmind を生成・編集するための実行時プロトコルです。

エントリースキルが実行順序とデリバリーのゲートを管理します。レシピがコンテンツを管理します。 Visual がセマンティックアンカーの計画を管理します。CLI が機械的な実行を管理します： generate、ファイル IO、課金／ダウングレード、アンカー、画像、検証です。

セットアップ

which xmind || npm install -g "$(find ~/.claude /mnt/skills -name 'xmind-cli-*.tgz' 2>/dev/null | head -1)" 2>/dev/null || npm install -g @xmindltd/xmind-cli
xmind auth status

認証されていない場合は、xmind auth login または xmind auth token <value> を実行します。ファイルコマンドにはログインが必要です。

基本的な境界

エージェントはセマンティックな判断を担います：レシピ、Markdown、ルートの意図、アンカー、画像の対象です。
xmind generate はセマンティック仕様を .xmind にコンパイルします：ルートゲート、骨組み／色、課金／ダウングレード、作成、アンカー、画像、検証、JSON レポートです。
xmind advise、create、batch、image、validate は、クイックマップ、編集、修復、検査用の低レベルツールとして引き続き使用できます。
クレジットを避けるために、コンテンツやビジュアルの質を落とさないでください。適切な成果物を選び、課金、ダウングレード、レポートは CLI に任せてください。
JSON 標準出力の billing.consumed の値をターンのクレジットとして合計します。billing がない場合は 0 です。

レシピの選択

下書きを作成する前に xmind skill list を実行し、レシピカタログとトリガーを信頼できる情報源として扱ってください。このスキル内でレシピの一覧を管理しないでください。

ユーザーがレシピを指定した場合、または要求された成果物に最適なレシピが 1 つであると確信できる場合は、そのレシピを直接選択します。それ以外の場合は、最適な候補を提示し、関連するカタログの選択肢を 2～4 件、それぞれが成果物をどのように構成するかの簡単な説明とともに示して、ユーザーが選ぶまで下書きの作成を待ちます。確信が持てない場合は、ユーザーの選択を優先してください。

これは CLI／サーバーのフォールバックを上書きするものではありません。プレミアムレシピへのアクセスまたは Xmind クレジットが利用できないために xmind skill show が effective: "quick-map" を返した場合は、有効なレシピに従い、フォールバックについて明確に説明してください。

コンテキストの読み込み

必要な情報	読み込む内容
機能の確認	`xmind skill list`
充実した新規マップ	`xmind skill show markdown-grammar recipe/<chosen> visual --json`
無料のクイックマップ	`xmind skill show markdown-grammar recipe/quick-map --json`
既存マップの編集	`xmind skill show edit/guide`
低レベルの修復操作	`xmind skill show visual/layout-style visual/node-style`
作業実行のオーバーレイ	`xmind skill show task-overlay`

レシピ JSON では、requested、effective、createSkill を記録します。CLI がフォールバックレシピを提供する場合は、effective を基に下書きを作成し、その createSkill を使用します。

一時ファイルの IO

/tmp 配下の安定した一時パスを使用します。コマンド間で $$、$RANDOM、mktemp は使用しないでください。

下書き：/tmp/xmind-draft-<id>.md
Generate 仕様：/tmp/xmind-generate-<id>.json
ダウンロードした画像／ユーザーの画像：添付するまで保持される、ディスク上の実ファイル。

デリバリーの成功後は、生成した一時 Markdown／仕様ファイルのみを削除します。依頼がない限り、最終的な .xmind、ユーザー提供の入力ファイル、または保持中のダウンロード済みアセットは削除しないでください。

Generate 仕様

充実したマップを生成する場合は、セマンティック仕様を作成し、CLI にコンパイルさせます。

{
  "version": 1,
  "markdown": { "path": "/tmp/xmind-draft-<id>.md" },
  "recipe": {
    "name": "<requested recipe>",
    "effective": "<effective recipe>",
    "createSkill": "<recipe item createSkill>"
  },
  "route": {
    "structuralType": "<radial_overview|mixed_modular|temporal_axis|procedural_flow|matrix_board|causal_ribs|hierarchy_tree|part_whole>",
    "structureCommitment": "<required|preferred|optional>",
    "toneTag": "<tech|nature|retro|elegant|fresh|sweet|vivid|plain>",
    "density": "<light|standard|deep>"
  },
  "baseline": {
    "skeleton": "auto",
    "color": "auto",
    "diversify": true,
    "seed": "<stable id>"
  },
  "anchors": {
    "layout": [],
    "group": [],
    "focus": [],
    "image": []
  }
}

ベースラインの選択、アンカーファミリーの意味、対象の選択、およびアンカー品質ゲートについては Visual に従ってください。

セマンティック品質ゲート

generate の前に、Markdown としてだけでなくコンテンツとして下書きを確認します。

選択したレシピがユーザーの目的に合っていること。必要な深いマップを quick-map で代用しないでください。
最上位のブランチがそれぞれ異なる側面を扱い、何でも含める大きなくくりになっていないこと。
重要なブランチに、目に見える子構造があること。実際の階層をノートに担わせないでください。
アンカーの対象が、誠実なコンテンツ内にすでに存在し、タイトルで見つけられること。
ルートフィールドがルートの関係を示し、アンカーが局所的な例外を示していること。

このゲートを通過できない場合は、CLI を実行する前に Markdown／仕様を修正してください。機械的な検証では、内容の浅さや意味的に見せかけだけのマップは検出できません。

Flow A：リッチ生成

コンテキストを読み込みます：

xmind skill list
xmind skill show markdown-grammar recipe/<chosen> visual --json

有効なレシピに基づいて Markdown の下書きを作成します。

レシピの密度、構成、意味的なシグナル、ノートの方針、セルフチェックに従います。まず見出しの骨組みを作成し、次に必要なノートとアンカー候補を追加します。純粋な CommonMark を /tmp/xmind-draft-<id>.md に書き込みます。
Visual で定義されたルートとベースラインのセマンティクスを使用して、 /tmp/xmind-generate-<id>.json を作成します。
事前チェックを行い、必要に応じてドライランします：
```
xmind generate check --spec /tmp/xmind-generate-<id>.json
xmind generate --spec /tmp/xmind-generate-<id>.json --dry-run -o <file>.xmind
```
深いマップ、プレミアム対応のベースライン、またはベースラインが重要な場合は、ドライランを使用します。ルートゲートでブロックされた場合は、同じ Markdown／仕様を修正します。
生成します：
```
xmind generate --spec /tmp/xmind-generate-<id>.json -o <file>.xmind
```
標準出力の JSON を正式な結果として扱います。validation.ok が false の場合、または anchors.applied[].success のいずれかが false の場合は、同じ Markdown／仕様を修正して再実行します。 CLI の検証に合格することは必要ですが、それだけでは不十分です。引き渡す前に、セマンティックゲートも再確認してください。

必要な場合にのみ確認します：

xmind read <file>.xmind
xmind describe <file>.xmind
xmind validate <file>.xmind --quiet

Flow Q：クイック無料生成

選択したレシピが quick-map の場合に使用します。

読み込みます：

xmind skill list
xmind skill show markdown-grammar recipe/quick-map --json

有効なレシピに従って、簡潔な Markdown の下書きを作成します。
有効なレシピのモード表から、モードと無料の骨組みを選択します。
作成して検証します：
```
xmind create --from-markdown /tmp/xmind-draft-<id>.md --skeleton <free-name> --color Dawn-#ffffff-MULTI_LINE_COLORS --skill <createSkill> -o <file>.xmind
xmind validate <file>.xmind --quiet
```
検証に失敗した場合、ユーザーから求められた場合、または軽微な修正が明らかに必要な場合にのみ、 read／describe を実行します。
制限を伝えます。

これは簡易的な概要であり、完全なリッチマップの手順ではないことをユーザーに伝えます。より詳しいタイトルやノート、ビジュアルアンカー、画像、またはプレミアム対応の構造を希望する場合は、より充実したレシピで再生成できることを案内します。

Flow B：既存マップの編集

edit/guide を読み込みます。編集によってビジュアル表現が変わる場合にのみ visual を読み込みます。

まず確認します：

xmind read <file>.xmind
xmind describe <file>.xmind
xmind validate <file>.xmind --quiet

現在の構造に基づいて計画し、関係のないユーザーの変更は保持します。
複数操作の編集には xmind batch を1回使用し、単一の編集には直接コマンドを使用します。
read、describe、validate を再実行します。

画像

画像入力には、ユーザーが提供したローカルファイル、安定したラスター画像 URL、または Wikipedia ページの画像を使用できます。このスキルの一部として画像を生成しないでください。このリポジトリでは、生成画像のワークフローは提供していません。

リモート画像 URL は公開されたラスター画像である必要があります。SVG、プライベート／ローカルネットワークの URL、および画像以外のペイロードは拒否されます。

Flow A では、anchors.image で画像を宣言し、xmind generate が最後に添付するようにします。編集の場合：

xmind image <file>.xmind --topic "<topic title>" --input "<local-image-path>"
xmind image <file>.xmind --topic "<topic title>" --url "<https-image-url>"
xmind image <file>.xmind --topic "<topic title>" --wiki "<Wikipedia page title>"

リンク

単一のトピックには link を使用します。ローカルパスは絶対 file:/// URI に解決され、 Xmind Desktop が記述する形式と同じ形式で URL エンコードされます：

xmind link <map>.xmind --topic "Reference" --url "https://example.com"
xmind link <map>.xmind --topic "Local map" --file "../maps/example.xmind"
xmind link <map>.xmind --topic "Reference" --remove

バッチ編集では、href に href または file のいずれか一方を指定できます：

{"op":"href","topic":"Local map","file":"../maps/example.xmind"}

ローカルファイルへのリンクは元のファイルを指し、.xmind アーカイブに埋め込んだりコピーしたりはしません。その絶対パスが存在するマシンでのみ機能します。マップを他の環境でも使用する必要がある場合は、 https URL を使用してください。

引き渡しゲート

Flow A の場合：

有効なレシピを読み込み、それに従っている。
Generate の仕様が一時 Markdown を参照し、recipe.createSkill を含んでいる。
xmind generate check に合格している。
複雑なマップではドライランを実行している、または理由を示してスキップしている。
最終的な generate レポートの validation.ok: true を確認している。
必須の anchors.applied[].success がすべて true である。
課金額を billing.consumed から読み取っている。
成功後、一時 Markdown／仕様を削除している。

Flow Q の場合：

recipe/quick-map を読み込み、それに従っている。
明示的に上書きされていない限り、無料の骨組みを使用している。
createSkill を xmind create --skill に渡している。
xmind validate で構造上のエラーがない。

ユーザーへの説明

生成内容が複雑な場合は、ユーザーの言語で結果を簡潔に説明します。

レシピ／コンテンツの構成がトピックに適している理由。
主要なビジュアル要素の根拠となった、表示されているノードやグループ。
生成に Xmind クレジットを使用したかどうか。OpenAI、Codex、モデル、トークンのクレジットとは決して呼ばないでください。

特に route.skeletonReason、route.colorReason、anchors.applied、billing.consumed、billing.balance、billing.unit、downgraded については、CLI の JSON を正とします。billing がない場合、そのターンの Xmind クレジット消費量は 0 とします。

次の具体的なアクションを 1 つか 2 つ提案します。ブランチを掘り下げる、レシピを比較する、画像やスタイルを調整する、既存の .xmind を編集する、よりシンプルな無料版を作成する、検証／検査を実行する、といった内容です。

最終回答には、ファイルパス、検証結果、重要なデザイン上の選択を 1 つか 2 つ記載します。求められない限り、アウトライン全体は表示しないでください。

ファイルがすでに Xmind で開かれていた場合、その後の CLI 編集がすぐには反映されないことがあります。表示を更新するには、Xmind を閉じてから開き直すようユーザーに伝えてください。

Markdown 対応

ログインしてコメント

基本情報

作者: xmindltd
リポジトリ: xmindltd/xmind-cli
カテゴリ: 生産性
インストール数: 252
GitHub スター: 10

問題を報告