sf-datacloud-harmonize: Data Cloud Harmonize Phase

このスキルは、ユーザーがスキーマ調和と統合作業を必要とする場合に使用します: DMO、フィールドマッピング、関連付け、アイデンティティ解決、統一プロファイル、データグラフ、またはユニバーサル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、または search-index ワークフローを実行中 → sf-datacloud-retrieve

---

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

以下を質問するか推測します:

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

---

コア運用ルール

• マッピングを作成する前に 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 を使用します。
• アイデンティティ解決の実行は非同期として扱い、実行後に結果を確認します。
• 統一プロファイルの作業を 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