sf-datacloud-act について
sf-datacloud-actは、Salesforce Data Cloudの下流配信を扱うスキルです。セグメントのアクティベーション、ターゲット、データアクションを対象とし、設定前の確認と配信状況の検証を支援します。
主な機能
- 01アクティベーション基盤とターゲットの確認
- 02ターゲットとデータアクション先の作成
- 03アクティベーションとデータアクションの作成
- 04下流配信状況の検証
- 05変更前の準備状況確認
活用シーン
- 01公開済みセグメントの下流アクティベーション
- 02アクティベーション用ターゲットの設定
- 03Data Cloudの出力を下流システムへ配信
- 04アクティベーションやデータアクションの配信確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ jaganpro/ sf-skills --skill sf-datacloud-actインストール後、Claude Code で/sf-datacloud-actを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
CREDITS.mdLICENSEREADME.md詳細
sf-datacloud-act:Data Cloud Act フェーズ
ユーザーが下流への配信作業(アクティベーション、アクティベーションターゲット、データアクション、または Data Cloud の出力を他のシステムに送信すること)を必要としている場合に、このスキルを使用します。
このスキルが担当するタスク
次の作業を含む場合は、sf-datacloud-act を使用します。
sf data360 activation *sf data360 activation-target *sf data360 data-action *sf data360 data-action-target *- 下流への配信設定の検証
ユーザーが次の作業をしている場合は、別のスキルに委任します。
- オーディエンスまたはインサイトをまだ構築している → sf-datacloud-segment
- クエリ/検索または検索インデックスを調査している → sf-datacloud-retrieve
- 基本接続または取り込みを設定している → sf-datacloud-connect、sf-datacloud-prepare
最初に収集する必須コンテキスト
次の情報を尋ねるか、推測します。
- 対象の組織エイリアス
- 配信先プラットフォームまたは下流システム
- セグメントがすでに存在し、公開済みかどうか
- ユーザーが作成、確認、更新、削除のどれを必要としているか
- タスクがアクティベーション中心か、データアクション中心か
基本的な運用ルール
- 下流への配信アセットを作成する前に、上流のセグメントまたはインサイトが正常な状態であることを確認します。
- アクティベーションアセットを変更する前に、共通の準備状況分類器を実行します:
node ~/.claude/skills/sf-datacloud/scripts/diagnose-org.mjs -o <org> --phase act --json。 - アクティベーション設定を変更する前に、利用可能なプラットフォームとターゲットを確認します。
- 可能な限り、配信先の定義を決定的で再利用可能なものにします。
- 下流の認証情報とプラットフォームの制約は、別々の検証項目として扱います。
- 配信先の状態が不明な場合は、まず読み取り専用で確認することを優先します。
推奨ワークフロー
1. act 作業の準備状況を分類する
node ~/.claude/skills/sf-datacloud/scripts/diagnose-org.mjs -o <org> --phase act --json
2. 先に配信先を確認する
sf data360 activation platforms -o <org> 2>/dev/null
sf data360 activation-target list -o <org> 2>/dev/null
sf data360 data-action-target list -o <org> 2>/dev/null
3. アクティベーションより先に配信先を作成する
sf data360 activation-target create -o <org> -f target.json 2>/dev/null
sf data360 data-action-target create -o <org> -f target.json 2>/dev/null
4. アクティベーションまたはデータアクションを作成する
sf data360 activation create -o <org> -f activation.json 2>/dev/null
sf data360 data-action create -o <org> -f action.json 2>/dev/null
5. 下流の準備状況を検証する
sf data360 activation list -o <org> 2>/dev/null
sf data360 activation data -o <org> --name <activation> 2>/dev/null
特に注意すべき点
- アクティベーションの設計は、公開済みの上流セグメントが正常であることを前提とします。
- 通常、アクティベーションの作成より先に配信先を設定します。
- 下流の認証情報やプラットフォームの制約は、Data Cloud CLI だけでは管理できない場合があります。
- 配信先の設定が不明な場合は、読み取り専用での確認から始めるのが最も安全です。
CdpActivationTargetまたはCdpActivationExternalPlatformは、現在の組織/ユーザーではアクティベーション機能が制限されていることを示します。むやみに再試行するのではなく、アクティベーションの設定、権限、配信先の構成を案内してください。
出力形式
Act task: <activation / activation-target / data-action / data-action-target>
Destination: <platform or target>
Target org: <alias>
Artifacts: <definition files / commands>
Verification: <listed / created / blocked>
Next step: <destination validation or downstream testing>
参考資料
- README.md
- ../sf-datacloud/assets/definitions/activation-target.template.json
- ../sf-datacloud/assets/definitions/activation.template.json
- ../sf-datacloud/assets/definitions/data-action-target.template.json
- ../sf-datacloud/assets/definitions/data-action.template.json
- ../sf-datacloud/UPSTREAM.md
- ../sf-datacloud/references/plugin-setup.md
- ../sf-datacloud/references/feature-readiness.md
コメント
Markdown 対応