1仕組みと動作原理

.canvas を、nodes と edges（いずれも任意）の2つのトップレベル配列のみを持つ JSON ファイルとして定義します。

skills/json-canvas/SKILL.md

- `nodes` (optional): Array of node objects

ここでの目的：最小限の有効なスケルトンを最初に提示し、以降のすべてのノードやエッジをこれら2つの配列下に配置できるようにします。

ノードを text / file / link / group の4種類に分類し、それぞれ固有の追加フィールド（text、file+subpath、url、label/background）を持たせます。

skills/json-canvas/SKILL.md

- `group` - Visual container for other nodes

ここでの目的：キャンバス上に現れる全要素を型の列挙で網羅し、編集時のターゲットを明確にします。

ノードは必須属性 id/type/x/y/width/height と任意属性 color を共有し、配列順序が z-index（先頭が下層、末尾が上層）となります。

skills/json-canvas/SKILL.md

| `id` | Yes | string | Unique identifier for the node |

ここでの目的：幾何情報と階層ルールを厳密に定義し、生成されたキャンバスがアプリケーションで正しくレンダリングされるようにします。

エッジ（edges）はノード間を接続し、fromSide/toSide/fromEnd/toEnd/color/label などの任意修飾子をサポートします。

skills/json-canvas/SKILL.md

| `toEnd` | No | string | `arrow` | Shape at edge end |

ここでの目的：「どのノード間を、どちらの面から、矢印の有無、何色で」接続するかをすべてパラメータ化します。

色（canvasColor）は hex 値またはプリセット番号 "1"〜"6" をサポートし、プリセットの具体的な値はあえて定義しません。

skills/json-canvas/SKILL.md

Note: Specific color values for presets are intentionally undefined, allowing applications to use their own brand colors.

ここでの目的：仕様では意味的な段階のみを固定し、カラーパレットはホストアプリケーションのブランドに委ねます。

ID は16桁の小文字16進数（64ビット乱数値）と取り決め、グローバルで一意であることを要求します。

skills/json-canvas/SKILL.md

This format is a 16-character lowercase hex string (64-bit random value).

ここでの目的：ID 生成基準を統一し、ノードやエッジ間での衝突を防ぎます。

レイアウトガイドを提供：座標は負の値も可、y は下方向に増加、推奨サイズ表、20〜50px のパディング、50〜100px のノード間隔。

skills/json-canvas/SKILL.md

- Space nodes 50-100px apart for readability

ここでの目的：「見栄えの良いレイアウト」を実行可能な間隔や寸法の推奨事項として定量化します。

末尾に8つの検証ルール（一意の id、参照の存在、必須フィールド、有効な列挙値など）を記載し、JSON Canvas Spec 1.0 へのリンクを付与します。

skills/json-canvas/SKILL.md

1. All `id` values must be unique across nodes and edges

ここでの目的：自己チェック可能な正確性リストを提供し、不正なファイルが生成されるリスクを低減します。

2コア機能

01Obsidian 互換の .canvas ファイルの作成/編集

02テキストノードの生成（Markdown コンテンツ）

03ファイル/添付ファイルノード（見出しやブロックを指す subpath を含む）

04リンクノード（外部 URL）

05グループコンテナノード（label および背景画像/背景スタイル）

06エッジ接続：方向、端点形状、色、ラベル

07色：hex 値またはプリセット番号 1〜6

08レイアウトと検証：推奨サイズ、間隔、8つの正当性ルール

4推奨統制措置と判定根拠

安全運用のための推奨統制措置

Agent 向け

自動ロード可能

管理者向け

ソースとバージョンの記録

判定根拠（ファイルパスと抜粋）

SKILL.md: プロンプト指示文とルールテキストのみで構成され、スクリプト実行や外部への影響は皆無

監査ノート： グリーン：当スキルのディレクトリには Markdown 形式の指示ファイルが1点含まれるのみで、スクリプトの実行、ネットワークリクエスト、認証情報の読み取り、ディスク書き込みコードは存在しません。実行にあたって外部入力を読み取ることもなく、純粋なナレッジ/仕様の構成となっています。統一評価基準に基づきグリーンと判定します。

5二重目の独立検証

[ok] 是否存在可执行脚本 — 目录清单仅 SKILL.md；扫描「执行外部程序」0 命中。
[ok] URL 命中性质 — §3 5 条 URL 均为规范链接（jsoncanvas.org/github.com/obsidianmd）或示例值（obsidian.md/example.com），非运行期请求。
[ok] 凭证/环境变量 — 0 命中，正文无 env/keychain 读取。
[ok] 写盘 — 0 命中；skill 只描述生成 JSON 内容，实际落盘由宿主完成。
[ok] 能力声明与内容相符 — description 声称创建/编辑 .canvas，正文含完整节点/边/示例/校验，无夸大。
[ok] 规范引用可定位 — 结尾 References 与开头 Overview 均指向 JSON Canvas Spec 1.0，口径一致。