D2 実践ガイド (日本語)

D2 の日本語ステップアップガイド、実用サンプル集、Claude Code Skills。

構成

ディレクトリ	内容
guide/	ステップアップガイド — D2文法を段階的に学ぶ(全19章)
examples/	実用サンプル集 — カテゴリ別、雛形として使える.d2ファイル
skills/full/	Claude Code Skills (高精度版) — ガイド・サンプル参照あり
skills/minimal/	Claude Code Skills (軽量版) — 参照なしでも動く最低限版

ステップアップガイド

D2の文法を最小限のコードから段階的に学べるガイド。 各章で1-2個の新概念を導入し、既出概念との組み合わせ例で理解を深める。 各章にはd2コードとその実行結果(SVG画像)を掲載しているので、GitHub上で読むだけで図の仕上がりを確認できる。

目次

基礎 (7章)

章	タイトル	学ぶこと
01	基本	シェイプ宣言、ラベル、キー
02	接続	矢印、接続ラベル
03	シェイプタイプ	rectangle, circle, cylinder 等
04	コンテナ	ネスト、コンテナ内接続
05	テキストとコメント	テキストブロック、Markdown
06	スタイル	fill, stroke, opacity 等
07	アイコン	アイコン、画像

中級 (7章)

章	タイトル	学ぶこと
08	SQLテーブル	SQLテーブル図
09	UMLクラス	UMLクラス図
10	シーケンス	シーケンス図
11	グリッド	グリッドダイアグラム
12	変数	変数、substitution
13	グロブ	ワイルドカードパターン
14	レイアウト制御	direction, near

上級 (5章)

章	タイトル	学ぶこと
15	レイヤー	レイヤー、link
16	シナリオ	シナリオ、ステップ
17	インポート	ファイル分割、インポート
18	スタイルクラス	クラスによるスタイル再利用
19	実践Tips	ベストプラクティス

実用サンプル集

「この図を作りたい」→「この雛形をベースに」という使い方を想定。

カテゴリ	内容
flowchart/	フローチャート、業務フロー
network/	ネットワーク構成図
architecture/	アーキテクチャ図
sequence/	シーケンス図
er/	ER図
org/	組織図
infra/	インフラ構成図(AWS、Kubernetes)
state/	状態遷移図
class/	UMLクラス図
misc/	その他(比較表、マインドマップ風)

Claude Code Skills

他のプロジェクトで D2 図を生成する際に使えるスキル。 skills/README.md で詳細を確認。

スキル	特徴
full/	ガイド・サンプル参照ありの高精度版
minimal/	参照なしで動く軽量版

前提

• D2 がインストール済みであること
• d2 --version で動作確認