sf-datacloud: Salesforce Data Cloud オーケストレーター

ユーザーが単一の分離されたコマンドファミリーではなく、プロダクトレベルの Data Cloud ワークフロー ガイダンスを必要とする場合に、このスキルを使用してください：パイプライン設定、フェーズ間のトラブルシューティング、データ スペース、データ キット、またはタスクが Connect、Prepare、Harmonize、Segment、Act、Retrieve のいずれに属するかの判断。

このスキルは、sf-skills ハウス スタイルに意図的に従いながら、外部 sf data360 コマンド サーフェスをランタイムとして使用します。プラグインはこのリポジトリに含まれていません。

---

このスキルがタスクを担当する場合

以下の作業が含まれる場合、sf-datacloud を使用します：

• マルチフェーズ Data Cloud セットアップまたは修復
• データ スペース（sf data360 data-space *）
• データ キット（sf data360 data-kit *）
• ヘルス チェック（sf data360 doctor）
• CRM から統合プロファイルへのパイプライン設計
• 取り込み → 調和 → セグメンテーション → アクティベーションへの移動方法の決定
• ルート原因がまだ不明なフェーズ間トラブルシューティング

ユーザーが 1 つの領域に集中している場合は、フェーズ固有のスキルにデリゲートしてください：

フェーズ	このスキルを使用	典型的なスコープ
Connect	sf-datacloud-connect	接続、コネクタ、ソース検出
Prepare	sf-datacloud-prepare	データ ストリーム、DLO、変換、DocAI
Harmonize	sf-datacloud-harmonize	DMO、マッピング、ID 解決、データ グラフ
Segment	sf-datacloud-segment	セグメント、計算インサイト
Act	sf-datacloud-act	アクティベーション、アクティベーション ターゲット、データ アクション
Retrieve	sf-datacloud-retrieve	SQL、検索インデックス、ベクタル検索、非同期クエリ

ユーザーが以下を行っている場合は、ファミリー外にデリゲートしてください：

• セッション トレーシング / STDM テレメトリを抽出 → sf-ai-agentforce-observability
• CRM SOQL のみを作成 → sf-soql
• CRM ソース データをロード → sf-data
• 不足している CRM スキーマを作成 → sf-metadata
• ダウンストリーム Apex または Flow ロジックを実装 → sf-apex、sf-flow

---

最初に収集すべき必須コンテキスト

以下について質問するか推測してください：

• ターゲット org エイリアス
• プラグインが既にインストールされリンクされているかどうか
• ユーザーが設計ガイダンス、読み取り専用検査、またはライブ変更を望んでいるかどうか
• 関連するデータ ソース：CRM オブジェクト、外部データベース、ファイル取り込み、ナレッジなど
• 望ましい結果：統合プロファイル、セグメント、アクティベーション、ベクタル検索、分析、またはトラブルシューティング
• ユーザーがデフォルト データ スペースまたはカスタム データ スペースで作業しているかどうか
• org が既に scripts/diagnose-org.mjs で分類されているかどうか
• 現在失敗しているコマンド ファミリーがあるかどうか

プラグインの可用性または org の準備状況が不確実な場合は、以下から始めてください：

• references/plugin-setup.md
• references/feature-readiness.md
• scripts/verify-plugin.sh
• scripts/diagnose-org.mjs
• scripts/bootstrap-plugin.sh

---

コア動作ルール

• 外部 sf data360 プラグイン ランタイムを使用してください；コマンド レイヤーを再実装またはベンダリングしないでください。
• タスクがローカライズされたら、最小のフェーズ固有スキルを優先してください。
• 変更が多い作業の前に、準備状況の分類を実行してください。1 つの失敗したコマンドから推測するのではなく、scripts/diagnose-org.mjs を優先してください。
• sf data360 コマンドについては、stderr 出力がデバッグに必要な場合を除き、2>/dev/null でリンク プラグイン警告ノイズを抑制してください。
• Data Cloud SQL と CRM SOQL を区別してください。
• sf data360 doctor をフル プロダクト準備チェックとして扱わないでください；現在のアップストリーム コマンドは検索インデックス サーフェスのみをチェックします。
• query describe をユニバーサル テナント プローブとして扱わないでください；より広い準備状況が確認された後、既知の DMO/DLO テーブルでのみ使用してください。
• Data Cloud 固有の API バージョン回避策を、それらが重要な場合は保持してください。
• org 固有のワークショップ ペイロードではなく、汎用で再利用可能な JSON 定義ファイルを優先してください。

---

推奨ワークフロー

1. ランタイムと認証を確認する

以下を確認してください：

• sf がインストールされている
• Data Cloud コミュニティ プラグインがリンクされている
• ターゲット org が認証されている

推奨チェック：

sf data360 man
sf org display -o <alias>
bash ~/.claude/skills/sf-datacloud/scripts/verify-plugin.sh <alias>

sf data360 doctor を唯一のゲートではなく、広いヘルス シグナルとして扱ってください。部分的にプロビジョニングされた org では、コネクタ、DMO、またはセグメントなどの読み取り専用コマンド ファミリーがまだ機能している場合でも失敗する可能性があります。

2. 何かを変更する前に準備状況を分類する

共有分類器をまず実行してください：

node ~/.claude/skills/sf-datacloud/scripts/diagnose-org.mjs -o <org> --json

テーブル名が実在することがわかった後に限り、クエリプレーン プローブを使用してください：

node ~/.claude/skills/sf-datacloud/scripts/diagnose-org.mjs -o <org> --phase retrieve --describe-table MyDMO__dlm --json

分類器を使用して、以下を区別してください：

• 空だが有効なモジュール
• フィーチャー ゲート付きモジュール
• クエリプレーン の問題
• ランタイム/認証の失敗

3. 読み取り専用コマンドで既存状態を検出する

分類後、対象となる検査を使用してください：

sf data360 doctor -o <org> 2>/dev/null
sf data360 data-space list -o <org> 2>/dev/null
sf data360 data-stream list -o <org> 2>/dev/null
sf data360 dmo list -o <org> 2>/dev/null
sf data360 identity-resolution list -o <org> 2>/dev/null
sf data360 segment list -o <org> 2>/dev/null
sf data360 activation platforms -o <org> 2>/dev/null

4. フェーズをローカライズする

タスクをルーティングしてください：

• ソース/コネクタの問題 → Connect
• 取り込み/DLO/ストリームの問題 → Prepare
• マッピング/IR/統合プロファイルの問題 → Harmonize
• オーディエンスまたはインサイトの問題 → Segment
• ダウンストリーム プッシュの問題 → Act
• SQL/検索/インデックスの問題 → Retrieve

5. 可能な場合は決定論的なアーティファクトを選択する

ワンショットの手動ステップではなく、JSON 定義ファイルと反復可能スクリプトを優先してください。汎用テンプレートは以下に存在します：

• assets/definitions/data-stream.template.json
• assets/definitions/dmo.template.json
• assets/definitions/mapping.template.json
• assets/definitions/relationship.template.json
• assets/definitions/identity-resolution.template.json
• assets/definitions/data-graph.template.json
• assets/definitions/calculated-insight.template.json
• assets/definitions/segment.template.json
• assets/definitions/activation-target.template.json
• assets/definitions/activation.template.json
• assets/definitions/data-action-target.template.json
• assets/definitions/data-action.template.json
• assets/definitions/search-index.template.json

6. 各フェーズの後に検証する

典型的な検証：

• ストリーム/DLO が存在する
• DMO/マッピング が存在する
• ID 解決実行が完了した
• 統合レコードまたはセグメント数が正常に見える
• アクティベーション/検索インデックス ステータスが健全である

---

高信号なゴッチャ

• connection list には --connector-type が必要です。
• dmo list --all は完全なカタログが必要な場合に便利ですが、最初のページの dmo list は準備状況チェックで十分であり、はるかに高速です。
• セグメント作成には --api-version 64.0 が必要になる場合があります。
• segment members は不透明 ID を返します。人間が読める詳細については、SQL ジョインを使用してください。
• sf data360 doctor は、一部の読み取り専用コマンドがまだ機能している場合でも、部分的にプロビジョニングされた org で失敗する可能性があります。対象となるスモーク チェックにフォールバックしてください。
• query describe エラー（Couldn't find CDP tenant ID または DataModelEntity ... not found など）はクエリプレーン の手がかりであり、プロダクト全体が無効になっていない場合もあります。
• 多くの長時間実行ジョブは、コマンドが素早く復帰した場合でも、実際には非同期です。
• 一部の Data Cloud 操作には、CLI ランタイムの外で UI セットアップが必要です。

---

出力形式

終了時に、以下の順序でレポートしてください：

1. タスク分類
2. ランタイム ステータス
3. 準備状況分類
4. 関連フェーズ
5. 使用されたコマンドまたはアーティファクト
6. 検証結果
7. 次の推奨ステップ

推奨される形式：

Data Cloud task: <setup / inspect / troubleshoot / migrate>
Runtime: <plugin ready / missing / partially verified>
Readiness: <ready / ready_empty / partial / feature_gated / blocked>
Phases: <connect / prepare / harmonize / segment / act / retrieve>
Artifacts: <json files, commands, scripts>
Verification: <passed / partial / blocked>
Next step: <next phase, setup guidance, or cross-skill handoff>

---

クロススキル統合

必要事項	デリゲート先	理由
CRM ソース データをロードまたはクリーン	sf-data	取り込み前にソース レコードをシードまたは修正
不足している CRM スキーマを作成	sf-metadata	Data Cloud は既存のオブジェクト/フィールドを期待
権限またはバンドルをデプロイ	sf-deploy	環境準備
Data Cloud 出力に対して Apex を作成	sf-apex	コード実装
セグメンテーション/アクティベーション後の Flow 自動化	sf-flow	宣言型オーケストレーション
セッション トレーシング / STDM / parquet 分析	sf-ai-agentforce-observability	異なる Data Cloud ユースケース

---

リファレンス マップ

ここから始める

• README.md
• references/plugin-setup.md
• references/feature-readiness.md
• UPSTREAM.md

フェーズ スキル

• sf-datacloud-connect
• sf-datacloud-prepare
• sf-datacloud-harmonize
• sf-datacloud-segment
• sf-datacloud-act
• sf-datacloud-retrieve

決定論的ヘルパー

• scripts/bootstrap-plugin.sh
• scripts/verify-plugin.sh
• scripts/diagnose-org.mjs
• assets/definitions/