mcpField
S
sf-datacloud-segment

sf-datacloud-segment

github.com/jaganproデータ・データベース424975 回インストール26 週間前に更新
リポジトリ

sf-datacloud-segment について

sf-datacloud-segmentは、Salesforce Data Cloudのセグメントや計算インサイトを扱うスキルです。作成、公開、実行、検証、トラブルシューティングを支援し、変更前の準備状況確認を重視します。

主な機能

  1. 01セグメントの作成と確認
  2. 02計算インサイトの作成と実行
  3. 03公開後のメンバー数確認
  4. 04組織の準備状況確認
  5. 05SQLによる結果検証

活用シーン

  1. 01再利用可能なセグメントの作成
  2. 02公開したセグメントのメンバー数確認
  3. 03計算インサイトの実行と集計値の検証
  4. 04セグメントSQLの問題調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jaganpro/sf-skills --skill sf-datacloud-segment

インストール後、Claude Code で/sf-datacloud-segmentを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

CREDITS.md
LICENSE
README.md

詳細

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

セグメント、計算済みインサイト、公開ワークフロー、メンバー数、Data Cloud セグメント SQL のトラブルシューティングなど、オーディエンスやインサイトに関する作業が必要な場合に、このスキルを使用します。

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

次の作業には sf-datacloud-segment を使用します。

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

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

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

次の情報を質問するか、推測して把握します。

  • 対象の組織エイリアス
  • 統合 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 を使用します。
  • 公開や実行の手順が成功したと決めつけず、件数または SQL で検証します。
  • 読み取り可能なメンバー詳細が必要な場合は、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. 件数または SQL で検証する
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 task: <segment / calculated-insight>
Action: <create / publish / inspect / troubleshoot>
Target org: <alias>
Artifacts: <definition files / commands>
Verification: <member count / query result / publish state>
Next step: <act / retrieve / follow-up>

参考資料

コメント

Markdown 対応