Communitygithub.com

Flowy(AIネイティブ図スキル)

フローチャート、システム図、UIワイヤーフレーム/モックアップを作成、読み取り、更新するスキル。ユーザーがフロー図、アーキテクチャ図、UIスケッチ、機能のビジュアル設計、ワイヤーフレーム作成、プロセスマッピング、HTML図の作成、または「flowy」と指示した場合、あるいは既存のHTML図ファイルを参照・更新する場合に使用します。

Flowy(AIネイティブ図スキル) とは?

Flowyは、自己完結型のHTMLファイルとしてインタラクティブなSVG図を作成するAIエージェントスキルです。フローチャート、UIモックアップ、システムアーキテクチャ図など、あらゆるビジュアル設計タスクに対応します。このスキルはClaude Code、Cursor、CodexなどのAIエージェントで動作し、ドキュメントディレクトリ(`docs/diagrams/`)で管理されるHTMLファイルを生成・編集します。生成される図は、組み込みのCSS/JavaScriptとSVGのみで構成され、npmやCDNなどの外部依存が一切なく、ファイルをダブルクリックするだけでブラウザで表示・操作可能です。また、ズーム、パン、ノード選択、JSONダウンロードなどのインタラクティブ機能も標準装備されています。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/vandezand-ctrl/workflow-automation-skills/tree/HEAD/skills/flowy

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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図を作成または編集する前に:

  1. ${CLAUDE_SKILL_DIR}/references/html-template.htmlを読み、最新のレンダラーコードを確認する
  2. docs/diagrams/にある既存の図ファイルを一覧表示し、名前の衝突を避ける
  3. 既存の図を更新する場合は、まず読み込んでDIAGRAMオブジェクトを抽出する

スキーマ

各図は3つのフィールドを持つJavaScriptオブジェクトです:

{
  meta: { title, description, type, tags[], created, updated },
  nodes: [...],
  edges: [...]
}

meta

フィールド型必須備考
titlestringはい人間が読めるタイトル
descriptionstringいいえ図の説明
typestringはい"flowchart" または "ui-mockup"
tagsstring[]いいえ整理用
createdstringいいえISO日付(YYYY-MM-DD)
updatedstringいいえISO日付。作成/更新時に今日の日付を設定

nodes

フィールド型必須備考
idstringはい一意、スネークケース(例: "step1_upload")
typestringはい"box"、"circle"、"diamond"、"note"、"group"
labelstringはい図形に表示される主要テキスト
sublabelstringいいえホバーツールチップに表示される二次テキスト
position{ x, y }はいピクセル単位の左上隅
size{ width, height }はいピクセル単位の寸法
styleobjectいいえ下記ノードスタイルフィールドを参照
groupstringいいえ親グループノードのid(視覚的なグループ化のみ)

ノードスタイルフィールド: fill、stroke、strokeWidth、color(テキスト)、fontSize、borderRadius、opacity

edges

フィールド型必須備考
idstringはい一意(例: "e_upload_to_extract")
sourcestringはいソースノードid
targetstringはいターゲットノードid
labelstringいいえ矢印上のテキスト(例: "yes"、"error")
sourceHandlestringいいえ"top"、"right"、"bottom"(デフォルト)、"left"
targetHandlestringいいえ"top"(デフォルト)、"right"、"bottom"、"left"
styleobjectいいえ下記エッジスタイルフィールドを参照

エッジスタイルフィールド: 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)。他の全ノードの背後にレンダリング。ラベルは左上。低不透明度

エッジレンダリングルール

  1. ソース点を計算: ソースノードの指定されたハンドル側の中心(デフォルト: 下)
  2. ターゲット点を計算: ターゲットノードの指定されたハンドル側の中心(デフォルト: 上)
  3. ハンドル方向に50pxオフセットした制御点を持つ3次ベジェ曲線(Cコマンド)を描画
  4. SVG <marker>定義を使用して矢印を追加
  5. strokeDasharrayが設定されている場合は破線としてレンダリング
  6. labelが存在する場合は、ベジェ曲線の中点に小さな白い背景矩形とともにレンダリング

レイアウトルール

フロー方向

  • フローチャート: 上から下(デフォルト)
  • UIモックアップ: グループコンテナ内は上から下、注釈は右側

間隔

  • ノード中心間の垂直方向最小70px
  • 並列ノード間の水平方向最小60px
  • グループパディング: グループ境界内側40px

判断ダイアモンド

  • 左分岐 = 主要 / yes パス
  • 右分岐 = 二次 / no / error パス

エラー/警告ノート

  • メインフローの右側に配置
  • 破線の赤いエッジで接続(strokeDasharray: "6,3"、stroke: #991b1b)

標準サイズ

タイプ幅高さ
box20050
circle9040
diamond12060
note18044

カラーパレット

目的塗りつぶし枠線テキスト
アクション#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)

  1. ズーム: マウスホイールでSVG viewBoxを拡大縮小。範囲: 0.2倍〜5倍。カーソル位置に向かってズーム。
  2. パン: 空のキャンバスをクリック&ドラッグでviewBoxを移動。
  3. ホバー: ノードにカーソルを合わせると、そのsublabelがカーソル近くのツールチップに表示される。
  4. クリック: ノードをクリックするとハイライト表示(青枠)され、接続されたすべてのエッジもハイライト。空スペースをクリックで選択解除。
  5. ズームにフィット: ボタンが全ノードのバウンディングボックスを計算し、60pxのパディングを付けてviewBoxを設定。
  6. JSONダウンロード: DIAGRAMオブジェクトを整形JSONとしてシリアル化し、ファイルダウンロードをトリガー。

新しい図の作成

ユーザーが新しいフローチャートやUIモックアップを依頼した場合:

  1. テンプレートを読む: HTMLテンプレートリファレンスファイルを読み、最新のレンダラーコードを取得する
  2. リクエストを分析する: ノード(ステップ、判断、エラー)とエッジ(接続)を特定する
  3. レイアウトルール(上から下のグリッド、標準間隔)を使用して位置を割り当てる
  4. カラーパレット(開始/終了 = 緑、判断 = 琥珀、エラー = 赤など)を使用して色を適用する
  5. 完全なHTMLファイルを生成する: テンプレート構造をコピーし、DIAGRAMオブジェクトを新しいデータで置き換える
  6. docs/diagrams/{kebab-case-name}.htmlに保存する
  7. ユーザーに伝える: 「ブラウザで docs/diagrams/{name}.html を開いて図を表示してください。」

ファイル命名

  • 場所: docs/diagrams/{name}.html
  • 形式: kebab-case.html(例: docs/diagrams/upload-flow.html、docs/diagrams/checkout-screen.html)
  • meta.updatedを今日のISO日付に設定する

既存の図の更新

ユーザーが図の変更を依頼した場合:

  1. 既存のHTMLファイルを読み込む
  2. <script>ブロックからDIAGRAMオブジェクトを抽出する
  3. リクエストに従ってノード/エッジを変更する
  4. meta.updatedを今日の日付に更新する
  5. 更新されたデータで完全なHTMLファイルを再生成する(最新のレンダラーを取得するためテンプレートを再読込)
  6. 同じパスに保存する

図の読み取り

図の分析や説明を求められた場合:

  1. HTMLファイルを読み込む
  2. const DIAGRAM = { ... };ブロックを見つける
  3. ノードをタイプとラベル別に一覧表示する
  4. エッジを辿り、自然言語でフローを説明する
  5. 判断点とその分岐を強調する

例

「ログインフローのフローチャートを作成して」

アクション: 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は整形され、改行を含む見やすい形式であること

自己メンテナンス

図を作成する際に便利なパターン、新しいレイアウトのコツ、特定の目的に適した色、レンダリングの改善点などを発見した場合は、このスキルファイルを更新して含めてください。スキルを正確で実用的な状態に保ってください。

関連スキル