Communitygithub.com

ワークフロービジュアライザー

ワークフロー、プロセス、手順を詳細に説明するビジュアルページ(シンボル凡例、情報ボックス、具体的な説明)を生成し、プロセスの構造に基づいて図の形状を選択します。ユーザーが「もっと詳しく」「ステップバイステップ」「どう機能するのか」などを求める際に使用します。

ワークフロービジュアライザー とは?

ワークフロービジュアライザーは、ワークフローやプロセスを詳細に説明するビジュアルページを生成するスキルです。単なるテキストでの説明ではなく、シンボル凡例、情報ボックス、具体的な説明を備えた図を作成し、プロセスの構造に基づいて最適な図の形状(フローチャート、分岐、レーン、サイクル、パラレルトラック、タイムラインなど)を自動選択します。このスキルは、Claude Codeを含むAIエージェント環境で動作し、ユーザーが「もっと詳しく」「ステップバイステップ」「どのように機能するか」などの詳細を求めた場合に特に有効です。事前に定義されたアセットテンプレートと形状参照ファイルを使用し、一貫性のあるスタイル(紙背景、インク色、無地のアクセントカラー、角のないシンボル)でHTMLページを生成します。ループ構造を適切に可視化し、未検証の情報には「オープン」シンボルを付けるなど、正確性を重視します。アクセントカラーは表面としてのみ使用し、テキストや線には使わないなど、厳格なスタイルガイドに従います。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jirispataart-deve/workflow-visualizer/tree/HEAD

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

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

ドキュメント

ワークフロービジュアライザー は何をしますか?

誰かがワークフローを詳細に理解したいとき、文章だけでは不十分です。プロセスには順序、引き継ぎ、決定、待ち時間があります。適切な図はそれらを一目で読み取れるようにします。長いテキスト回答を置き換えるものであり、それに追加するものではありません。

形状は自由に選ばれます。タイムラインも他の図も優先順位はありません。ワークフローの構造が決定します。

このスキルが適用される場合

次の2つの条件がそろったとき:

  1. コンテキストがワークフロー、プロセス、または手順である(ユーザー自身のもの、議論されたもの、または最初から説明する必要があるもの)。
  2. ユーザーがより深い情報を求めている:「詳細に」「より正確に」「ステップバイステップ」「もう一度説明して」「どう機能するのか」。

「ワークフロー」という言葉が単に言及されただけで、簡単に回答できる質問であれば、チャットで簡潔に返答してください。重要でない言及のたびに図を作成すると価値が下がります。

手順

  1. プロセスを明確にする。 会話、ファイル、またはユーザーが指定したソースからプロセスを取得します。重要なものが不足している場合は、一度だけ簡潔に質問します。手順、期間、ツールをでっち上げないでください。未確認のものは「オープン」とマークします。
  2. 構造を読み、形状を選択する。 次のセクションを参照してください。どの形状を選び、その理由をチャットで一文で述べます。ユーザーは一言で却下できます。
  3. アウトラインを作成する。 合計4〜10ステップ、2〜4のフェーズまたはレーンにグループ化します。それ以上だと図が散漫になります。代わりにサブプロセスを要約します。
  4. 各ステップを埋める。
    • 時間マーカーまたは位置:実際の期間、時点、または順序(「ステップ3」)。推測された時刻は使用不可。
    • 凡例からのシンボル。
    • タイトル(名詞、短く)と、何が行われ、なぜかについて1〜2文。
    • オプションの 重要 ボックス:情報がプロセスを左右する場合のみ(前提条件、エラー原因、承認)。
    • オプションの 具体例 ボックス:抽象的なステップを理解可能にする具体的なイメージ、例、または類推。イメージは説明するものであり、装飾ではありません。
  5. 凡例を作成する。 図に登場するシンボルのみと、選択した形状の要素。凡例は上部に配置します。
  6. ページとして提供する。 assets/base-template.html(トークン、ヘッダー、凡例、ボックス)から構築し、references/shapes.md に従って選択した形状の構造を追加します。フローチャートについては assets/flowchart-example.html に完成した例があります。そのCSSを再利用し、内容を置き換えます。ページのタイトルはワークフローの名前にします(例:「文書承認フロー」)。環境がページやアーティファクトを公開できる場合はそこに公開し、そうでない場合は単一の自己完結型HTMLファイルとして提供します。
  7. チャットで返信する。 1〜2文:選択した形状とその理由、および未解決のポイント。図の内容を繰り返さないでください。

形状の選択

最初にワークフローの構造を読み、その後で決定します。以下の質問が役立ちます:

  • 結果がループに戻る決定や、パスが再び合流する決定があり、読者が指でパスを追跡できる必要があるか?→ フローチャート
  • 決定でパスが分岐し、戻らずに異なる場所で終了するか?→ 分岐
  • 複数の人、ツール、または役割がプロセスの一部を担当し、引き継ぎが難しく、ループがないか?→ レーン
  • プロセスが最後のステップの後で変更されずに再開するか、または結果が次の実行にフィードされ、間に決定がないか?→ サイクル
  • 複数の並行ストランドが同時に実行され、どこかで合流する必要があるか?→ パラレルトラック
  • プロセスが本質的に時間の経過に伴う一連のステップであり、待ち時間、期限、または期間が重要か?→ タイムライン
  • ワークフローが複数の特性を混在させているか?読者が最も間違えやすいものを選びます。副次的な特性は情報ボックスまたは場所タグになります。フローチャートは、レーンを必要とせずにステップがどこで行われるかを示せます。

ループは形状を変更する最も一般的な理由です。情報ボックスに隠すと埋もれてしまい、それがまさに読者がつまずく箇所です。ループがある場合、たとえレーンやタイムラインが最初は適切に見えても、通常フローチャートが最も正直な形状です。

見た目や習慣で選択しないでください。構造に合わない形状はプロセスを偽ります。軸は選択肢を隠し、実際の引き継ぎがないレーンは装飾です。

各形状の正確な構築ルールは references/shapes.md にあります。選択した形状のセクションのみを読んでください。

シンボル

すべて角形、丸形はなし。形状はCSSで描画されるため、どこでも同じ外観になります。

シンボル形状意味
アクション塗りつぶされた正方形何かが行われたり生成されたりする
決定空の正方形ここでフローが分岐する
チェックポイント菱形チェック、承認、許可
引き継ぎ三角形結果が人、ツール、またはフェーズに移動する
待機水平バー積極的に何も行われず、時間が経過する
オープン破線の正方形情報が不足しているか未確認

ワークフローが本当に必要な場合にのみ、さらにシンボルを追加し、凡例で説明します。

スタイリング

テンプレートはニュートラルなデフォルトを提供します:暖かい紙の背景、ほぼ黒のインク、表面としてのみ使用される薄いアクセントカラー、システムフォント。すべての色は :root のトークンです。ユーザーがブランドやデザインシステムを持っている場合は、それらのトークンのみを変更し、構造を再スタイルしないでください。

  • 紙を背景に、インクをタイトルに、グラファイトを本文に、静かな色合いを落ち着いた面に、ヘアラインをルールに。
  • アクセントカラーは表面としてのみ使用し、テキストや線の色としては使用しません。その上のテキストは常にインク色です。ページごとに最大1つの大きなアクセントバンド。フェーズとレーンのタイトル下の小さなマーカーバー(10px)は繰り返し可能。
  • 1つのフォントファミリー。階層はウェイトと文字間隔で表現。文字間隔は大文字のみ。
  • シャドウ、グラデーション、角丸、絵文字、感嘆符なし。リストはインク色の四角を使用。接続は直線で直角、2pxインク。
  • ページは紙の上で単一テーマを維持。すべての色は明示的に設定され、ライト/ダークUIでも同じように読み取れます。
  • モバイルファースト、ページ全体の水平スクロールなし。より広くする必要があるもの(レーン)は、独自のコンテナ内でスクロールします。

新しい色、フォント、形状を考案しないでください。システムに不足がある場合は、ギャップを特定し、トークン内で解決します。

言語

図はユーザーが使用している言語で記述します。事実に基づき、名詞ベースで簡潔に。無駄な言葉やトレンド用語は避けます。説明は鮮明でありながら正確で、3つの弱いイメージよりも1つの強いイメージを。

提供前のチェックリスト

  • 形状はワークフローの構造に従っており、チャットの文章にその理由が記載されている。
  • すべてのループはパスとして描画され、テキストでのみ言及されていない。
  • すべての時間表現は文書化されているか、順序のみとしてマークされている。
  • 未確認のものには「オープン」シンボルが付いている。
  • 図内のすべてのシンボルが凡例に表示され、それ以外のシンボルはない。
  • アクセントカラーは表面としてのみ使用され、テキストや線の色としては使用されていない。
  • テキストが端からはみ出していない(400px幅でも)。
  • チャットテキストが図の内容を繰り返していない。

関連スキル