activating-datacloud

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

activating-datacloud: Data Cloud Act Phase

activating-datacloud:Data Cloud 执行阶段

Use this skill when the user needs downstream delivery work: activations, activation targets, data actions, or pushing Data Cloud outputs into other systems.
当用户需要下游交付工作时使用此技能:激活、激活目标、数据动作,或将Data Cloud输出推送至其他系统。

When This Skill Owns the Task

此技能负责的任务场景

Use
activating-datacloud
when the work involves:
  • sf data360 activation *
  • sf data360 activation-target *
  • sf data360 data-action *
  • sf data360 data-action-target *
  • verifying downstream delivery setup
Delegate elsewhere when the user is:
  • still building the audience or insight → segmenting-datacloud
  • exploring query/search or search indexes → retrieving-datacloud
  • setting up base connections or ingestion → connecting-datacloud, preparing-datacloud

当工作涉及以下内容时,使用
activating-datacloud
  • sf data360 activation *
  • sf data360 activation-target *
  • sf data360 data-action *
  • sf data360 data-action-target *
  • 验证下游交付设置
当用户进行以下操作时,请转交至其他技能:
  • 仍在构建受众或洞察 → segmenting-datacloud
  • 探索查询/搜索或搜索索引 → retrieving-datacloud
  • 设置基础连接或数据摄入 → connecting-datacloudpreparing-datacloud

Required Context to Gather First

需先收集的必要上下文

Ask for or infer:
  • target org alias
  • destination platform or downstream system
  • whether the segment already exists and is published
  • whether the user needs create, inspect, update, or delete
  • whether the task is activation-focused or data-action-focused

询问或推断:
  • 目标组织别名
  • 目标平台或下游系统
  • 细分受众是否已存在并发布
  • 用户是否需要创建、检查、更新或删除操作
  • 任务是以激活为重点还是以数据动作为重点

Core Operating Rules

核心操作规则

  • Verify the upstream segment or insight is healthy before creating downstream delivery assets.
  • Run the shared readiness classifier before mutating activation assets:
    node ~/.claude/skills/orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase act --json
    .
  • Inspect available platforms and targets before mutating activation setup.
  • Keep destination definitions deterministic and reusable where possible.
  • Treat downstream credential and platform constraints as separate validation concerns.
  • Prefer read-only inspection first when the destination state is unclear.

  • 在创建下游交付资产之前,验证上游细分受众或洞察是否正常。
  • 在修改激活资产之前,运行共享就绪性分类器:
    node ~/.claude/skills/orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase act --json
  • 在修改激活设置之前,检查可用平台和目标。
  • 尽可能保持目标定义的确定性和可复用性。
  • 将下游凭证和平台约束视为单独的验证事项。
  • 当目标状态不明确时,优先进行只读检查。

Recommended Workflow

推荐工作流程

1. Classify readiness for act work

1. 分类执行工作的就绪性

bash
node ~/.claude/skills/orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase act --json
bash
node ~/.claude/skills/orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase act --json

2. Inspect destinations first

2. 先检查目标

bash
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
bash
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. Create the destination before the activation

3. 在创建激活之前先创建目标

bash
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
bash
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. Create the activation or data action

4. 创建激活或数据动作

bash
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
bash
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. Verify downstream readiness

5. 验证下游就绪性

bash
sf data360 activation list -o <org> 2>/dev/null
sf data360 activation data -o <org> --name <activation> 2>/dev/null

bash
sf data360 activation list -o <org> 2>/dev/null
sf data360 activation data -o <org> --name <activation> 2>/dev/null

High-Signal Gotchas

高信号注意事项

  • Activation design depends on a healthy published upstream segment.
  • Destination configuration usually comes before activation creation.
  • Downstream credential and platform constraints may live outside the Data Cloud CLI alone.
  • Read-only inspection is the safest first move when the destination setup is unclear.
  • CdpActivationTarget
    or
    CdpActivationExternalPlatform
    means the activation surface is gated for the current org/user; guide the user toward activation setup, permissions, and destination configuration instead of retrying blindly.

  • 激活设计依赖于正常发布的上游细分受众。
  • 目标配置通常在激活创建之前进行。
  • 下游凭证和平台约束可能仅靠Data Cloud CLI无法处理。
  • 当目标设置不明确时,只读检查是最安全的第一步。
  • CdpActivationTarget
    CdpActivationExternalPlatform
    表示当前组织/用户无法使用激活界面;请引导用户进行激活设置、权限配置和目标配置,而非盲目重试。

Output Format

输出格式

text
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>

text
执行任务:<激活 / 激活目标 / 数据动作 / 数据动作目标>
目标:<平台或目标>
目标组织:<别名>
工件:<定义文件 / 命令>
验证状态:<已列出 / 已创建 / 已阻止>
下一步:<目标验证或下游测试>

References

参考资料

  • README.md
  • ../orchestrating-datacloud/assets/definitions/activation-target.template.json
  • ../orchestrating-datacloud/assets/definitions/activation.template.json
  • ../orchestrating-datacloud/assets/definitions/data-action-target.template.json
  • ../orchestrating-datacloud/assets/definitions/data-action.template.json
  • ../orchestrating-datacloud/UPSTREAM.md
  • ../orchestrating-datacloud/references/plugin-setup.md
  • ../orchestrating-datacloud/references/feature-readiness.md
  • README.md
  • ../orchestrating-datacloud/assets/definitions/activation-target.template.json
  • ../orchestrating-datacloud/assets/definitions/activation.template.json
  • ../orchestrating-datacloud/assets/definitions/data-action-target.template.json
  • ../orchestrating-datacloud/assets/definitions/data-action.template.json
  • ../orchestrating-datacloud/UPSTREAM.md
  • ../orchestrating-datacloud/references/plugin-setup.md
  • ../orchestrating-datacloud/references/feature-readiness.md