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. 05使用 SQL 验证结果

适用场景

  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 验证，而不要假定操作已成功。
  • 需要易读的成员详情时，使用 SQL 联接，而不是 segment members。

推荐工作流

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