mcpField
S
sf-datacloud-harmonize

sf-datacloud-harmonize

github.com/jaganpro数据与数据库424972 次安装26 周前更新
代码仓库

关于 sf-datacloud-harmonize

sf-datacloud-harmonize 是用于 Salesforce Data Cloud 架构协调与统一工作的技能，面向数据模型、字段映射、身份解析和统一画像任务。它引导用户先检查架构，再创建映射并验证异步身份解析结果。

主要功能

  1. 01检查数据模型目录与架构
  2. 02创建和审查字段映射
  3. 03配置身份解析规则集
  4. 04运行身份解析并验证结果
  5. 05处理数据图和统一画像

适用场景

  1. 01将来源 DLO 映射到目标 DMO
  2. 02检查字段后设计数据映射
  3. 03运行身份解析以统一用户记录
  4. 04构建数据图或查询通用 ID

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/sf-datacloud-harmonize确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

CREDITS.md
LICENSE
README.md

详细介绍

sf-datacloud-harmonize：Data Cloud Harmonize 阶段

当用户需要架构协调与统一工作时使用此技能：DMO、字段映射、关系、身份解析、统一档案、数据图或通用 ID 查询。

此技能负责的任务

当工作涉及以下内容时，使用 sf-datacloud-harmonize：

  • sf data360 dmo *
  • sf data360 identity-resolution *
  • sf data360 data-graph *
  • sf data360 profile *
  • sf data360 universal-id lookup

以下情况请委派给其他技能：

首先收集所需上下文

询问或推断以下信息：

  • 源 DLO 和目标 DMO 名称
  • 任务属于架构创建、映射、IR 还是数据图相关工作
  • 目标组织别名
  • 是否已有规则集
  • 用户期望的统一实体模型

核心操作规则

  • 创建映射前检查 DMO 架构。
  • 修改架构协调资源前，运行共享就绪状态分类器：node ~/.claude/skills/sf-datacloud/scripts/diagnose-org.mjs -o <org> --phase harmonize --json。
  • 浏览目录时优先使用 dmo list --all，快速检查就绪状态时则使用首页的 dmo list。
  • 使用 query describe 或 dmo get --json，不要臆造不受支持的 describe 流程。
  • 将身份解析运行视为异步操作，并在执行后验证结果。
  • 将统一档案工作与 STDM／会话追踪工作分开处理。

推荐工作流

1. 对 harmonize 工作的就绪状态分类
node ~/.claude/skills/sf-datacloud/scripts/diagnose-org.mjs -o <org> --phase harmonize --json
2. 检查目录
sf data360 dmo list --all -o <org> 2>/dev/null
sf data360 identity-resolution list -o <org> 2>/dev/null
3. 映射前检查架构
sf data360 query describe -o <org> --table ssot__Individual__dlm 2>/dev/null
sf data360 dmo get -o <org> --name ssot__Individual__dlm --json 2>/dev/null
4. 有针对性地创建或审查映射
sf data360 dmo mapping-list -o <org> --source Contact_Home__dll --target ssot__Individual__dlm 2>/dev/null
sf data360 dmo map-to-canonical -o <org> --dlo Contact_Home__dll --dmo ssot__Individual__dlm --dry-run 2>/dev/null
5. 仅在映射可靠后运行 IR
sf data360 identity-resolution create -o <org> -f ir-ruleset.json 2>/dev/null
sf data360 identity-resolution run -o <org> --name Main 2>/dev/null

需要特别注意的问题

  • dmo list 通常应使用 --all。
  • 使用 query describe 或 dmo get --json；没有 dmo describe 命令。
  • 映射及相关命令可能会受 API 版本差异影响。
  • 统一 DMO 名称是特定于规则集的，而非通用名称。
  • 数据图定义对字段选择和关系结构十分敏感。
  • 如果 dmo list 可用，但 identity-resolution list 受限，应将其视为阶段特定的缺口，而非整个 Data Cloud 服务中断。

输出格式

Harmonize task: <dmo / mapping / relationship / ir / data-graph>
Source/target: <dlo → dmo or ruleset/graph names>
Target org: <alias>
Artifacts: <json files / commands>
Verification: <passed / partial / blocked>
Next step: <segment / retrieve / follow-up>

参考资料

评论

支持 Markdown