sf-datacloud-harmonize

sf-datacloud-harmonize: Data Cloud ハーモナイズフェーズ

ユーザーが スキーマのハーモナイズと統合に関する作業（DMO、項目マッピング、リレーション、ID 解決、統合プロファイル、データグラフ、ユニバーサル ID の検索）を必要とする場合に、このスキルを使用します。

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

次の作業を行う場合は、sf-datacloud-harmonize を使用します。

• sf data360 dmo *
• sf data360 identity-resolution *
• sf data360 data-graph *
• sf data360 profile *
• sf data360 universal-id lookup

次の場合は、別のスキルに委任します。

• ストリームの取り込み中、または DLO の構築中 → sf-datacloud-prepare
• セグメントのロジック、または計算済みインサイトの作業中 → sf-datacloud-segment
• SQL、describe、または検索インデックスのワークフローの実行中 → sf-datacloud-retrieve

---

最初に収集する必要があるコンテキスト

以下について尋ねるか、推測します。

• ソース DLO とターゲット DMO の名前
• タスクがスキーマ作成、マッピング、IR、グラフ関連のいずれか
• ターゲット組織のエイリアス
• ルールセットがすでに存在するかどうか
• ユーザーが希望する統合エンティティモデル

---

基本的な運用ルール

• マッピングを作成する前に、DMO スキーマを調べます。
• ハーモナイズアセットを変更する前に、共通の準備状況分類器を実行します。node ~/.claude/skills/sf-datacloud/scripts/diagnose-org.mjs -o <org> --phase harmonize --json
• カタログを参照する場合は dmo list --all を優先します。ただし、準備状況をすばやく確認する場合は、最初のページを返す dmo list を使用します。
• サポートされていない describe の手順を推測するのではなく、query describe または dmo get --json を使用します。
• ID 解決の実行は非同期として扱い、実行後に結果を確認します。
• 統合プロファイルの作業は、STDM／セッション追跡の作業と分けて行います。

---

推奨ワークフロー

1. ハーモナイズ作業の準備状況を分類する

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

2. カタログを調べる

sf data360 dmo list --all -o <org> 2>/dev/null
sf data360 identity-resolution list -o <org> 2>/dev/null

3. マッピングの前にスキーマを調べる

sf data360 query describe -o <org> --table ssot__Individual__dlm 2>/dev/null
sf data360 dmo get -o <org> --name ssot__Individual__dlm --json 2>/dev/null

4. 意図を明確にしてマッピングを作成または確認する

sf data360 dmo mapping-list -o <org> --source Contact_Home__dll --target ssot__Individual__dlm 2>/dev/null
sf data360 dmo map-to-canonical -o <org> --dlo Contact_Home__dll --dmo ssot__Individual__dlm --dry-run 2>/dev/null

5. マッピングの信頼性を確認してから IR を実行する

sf data360 identity-resolution create -o <org> -f ir-ruleset.json 2>/dev/null
sf data360 identity-resolution run -o <org> --name Main 2>/dev/null

---

特に注意すべき点

• 通常、dmo list では --all を使用します。
• query describe または dmo get --json を使用します。dmo describe コマンドはありません。
• マッピングや関連コマンドは、API バージョンの違いに影響されることがあります。
• 統合 DMO の名前は汎用ではなく、ルールセットごとに異なります。
• データグラフの定義は、項目の選択とリレーションの形状に左右されます。
• dmo list は機能するものの identity-resolution list が制限される場合は、Data Cloud 全体の障害ではなく、フェーズ固有の制約として扱います。

---

出力形式

Harmonize task: <dmo / mapping / relationship / ir / data-graph>
Source/target: <dlo → dmo or ruleset/graph names>
Target org: <alias>
Artifacts: <json files / commands>
Verification: <passed / partial / blocked>
Next step: <segment / retrieve / follow-up>

---

参考資料

• README.md
• ../sf-datacloud/assets/definitions/dmo.template.json
• ../sf-datacloud/assets/definitions/mapping.template.json
• ../sf-datacloud/assets/definitions/relationship.template.json
• ../sf-datacloud/assets/definitions/identity-resolution.template.json
• ../sf-datacloud/assets/definitions/data-graph.template.json
• ../sf-datacloud/references/feature-readiness.md