HTML図とデッキ
このスキル(Agent Skill:Claude Code、GitHub Copilotおよびその他のエージェントが読み込みます)は、2つの小型図ライブラリ、デッキエンジン、3つのテーマ、3つのテンプレートを提供します。各成果物は1つのHTMLファイルであり、GSAPがキャッシュされればオフラインで動作し、閲覧者のライトまたはダークテーマに従い、claude.aiアーティファクトとして公開できます。
| パス | 説明 |
|---|---|
lib/edgediagram.js | 宣言的SVGグラフ:zone、node、text、link(デフォルトで直交、矢印、ラベル、パケットフロー)、fan(1つのポイントから複数のノードに給電)、bindFocus、steps、および各ステップでのレイアウトチェック |
lib/edgesketch.js | グリッド上の手描き図:zone、box(テキストにフィット、垂直カラムと中央揃えバー)、arrow(直角、両矢印)、connect(ボックス間接続)、fan、text、およびEdgeSketch.check(任意のSVGのレイアウトチェック、斜め線や曲線も含む) |
lib/icons.js | window.EDGE_ICONS:24単位グリッド上の50個のラインアイコン(グリッド機器、コンピュート、トラスト、オペレーション) |
lib/edgedeck.js | EdgeDeck.run:1600×900のスライドステージ、スライドごとのステップ、キャプション、キーボード、スワイプ、#nリンク |
themes/*.css | 1つのトークン契約に基づくカラーとタイプのテーマ(ライト/ダーク):engineering(緑グレー上の青、Archivo NarrowとIBM Plex)、indigo(ラベンダーグレー上の藍色、Space GroteskとInter)、drafting(温かみのある紙上のティール、Barlow CondensedとSource Sans 3) |
templates/diagram.html | ステップ付きEdgeDiagram図、キャプション、前/次ボタン、ドットナビゲーション |
templates/sketch.html | 手描きEdgeSketch図:左から右へのゾーン、カラム、サービス、両矢印、凡例 |
templates/deck.html | タイトルスライドと、図が段階的に構築されるコンテンツスライド |
scripts/inline.py | ライブラリファイルとテーマをページにインライン化し、1ファイルとして公開可能にする。見つからないものがあると失敗する。 |
scripts/shot.sh | ヘッドレススクリーンショット(ライト/ダーク、任意の幅、指定クリック後、--onlyで1要素、--fullでページ全体)、および--check(ページ上のすべての図のレイアウトチェック) |
scripts/todrawio.sh | ビルド済みページの1つの図をdraw.ioファイルにエクスポート(EdgeDiagram図はリンク付き、手描きSVG図、HTML図) |
scripts/check_theme.py | テーマのWCAGコントラストをライト/ダークでチェックし、2つのダークブロックが一致することを確認する。 |
scripts/theme_from_design.py | DESIGN.mdファイル(ブランドの色とフォント)からテーマを作成する(ライト/ダーク、すべてのペアがコントラスト条件を満たす) |
scripts/test.sh | tests/内のテストを実行する。lib/、scripts/、themes/を変更した後に実行すること。 |
scripts/vendor.sh | ライブラリを別のプロジェクトにコピーする。--checkでそのコピーが最新かどうかを表示する。 |
references/api.md | 両ライブラリとデッキエンジンのすべてのオプション |
references/conventions.md | トークン、各トーンの意味、レイアウトルール、公開、実行すべきチェック |
examples/ci-canary-deck.html | ニュートラルなワークフロー(CI/CD、カナリアリリース)に関する完全な2スライドデッキ |
examples/isometric/ | 等角投影の階層図ジェネレーター(SGAMキューブ)、教訓を含む |
examples/design-md/DESIGN.md | テーマを作成するためのサンプルDESIGN.md(Harbor) |
ワークフロー
- 図が示すべき内容を決定します。 メカニズム、それが依存する部品、およびそれを明らかにする順序に名前を付けます。それを速く言い表す文は、図よりも優れています。
- ライブラリを選択します。 意味のある配線で接続された部品のグラフをステップごとに表示する:EdgeDiagram(
templates/diagram.html)。ボックスのグリッド、階層スタック、または左から右へのプラットフォームビューで、配置が意味を伝える:EdgeSketch(templates/sketch.html)。プレゼンテーション:templates/deck.html、スライドにいずれかのライブラリを使用。 - テンプレートを作業ディレクトリにコピーします。 例:
cp <skill>/templates/sketch.html ./my-figure.html。<script src>とテーマのパスが<skill>/lib/と<skill>/themes/を指すように修正するか、最後に--libと--themesを指定してinline.pyを実行します。 - グリッド上にレイアウトします。 viewBoxを選択し、次にゾーン、次にボックス(均等サイズ、均等ギャップ)、次に配線(下記のコネクタを参照)を配置します。互いに通信するボックスは同じ行または列に配置し、配線が一直線になるようにします。意味を持つリンクには
infoを付けます。オプションについてはreferences/api.mdを参照してください。 - ステップを記述します(EdgeDiagram)。 ステップ0は休止状態です。以降の各ステップは1つのアイデアを追加し、短いキャプションを持ちます。移動するデータには
flowsを使用し、ステップが過ぎ去ったものをdimまたはhideで示します。 - テーマを適用します。 ページは1つのテーマにリンクします(
<link rel="stylesheet" href="../themes/engineering.css">)。名前を変更することでテーマを切り替えられます。engineeringは密度の高い技術資料、indigoは製品とソフトウェアデリバリー、draftingは文書として読まれる提案や調査に適しています。各トーンの意味を維持します(references/conventions.md)。ブランドの外観が必要な場合は、DESIGN.mdからテーマを作成します:python3 <skill>/scripts/theme_from_design.py DESIGN.md -o themes/<name>.css(examples/design-md/DESIGN.mdはサンプルです)。手動では、テーマをコピーし、すべてのトークン名を保持し、値を変更し、scripts/check_theme.py themes/<name>.cssがパスするまで実行します。 - ビルド、チェック、確認:
python3 <skill>/scripts/inline.py my-figure.html > build/my-figure.html <skill>/scripts/shot.sh --check build/my-figure.html # すべての図;問題があればexit 1 <skill>/scripts/shot.sh --only '#my-fig' build/my-figure.html /tmp/f-light.png light 1280 <skill>/scripts/shot.sh --only '#my-fig' build/my-figure.html /tmp/f-dark.png dark 1280 <skill>/scripts/shot.sh build/my-figure.html /tmp/sN.png dark 1280 'for(var i=0;i<5;i++)document.getElementById("next").click()'--checkが報告するすべてを修正します。次にPNGを開き、グリッドから外れたボックス、衝突する矢印先端、混雑したラベルなど、チェックで見つからないものを修正し、幅420でも再度確認します。スクリーンショットはパケットを配線の開始付近で固定するため、実際のブラウザで動きを判断します。 - 求められた場合、編集可能なコピーを提供します。
<skill>/scripts/todrawio.sh build/my-figure.html <svg idまたはセレクタ> out.drawio "名前"は、ライトテーマで最終ステップの1つの図のdraw.ioファイルを書き出します。これは、モーション、ステップ、ツールチップ、およびrectとellipse以外の塗りつぶし形状を保持しないことを示します(いくつ省略したかを出力します)。 - 公開します。 インライン化されたファイルがページです:ファイルとして共有するか、コミットするか、またはClaude内でArtifactツールに渡します(同じパスまたはURLを再公開して更新します)。
コネクタ
配線は読者がたどるものなので、意図的である必要があります:
- 水平および垂直のみ。 斜めや曲線は絶対に使用しないでください。EdgeDiagramのリンクはデフォルトで
orthoです:routeは指定しないでください。'straight'は両端がすでに一直線にある場合のみ、'curve'はユーザーが明示的に要求した場合のみ使用します。EdgeSketchではs.arrow、s.connect、s.fanを使用します。これらは直角に曲がります。手書きのSVGでは、HとVのパスコマンドで配線を描き、角だけを丸めます。 - ボックスが向かい合っている場合は一直線にします。 位置(
t)を指定しないと、EdgeDiagramまたはs.connectは、2つのボックスがスパンを共有するときに両端を一直線に配置します。チェックで数ピクセルのジョギングが報告された場合は、端が揃うようにボックスを移動します。tを微調整しないでください。 - 1つのソースから複数のボックスに給電する場合は、ファンを使用します。
d.fan(id, {from: [src, 'bottom'], to: ['a', 'b', 'c']})またはs.fan(src, 'bottom', [a, b, c])は、幹線、直角のバス、各ボックスへの分岐線を描き、各接合点にドットを打ちます。複数のボックスが1つに給電する場合も、リストを入れ替えた({from: [[...], ...], to: [...]}または{into: true})同じファンです。 - 曲がりは少なく、交差は避けます。 各配線が最大2回曲がるように辺を選択します。辺を共有する配線は広げます(
'auto')。ボックスを迂回し、ボックスの中を通らないようにします。 shot.sh --checkは、傾いた線、曲線、ジョギングする配線を報告します。他の問題と同様に修正します。等角投影図など、意図的な例外はdata-route="free"でマークします。
ルール
- 他のライブラリは使用しないでください。cdnjsのGSAP 3はオプションです:これがない場合、各ステップは最終状態を表示します。
- すべての色はトークンから取得されるため、コンポーネントにリテラルカラーは含まれません。
infoを持つすべてのノード、ボックス、またはリンクはキーボードフォーカス可能です。SVGにはrole="img"と、図が主張する内容を述べるaria-labelが必要です。- 電話より広い図は、ページではなく、独自の
overflow-x: autoコンテナ内でスクロールします。 - 内部名、顧客名、住所は、共有されるページから除外します。