sf-datacloud-segment: Data Cloud セグメント フェーズ

ユーザーがオーディエンスとインサイト作業を必要とするときにこのスキルを使用します: セグメント、計算インサイト、公開ワークフロー、メンバー数、または Data Cloud セグメント SQL のトラブルシューティング。

このスキルがタスクを所有する場合

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

• sf data360 segment *
• sf data360 calculated-insight *
• セグメント公開ワークフロー
• メンバー数とセグメントのトラブルシューティング
• 計算インサイトの実行と検証

ユーザーが以下を行っている場合は他にデリゲートします:

• DMO、マッピング、または ID 解決をまだ構築している → sf-datacloud-harmonize
• セグメントをダウンストリームでアクティベートしている → sf-datacloud-act
• 読み取り専用 SQL または検索インデックス クエリを記述している → sf-datacloud-retrieve

---

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

以下を確認または推測します:

• ターゲット オーグ エイリアス
• 統一 DMO またはベース エンティティ名
• ユーザーが作成、公開、検査、またはトラブルシューティングを望んでいるかどうか
• アセットがセグメントか計算インサイトか
• 期待される成功指標: メンバー数、集計値、または公開状態

---

主要な操作ルール

• Data Cloud セグメント SQL を CRM SOQL と区別して扱う
• オーディエンス アセットを更新する前に共有の準備状況分類器を実行する: node ~/.claude/skills/sf-datacloud/scripts/diagnose-org.mjs -o <org> --phase segment --json
• 再現可能なセグメントと CI 作成のために再利用可能な JSON 定義を優先する
• セグメント作成動作が新しいデフォルトで不安定な場合、--api-version 64.0 を使用する
• 成功を想定するのではなく、公開/実行ステップ後に数またはクエリで検証する
• 読み取り可能なメンバー詳細が必要な場合、segment members ではなく SQL 結合を使用する

---

推奨ワークフロー

1. セグメント作業の準備状況を分類

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

2. 現在の状態を検査

sf data360 segment list -o <org> 2>/dev/null
sf data360 calculated-insight list -o <org> 2>/dev/null

3. 再利用可能な JSON 定義で作成

sf data360 segment create -o <org> -f segment.json --api-version 64.0 2>/dev/null
sf data360 calculated-insight create -o <org> -f ci.json 2>/dev/null

4. 明示的に公開または実行

sf data360 segment publish -o <org> --name My_Segment 2>/dev/null
sf data360 calculated-insight run -o <org> --name Lifetime_Value 2>/dev/null

5. 数またはクエリで検証

sf data360 segment count -o <org> --name My_Segment 2>/dev/null
sf data360 query sql -o <org> --sql 'SELECT COUNT(*) FROM "UnifiedssotIndividualMain__dlm"' 2>/dev/null

---

信号値の高い落とし穴

• セグメント作成には --api-version 64.0 が必要な場合があります
• segment members は不透明 ID を返します。人間が読める形のメンバー詳細が必要な場合は SQL 結合を使用します
• セグメント SQL は SOQL ではありません
• 計算インサイト アセットとセグメント SQL には異なる制限があります
• コマンドが迅速に返される場合でも、公開/実行ステップは非同期作業を開始できます
• セグメントまたは計算インサイト リストが空の場合は、通常、モジュールに到達可能だが未構成であることを意味し、利用不可ではありません

---

出力形式

セグメント タスク: <segment / calculated-insight>
アクション: <create / publish / inspect / troubleshoot>
ターゲット オーグ: <alias>
アーティファクト: <definition files / commands>
検証: <member count / query result / publish state>
次のステップ: <act / retrieve / follow-up>

---

参考資料

• README.md
• ../sf-datacloud/assets/definitions/calculated-insight.template.json
• ../sf-datacloud/assets/definitions/segment.template.json
• ../sf-datacloud/references/feature-readiness.md
• ../sf-datacloud/UPSTREAM.md