Flowy、AIネイティブ図スキル
Flowyは自己完結型のHTMLファイルを生成し、インタラクティブなSVG図をレンダリングします。各ファイルにはCSS、JavaScript、図データが埋め込まれており、依存関係は一切なく、ダブルクリックすれば任意のブラウザで開くことができます。
ファイルの場所
- 図ファイル:
docs/diagrams/*.html(例:docs/diagrams/upload-flow.html)。 初回使用時にフォルダを作成してください(存在しない場合があります)。プロジェクトがすでに別の場所に図を管理している場合は、そのプロジェクトの規則に従ってください。 - HTMLテンプレート:
${CLAUDE_SKILL_DIR}/references/html-template.html。 標準レンダラーであり、このスキルが提供する唯一のリファレンスファイルです。このパスはスキルがインストールされている場所(プラグイン、個人、プロジェクト)に応じて解決されるため、現在のプロジェクトに依存しません。
スキーマファイル、サンプルフォルダ、ビジュアルエディタは意図的に用意されていません。以前のバージョンではflowy/schema.ts、flowy/examples/、flowy/editor.html、およびディスク上のFlowyソースリポジトリを参照していましたが、これらは存在せず、パスは古く、従うと時間を無駄にします。上記のHTMLテンプレートが構造の唯一の信頼できる情報源です。図を作成する前に必ず読んでください。
事前確認
Flowy図を作成または編集する前に:
${CLAUDE_SKILL_DIR}/references/html-template.htmlを読み、最新のレンダラーコードを確認するdocs/diagrams/にある既存の図ファイルを一覧表示し、名前の衝突を避ける- 既存の図を更新する場合は、まず読み込んで
DIAGRAMオブジェクトを抽出する
スキーマ
各図は3つのフィールドを持つJavaScriptオブジェクトです:
{
meta: { title, description, type, tags[], created, updated },
nodes: [...],
edges: [...]
}
meta
| フィールド | 型 | 必須 | 備考 |
|---|---|---|---|
| title | string | はい | 人間が読めるタイトル |
| description | string | いいえ | 図の説明 |
| type | string | はい | "flowchart" または "ui-mockup" |
| tags | string[] | いいえ | 整理用 |
| created | string | いいえ | ISO日付(YYYY-MM-DD) |
| updated | string | いいえ | ISO日付。作成/更新時に今日の日付を設定 |
nodes
| フィールド | 型 | 必須 | 備考 |
|---|---|---|---|
| id | string | はい | 一意、スネークケース(例: "step1_upload") |
| type | string | はい | "box"、"circle"、"diamond"、"note"、"group" |
| label | string | はい | 図形に表示される主要テキスト |
| sublabel | string | いいえ | ホバーツールチップに表示される二次テキスト |
| position | { x, y } | はい | ピクセル単位の左上隅 |
| size | { width, height } | はい | ピクセル単位の寸法 |
| style | object | いいえ | 下記ノードスタイルフィールドを参照 |
| group | string | いいえ | 親グループノードのid(視覚的なグループ化のみ) |
ノードスタイルフィールド: fill、stroke、strokeWidth、color(テキスト)、fontSize、borderRadius、opacity
edges
| フィールド | 型 | 必須 | 備考 |
|---|---|---|---|
| id | string | はい | 一意(例: "e_upload_to_extract") |
| source | string | はい | ソースノードid |
| target | string | はい | ターゲットノードid |
| label | string | いいえ | 矢印上のテキスト(例: "yes"、"error") |
| sourceHandle | string | いいえ | "top"、"right"、"bottom"(デフォルト)、"left" |
| targetHandle | string | いいえ | "top"(デフォルト)、"right"、"bottom"、"left" |
| style | object | いいえ | 下記エッジスタイルフィールドを参照 |
エッジスタイルフィールド: stroke、strokeWidth、strokeDasharray、markerEnd
ノードレンダリングルール
| タイプ | SVG要素 | 詳細 |
|---|---|---|
| box | <rect> | borderRadiusからrx/ryで角丸。デフォルト: 8px |
| circle | <ellipse> | cx = x + width/2、cy = y + height/2、rx = width/2、ry = height/2 |
| diamond | <polygon> | 4点: 上中央、右中央、下中央、左中央 |
| note | <path> | 右上角が折り畳まれた長方形。折りサイズ: 12px |
| group | <rect> | 破線境界(stroke-dasharray: 6,3)。他の全ノードの背後にレンダリング。ラベルは左上。低不透明度 |
エッジレンダリングルール
- ソース点を計算: ソースノードの指定されたハンドル側の中心(デフォルト: 下)
- ターゲット点を計算: ターゲットノードの指定されたハンドル側の中心(デフォルト: 上)
- ハンドル方向に50pxオフセットした制御点を持つ3次ベジェ曲線(
Cコマンド)を描画 - SVG
<marker>定義を使用して矢印を追加 strokeDasharrayが設定されている場合は破線としてレンダリングlabelが存在する場合は、ベジェ曲線の中点に小さな白い背景矩形とともにレンダリング
レイアウトルール
フロー方向
- フローチャート: 上から下(デフォルト)
- UIモックアップ: グループコンテナ内は上から下、注釈は右側
間隔
- ノード中心間の垂直方向最小70px
- 並列ノード間の水平方向最小60px
- グループパディング: グループ境界内側40px
判断ダイアモンド
- 左分岐 = 主要 / yes パス
- 右分岐 = 二次 / no / error パス
エラー/警告ノート
- メインフローの右側に配置
- 破線の赤いエッジで接続(
strokeDasharray: "6,3"、stroke:#991b1b)
標準サイズ
| タイプ | 幅 | 高さ |
|---|---|---|
| box | 200 | 50 |
| circle | 90 | 40 |
| diamond | 120 | 60 |
| note | 180 | 44 |
カラーパレット
| 目的 | 塗りつぶし | 枠線 | テキスト |
|---|---|---|---|
| アクション | #ffffff | #2d6a4f | #1f2937 |
| プライマリアクション | #d1fae5 | #065f46 | #065f46 |
| 判断 | #fef3c7 | #92400e | #1f2937 |
| エラー | #fee2e2 | #991b1b | #991b1b |
| 開始/終了 | #40916c | #2d6a4f | #ffffff |
| グループ | #f5f5f2 | #e6e4df | #374151 |
| 情報/二次 | #dbeafe | #1e40af | #1e40af |
| デフォルトエッジ | #6b7280 | #6b7280 | #6b7280 |
HTMLファイル構造
すべてのFlowy HTMLファイルは以下の構造に従います。完全な動作コードはHTMLテンプレートリファレンスを参照してください。
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>{diagram title}</title>
<style>
/* すべてのCSSはインライン: ツールバー、キャンバス、ツールチップ、選択ハイライト */
</style>
</head>
<body>
<div id="toolbar">
<!-- [Fit] [-] 100% [+] Title badge [Download JSON] -->
</div>
<div id="canvas-wrap">
<svg id="canvas">
<defs><!-- arrowhead markers --></defs>
<g id="diagram-root"></g>
</svg>
</div>
<div id="tooltip"></div>
<script>
const DIAGRAM = { meta: {...}, nodes: [...], edges: [...] };
// レンダリング + インタラクティブコード
</script>
</body>
</html>
ツールバー
- 上部固定、48px高、白背景、下線
- 左: ズームにフィットボタン、ズームアウト、ズーム%、ズームイン
- 中央: 図タイトル(太字)+ タイプバッジ(グレーのピル)
- 右: JSONダウンロードボタン(青)
インタラクティブ機能(すべてバニラJS)
- ズーム: マウスホイールでSVG viewBoxを拡大縮小。範囲: 0.2倍〜5倍。カーソル位置に向かってズーム。
- パン: 空のキャンバスをクリック&ドラッグでviewBoxを移動。
- ホバー: ノードにカーソルを合わせると、その
sublabelがカーソル近くのツールチップに表示される。 - クリック: ノードをクリックするとハイライト表示(青枠)され、接続されたすべてのエッジもハイライト。空スペースをクリックで選択解除。
- ズームにフィット: ボタンが全ノードのバウンディングボックスを計算し、60pxのパディングを付けてviewBoxを設定。
- JSONダウンロード:
DIAGRAMオブジェクトを整形JSONとしてシリアル化し、ファイルダウンロードをトリガー。
新しい図の作成
ユーザーが新しいフローチャートやUIモックアップを依頼した場合:
- テンプレートを読む: HTMLテンプレートリファレンスファイルを読み、最新のレンダラーコードを取得する
- リクエストを分析する: ノード(ステップ、判断、エラー)とエッジ(接続)を特定する
- レイアウトルール(上から下のグリッド、標準間隔)を使用して位置を割り当てる
- カラーパレット(開始/終了 = 緑、判断 = 琥珀、エラー = 赤など)を使用して色を適用する
- 完全なHTMLファイルを生成する: テンプレート構造をコピーし、
DIAGRAMオブジェクトを新しいデータで置き換える docs/diagrams/{kebab-case-name}.htmlに保存する- ユーザーに伝える: 「ブラウザで
docs/diagrams/{name}.htmlを開いて図を表示してください。」
ファイル命名
- 場所:
docs/diagrams/{name}.html - 形式:
kebab-case.html(例:docs/diagrams/upload-flow.html、docs/diagrams/checkout-screen.html) meta.updatedを今日のISO日付に設定する
既存の図の更新
ユーザーが図の変更を依頼した場合:
- 既存のHTMLファイルを読み込む
<script>ブロックからDIAGRAMオブジェクトを抽出する- リクエストに従ってノード/エッジを変更する
meta.updatedを今日の日付に更新する- 更新されたデータで完全なHTMLファイルを再生成する(最新のレンダラーを取得するためテンプレートを再読込)
- 同じパスに保存する
図の読み取り
図の分析や説明を求められた場合:
- HTMLファイルを読み込む
const DIAGRAM = { ... };ブロックを見つける- ノードをタイプとラベル別に一覧表示する
- エッジを辿り、自然言語でフローを説明する
- 判断点とその分岐を強調する
例
「ログインフローのフローチャートを作成して」
アクション: docs/diagrams/login-flow.htmlを作成:
start(円、緑)→enter_credentials(ボックス)→validate(ダイアモンド、琥珀)validate→ yes/左 →dashboard(円、緑)validate→ no/右 →show_error(ノート、赤)→ 破線矢印でenter_credentialsに戻る
「設定モックアップにダークモードトグルを追加して」
アクション: docs/diagrams/settings-screen.htmlを読み込み、DIAGRAMを抽出し、「Dark Mode」というラベルの新しいボックスノード"section_dark_mode"をテーマセクションの後に配置し、meta.updatedを更新し、HTMLを再生成する。
「アップロードフローのステップ3にエラーハンドリングを追加して」
アクション: HTMLを読み、ノード配列からステップ3を見つけ、右側にエラーノートノードを追加し、ステップ3からエラーノートへの破線の赤いエッジを追加し、再生成する。
重要な制約
- 依存関係ゼロ: npm、CDNリンク、外部スクリプト/スタイルなし
- オフラインで動作: インターネットアクセスなしでレンダリング可能
- 単一ファイル: 各図は1つの
.htmlファイル - ブラウザネイティブ: 標準のHTML5、CSS3、SVG、およびバニラES6+ JavaScriptのみ
- LLMフレンドリー: DIAGRAM JSONは整形され、改行を含む見やすい形式であること
自己メンテナンス
図を作成する際に便利なパターン、新しいレイアウトのコツ、特定の目的に適した色、レンダリングの改善点などを発見した場合は、このスキルファイルを更新して含めてください。スキルを正確で実用的な状態に保ってください。