sf-diagram-mermaid: Salesforce ダイアグラム生成

このスキルは、ユーザーがテキストベースのダイアグラムを必要としている場合に使用します。アーキテクチャ、OAuth、統合フロー、ERD、またはAgentforceの構造のためのMermaidダイアグラムと、プレーンテキスト互換性が必要な場合はASCIIフォールバックを提供します。

このスキルが対応するタスク

以下の場合にsf-diagram-mermaidを使用してください：

• Mermaid出力
• ASCIIフォールバックダイアグラム
• マークダウン対応形式のアーキテクチャ、シーケンス、フローチャート、またはERDビュー
• ドキュメント、README、またはissueに直接埋め込めるダイアグラム

以下の場合は別のスキルに委譲してください：

• レンダリング済みPNG/SVG画像または洗練されたモックアップが必要 → sf-diagram-nanobananapro
• Salesforce以外のシステムのみ → より一般的なダイアグラミングスキルを使用
• ERDの前にオブジェクト検出が必要 → sf-metadata

---

サポートされているダイアグラムファミリー

タイプ	推奨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を使用
• 可能な限り、単一の主要なストーリーをダイアグラムごとに保つ

2. データを収集

ERDとグラウンドダイアグラムの場合：

• 実際のスキーマ検出が必要な場合はsf-metadataを使用
• 必要に応じてローカルメタデータヘルパースクリプトを使用してカウント / 関連文脈を取得

3. Mermaidを最初に生成

以下を適用：

• 正確なラベル
• シンプルで読みやすいノードテキスト
• 一貫した関連付け表記
• マークダウンビューアで清潔にレンダリングされる抑制されたスタイリング

4. 便利な場合はASCIIフォールバックを追加

ユーザーがターミナル互換性またはプレーンテキストドキュメントが必要な場合、ASCIIバージョンを提供します。

5. ダイアグラムを簡潔に説明

主要な関連、フロー方向、および仮定を指摘します。

---

高い信号価値のルール

シーケンスダイアグラムの場合

• ステップの順序が重要な場合はautonumberを使用
• リクエストとレスポンスを明確に区別
• プロトコル詳細のためにnoteはスパースに使用

ERDの場合

• flowchart LRを推奨
• オブジェクトカードはシンプルに保つ
• 明確な関連矢印を使用
• ユーザーが明示的にフィールドレベルの詳細を要求しない限り、フィールドオーバーロードを回避
• オブジェクトタイプの色分けは可読性が向上する場合のみ実施

ASCIIの場合

• 幅は適切に保つ
• 矢印とボックスを一貫して整列
• 装飾より読みやすさを最適化

---

出力形式

## <ダイアグラムタイトル>

### Mermaidダイアグラム
```mermaid
<diagram>
```

### ASCIIフォールバック
```text
<ascii>
```

### 注記
- <キーポイント>
- <仮定または制限>

---

クロススキル統合

必要事項	委譲先	理由
実際のオブジェクト / フィールド定義	sf-metadata	グラウンドERD生成
レンダリングされたダイアグラム / 画像出力	sf-diagram-nanobananapro	Mermaid以上のビジュアル洗練
Connected App認証セットアップコンテキスト	sf-connected-apps	正確なOAuthフロー
Agentforceロジック可視化	sf-ai-agentscript	ソースオブトゥルース動作詳細
Flow動作ダイアグラム	sf-flow	実際のFlow論理グラウンディング

---

リファレンスマップ

はじめにこちら

• references/diagram-conventions.md
• references/mermaid-reference.md
• references/usage-examples.md

スタイリング / ERD仕様

• references/mermaid-styling.md
• references/color-palette.md
• references/erd-conventions.md

プレビュー

• references/preview-guide.md
• scripts/mermaid_preview.py
• scripts/query-org-metadata.py

---

スコアガイド

スコア	意味
72–80	本番環境対応ダイアグラム
60–71	明確で有用だが、軽い修正が残っている
48–59	機能的だが、より明確にできる
35–47	構造的な改善が必要
< 35	不正確または不完全