ワークフロービジュアライザー は何をしますか?
誰かがワークフローを詳細に理解したいとき、文章だけでは不十分です。プロセスには順序、引き継ぎ、決定、待ち時間があります。適切な図はそれらを一目で読み取れるようにします。長いテキスト回答を置き換えるものであり、それに追加するものではありません。
形状は自由に選ばれます。タイムラインも他の図も優先順位はありません。ワークフローの構造が決定します。
このスキルが適用される場合
次の2つの条件がそろったとき:
- コンテキストがワークフロー、プロセス、または手順である(ユーザー自身のもの、議論されたもの、または最初から説明する必要があるもの)。
- ユーザーがより深い情報を求めている:「詳細に」「より正確に」「ステップバイステップ」「もう一度説明して」「どう機能するのか」。
「ワークフロー」という言葉が単に言及されただけで、簡単に回答できる質問であれば、チャットで簡潔に返答してください。重要でない言及のたびに図を作成すると価値が下がります。
手順
- プロセスを明確にする。 会話、ファイル、またはユーザーが指定したソースからプロセスを取得します。重要なものが不足している場合は、一度だけ簡潔に質問します。手順、期間、ツールをでっち上げないでください。未確認のものは「オープン」とマークします。
- 構造を読み、形状を選択する。 次のセクションを参照してください。どの形状を選び、その理由をチャットで一文で述べます。ユーザーは一言で却下できます。
- アウトラインを作成する。 合計4〜10ステップ、2〜4のフェーズまたはレーンにグループ化します。それ以上だと図が散漫になります。代わりにサブプロセスを要約します。
- 各ステップを埋める。
- 時間マーカーまたは位置:実際の期間、時点、または順序(「ステップ3」)。推測された時刻は使用不可。
- 凡例からのシンボル。
- タイトル(名詞、短く)と、何が行われ、なぜかについて1〜2文。
- オプションの 重要 ボックス:情報がプロセスを左右する場合のみ(前提条件、エラー原因、承認)。
- オプションの 具体例 ボックス:抽象的なステップを理解可能にする具体的なイメージ、例、または類推。イメージは説明するものであり、装飾ではありません。
- 凡例を作成する。 図に登場するシンボルのみと、選択した形状の要素。凡例は上部に配置します。
- ページとして提供する。
assets/base-template.html(トークン、ヘッダー、凡例、ボックス)から構築し、references/shapes.mdに従って選択した形状の構造を追加します。フローチャートについてはassets/flowchart-example.htmlに完成した例があります。そのCSSを再利用し、内容を置き換えます。ページのタイトルはワークフローの名前にします(例:「文書承認フロー」)。環境がページやアーティファクトを公開できる場合はそこに公開し、そうでない場合は単一の自己完結型HTMLファイルとして提供します。 - チャットで返信する。 1〜2文:選択した形状とその理由、および未解決のポイント。図の内容を繰り返さないでください。
形状の選択
最初にワークフローの構造を読み、その後で決定します。以下の質問が役立ちます:
- 結果がループに戻る決定や、パスが再び合流する決定があり、読者が指でパスを追跡できる必要があるか?→ フローチャート
- 決定でパスが分岐し、戻らずに異なる場所で終了するか?→ 分岐
- 複数の人、ツール、または役割がプロセスの一部を担当し、引き継ぎが難しく、ループがないか?→ レーン
- プロセスが最後のステップの後で変更されずに再開するか、または結果が次の実行にフィードされ、間に決定がないか?→ サイクル
- 複数の並行ストランドが同時に実行され、どこかで合流する必要があるか?→ パラレルトラック
- プロセスが本質的に時間の経過に伴う一連のステップであり、待ち時間、期限、または期間が重要か?→ タイムライン
- ワークフローが複数の特性を混在させているか?読者が最も間違えやすいものを選びます。副次的な特性は情報ボックスまたは場所タグになります。フローチャートは、レーンを必要とせずにステップがどこで行われるかを示せます。
ループは形状を変更する最も一般的な理由です。情報ボックスに隠すと埋もれてしまい、それがまさに読者がつまずく箇所です。ループがある場合、たとえレーンやタイムラインが最初は適切に見えても、通常フローチャートが最も正直な形状です。
見た目や習慣で選択しないでください。構造に合わない形状はプロセスを偽ります。軸は選択肢を隠し、実際の引き継ぎがないレーンは装飾です。
各形状の正確な構築ルールは references/shapes.md にあります。選択した形状のセクションのみを読んでください。
シンボル
すべて角形、丸形はなし。形状はCSSで描画されるため、どこでも同じ外観になります。
| シンボル | 形状 | 意味 |
|---|---|---|
| アクション | 塗りつぶされた正方形 | 何かが行われたり生成されたりする |
| 決定 | 空の正方形 | ここでフローが分岐する |
| チェックポイント | 菱形 | チェック、承認、許可 |
| 引き継ぎ | 三角形 | 結果が人、ツール、またはフェーズに移動する |
| 待機 | 水平バー | 積極的に何も行われず、時間が経過する |
| オープン | 破線の正方形 | 情報が不足しているか未確認 |
ワークフローが本当に必要な場合にのみ、さらにシンボルを追加し、凡例で説明します。
スタイリング
テンプレートはニュートラルなデフォルトを提供します:暖かい紙の背景、ほぼ黒のインク、表面としてのみ使用される薄いアクセントカラー、システムフォント。すべての色は :root のトークンです。ユーザーがブランドやデザインシステムを持っている場合は、それらのトークンのみを変更し、構造を再スタイルしないでください。
- 紙を背景に、インクをタイトルに、グラファイトを本文に、静かな色合いを落ち着いた面に、ヘアラインをルールに。
- アクセントカラーは表面としてのみ使用し、テキストや線の色としては使用しません。その上のテキストは常にインク色です。ページごとに最大1つの大きなアクセントバンド。フェーズとレーンのタイトル下の小さなマーカーバー(10px)は繰り返し可能。
- 1つのフォントファミリー。階層はウェイトと文字間隔で表現。文字間隔は大文字のみ。
- シャドウ、グラデーション、角丸、絵文字、感嘆符なし。リストはインク色の四角を使用。接続は直線で直角、2pxインク。
- ページは紙の上で単一テーマを維持。すべての色は明示的に設定され、ライト/ダークUIでも同じように読み取れます。
- モバイルファースト、ページ全体の水平スクロールなし。より広くする必要があるもの(レーン)は、独自のコンテナ内でスクロールします。
新しい色、フォント、形状を考案しないでください。システムに不足がある場合は、ギャップを特定し、トークン内で解決します。
言語
図はユーザーが使用している言語で記述します。事実に基づき、名詞ベースで簡潔に。無駄な言葉やトレンド用語は避けます。説明は鮮明でありながら正確で、3つの弱いイメージよりも1つの強いイメージを。
提供前のチェックリスト
- 形状はワークフローの構造に従っており、チャットの文章にその理由が記載されている。
- すべてのループはパスとして描画され、テキストでのみ言及されていない。
- すべての時間表現は文書化されているか、順序のみとしてマークされている。
- 未確認のものには「オープン」シンボルが付いている。
- 図内のすべてのシンボルが凡例に表示され、それ以外のシンボルはない。
- アクセントカラーは表面としてのみ使用され、テキストや線の色としては使用されていない。
- テキストが端からはみ出していない(400px幅でも)。
- チャットテキストが図の内容を繰り返していない。