external-diagram-mermaid-generate

external-diagram-mermaid-generate：Salesforce 図の生成

ユーザーがテキストベースの図を必要としている場合に、このスキルを使用します。アーキテクチャ、OAuth、統合フロー、ERD、Agentforce の構造を示す Mermaid 図に加え、プレーンテキストとの互換性が重要な場合は ASCII の代替図も提供します。

対象範囲

対象

ユーザーが以下を求めている場合は、external-diagram-mermaid-generate を使用します。

• Mermaid の出力
• ASCII の代替図
• Markdown で扱いやすい形式のアーキテクチャ、シーケンス図、フローチャート、ERD
• ドキュメント、README、課題にそのまま掲載できる図

対象外 — 次のような要望は別のスキルに委ねます。

• Salesforce 以外のシステムのみ → より汎用的な図作成スキルを使用します
• ERD の作成前にオブジェクトを調査する場合 → platform-custom-object-generate または platform-custom-field-generate

---

対応する図の種類

種類	Mermaid の推奨形式	典型的な用途
OAuth／認証フロー	sequenceDiagram	Authorization Code、JWT、PKCE、Device Flow
ERD／データモデル	flowchart LR	オブジェクトの関係と共有コンテキスト
統合シーケンス	sequenceDiagram	リクエスト／レスポンスまたはイベントの連携
システム全体像	flowchart	高レベルのアーキテクチャ
ロール／アクセス階層	flowchart	ユーザー、プロファイル、権限
Agentforce の動作マップ	flowchart	エージェント → トピック → アクションの関係

---

事前に確認する必須コンテキスト

次の情報を尋ねるか、推測します。

• 図の種類
• 対象範囲と関係するエンティティ／システム
• 出力形式の希望：Mermaid のみ、ASCII のみ、または両方
• スタイルの希望：最小限、ドキュメント重視、またはプレゼンテーション向け
• ERD の場合：根拠として使用できる組織のメタデータがあるか

---

推奨ワークフロー

1. 適切な図の構成を選ぶ

• 時系列のやり取りには sequenceDiagram を使用します
• ERD や機能マップには flowchart LR を使用します
• 可能であれば、図ごとに主要なストーリーを1つに絞ります

2. データを収集する

ERD および根拠に基づく図の場合：

• 実際のスキーマ調査が必要な場合は、platform-custom-object-generate または platform-custom-field-generate を使用します
• 適切な場合は、ローカルのメタデータヘルパースクリプトを使用して件数や関係のコンテキストを確認します

3. まず Mermaid を生成する

次の点に留意します。

• 正確なラベル
• シンプルで読みやすいノードテキスト
• 一貫した関係の表記
• Markdown ビューアーで問題なく描画される、控えめなスタイル

4. 必要に応じて ASCII の代替図を追加する

ユーザーがターミナルとの互換性やプレーンテキストのドキュメントを求めている場合は、ASCII 版も提供します。

5. 図を簡潔に説明する

主要な関係、フローの方向、前提条件を説明します。

---

重要なルール

シーケンス図の場合

• 手順の順序が重要な場合は autonumber を使用します
• リクエストとレスポンスを明確に区別します
• プロトコルの詳細を示す注記は必要最小限にします

ERD の場合

• flowchart LR を優先します
• オブジェクトカードはシンプルに保ちます
• 関係を明確な矢印で示します
• ユーザーがフィールド単位の詳細を明示的に求めていない限り、フィールドを詰め込みすぎないようにします
• 読みやすさが向上する場合に限り、オブジェクトの種類ごとに色分けします

ASCII 出力の場合

• 横幅を適切に保ちます
• 矢印とボックスの位置を一貫して揃えます
• 装飾よりも読みやすさを優先します

---

出力形式

## <Diagram Title>

### Mermaid Diagram
```mermaid
<diagram>
```

### ASCII Fallback
```text
<ascii>
```

### Notes
- <key point>
- <assumption or limitation>

---

スキル間の連携

必要なもの	委任先	理由
実際のオブジェクト／項目の定義	platform-custom-object-generate / platform-custom-field-generate	根拠に基づいた ERD の生成
接続アプリの認証設定に関するコンテキスト	integration-connectivity-connected-app-configure	正確な OAuth フロー
Agentforce のロジックの可視化	agentforce-generate	信頼できる情報源に基づく動作の詳細
Flow の動作図	automation-flow-generate	実際の Flow ロジックに基づく

---

注意点

問題	解決策
Mermaid レンダラーが利用できない	ASCII の代替図を自動的に提供します。Mermaid ブロックには、レンダラーにコピーして貼り付けられる図が含まれていることも伝えてください
オブジェクトが多すぎて ERD が読みづらくなる	ドメイン（Sales、Service など）ごとにサブ図に分割し、本文中でリンクします
シーケンス図のステップ順が不明確	autonumber ディレクティブを使って、ステップの順序を明示します
OAuth フローのアクターがグラントタイプによって異なる	アクターの不一致を避けるため、生成前に該当するアセットテンプレートを確認します

---

参照ファイル一覧

規約とルール — 生成前に確認

• references/diagram-conventions.md — すべての図の種類に共通する一貫性ルール
• references/mermaid-reference.md — Mermaid 構文のクイックリファレンス
• references/usage-examples.md — 図の種類ごとの使用例

スタイル

• references/mermaid-styling.md — テーマ設定と注釈のパターン
• references/color-palette.md — 16 進数値付きの色覚多様性に配慮したパレット
• references/erd-conventions.md — ERD 固有のレイアウトと表記ルール

プレビュー

• references/preview-guide.md — ローカルで Mermaid をレンダリングする方法
• scripts/README.md — このスキルのすべてのスクリプトのセットアップと使用方法
• scripts/mermaid_preview.py — ライブリロード対応のプレビューサーバー。実行すると、ブラウザーで図をプレビューできます
• scripts/query-org-metadata.py — ERD の生成根拠となる組織のスキーマを照会します

OAuth フローテンプレート — OAuth 図の生成時に該当するテンプレートを読み込みます

• assets/oauth/authorization-code.md — Authorization Code グラント
• assets/oauth/authorization-code-pkce.md — モバイル／SPA 向け PKCE バリアント
• assets/oauth/jwt-bearer.md — サーバー間通信向け JWT Bearer
• assets/oauth/client-credentials.md — サービスアカウント向け Client Credentials
• assets/oauth/device-authorization.md — CLI／IoT 向け Device Flow
• assets/oauth/refresh-token.md — Refresh Token の更新フロー
• assets/oauth/user-agent-social-sign-on.md — User-Agent／ソーシャルサインオン

データモデル ERD テンプレート — ERD の生成時に該当するテンプレートを読み込んでください

• assets/datamodel/salesforce-erd.md — Salesforce の主要オブジェクト
• assets/datamodel/sales-cloud-erd.md — Sales Cloud のオブジェクト
• assets/datamodel/service-cloud-erd.md — Service Cloud のオブジェクト
• assets/datamodel/b2b-commerce-erd.md — B2B Commerce のオブジェクト
• assets/datamodel/campaigns-erd.md — キャンペーンとキャンペーンメンバーのモデル
• assets/datamodel/consent-erd.md — 同意およびプライバシー関連のオブジェクト
• assets/datamodel/files-erd.md — Files と ContentDocument のモデル
• assets/datamodel/forecasting-erd.md — 予測関連のオブジェクト
• assets/datamodel/fsl-erd.md — Field Service Lightning のオブジェクト
• assets/datamodel/party-model-erd.md — パーティモデルのオブジェクト
• assets/datamodel/quote-order-erd.md — 見積もりと注文のオブジェクト
• assets/datamodel/revenue-cloud-erd.md — Revenue Cloud のオブジェクト
• assets/datamodel/scheduler-erd.md — Scheduler のオブジェクト
• assets/datamodel/territory-management-erd.md — Territory Management のオブジェクト

その他の図のテンプレート

• assets/architecture/system-landscape.md — システムランドスケープの概要テンプレート
• assets/integration/api-sequence.md — API 呼び出しシーケンスのテンプレート
• assets/agentforce/agent-flow.md — Agentforce のエージェント → トピック → アクションのフロー
• assets/role-hierarchy/user-hierarchy.md — ロールと権限の階層テンプレート

---

出力要件

このスキルで各リクエストに対して作成する成果物：

• Mermaid コードブロック — GitHub、Confluence、または Mermaid 対応のレンダラーにそのまま貼り付けられるフェンス付きの ```mermaid ブロック
• ASCII 形式の代替図（リクエストされた場合、または Mermaid レンダラーが利用できない場合）— ボックスや矢印の文字を使ったテキストのみの図
• 簡潔な説明 — 図の主要な関係、フローの方向、前提条件や制限事項を示す箇条書き 2～5 項目
• ERD の場合：フィールドラベルと関係タイプの注釈を含むオブジェクトカード
• シーケンス図の場合：明確なアクターラベルと番号付きステップ（autonumber）

---

評価ガイド

スコア	意味
72–80	本番環境で使用できる図
60–71	明確で有用だが、多少の調整が必要
48–59	機能するが、さらに分かりやすくできる
35–47	構造の改善が必要
< 35	不正確または不完全