关于 sf-datacloud-act
sf-datacloud-act 是用于 Salesforce Data Cloud 下游交付的技能,面向细分激活、目标配置和数据操作。它指导用户先检查已发布的上游细分及目标,再配置交付并验证状态。
主要功能
- 01检查激活平台与目标
- 02创建激活目标和数据操作目标
- 03创建细分激活和数据操作
- 04验证下游交付状态
- 05检查操作就绪情况
适用场景
- 01将已发布细分配置为下游激活
- 02为激活创建目标配置
- 03向下游系统推送 Data 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 激活阶段
当用户需要下游交付工作时使用此技能:激活、激活目标、数据操作,或将 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. 对激活任务的就绪状态进行分类
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