用途
sf-datacloud-harmonize 是面向 Salesforce Data Cloud Harmonize 阶段的技能，用于处理架构协调与数据统一相关工作。当任务涉及 DMO、字段映射、关系、身份解析、统一档案、数据图或通用 ID 查询时使用该技能。
主要能力
该技能负责以下命令相关的工作：
- sf data360 dmo *
- sf data360 identity-resolution *
- sf data360 data-graph *
- sf data360 profile *
- sf data360 universal-id lookup
当用户仍在接入数据流或构建 DLO 时，转交 sf-datacloud-prepare；处理细分逻辑或计算洞察时转交 sf-datacloud-segment；运行 SQL、describe 或搜索索引工作流时转交 sf-datacloud-retrieve。
使用方式
先收集所需上下文
需询问或推断：来源 DLO 与目标 DMO 名称；任务是架构创建、映射、身份解析还是图相关；目标 org 别名；是否已存在规则集；用户期望的统一实体模型。
核心操作规则
- 创建映射前先检查 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/会话追踪工作分开。
推荐工作流
-
分类 harmonize 工作的就绪状态： node ~/.claude/skills/sf-datacloud/scripts/diagnose-org.mjs -o <org> --phase harmonize --json
-
检查目录： sf data360 dmo list --all -o <org> 2>/dev/null sf data360 identity-resolution list -o <org> 2>/dev/null
-
映射前检查架构： 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
-
有意识地创建或审查映射： 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
-
仅在映射可信后运行 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
输出格式
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>
注意事项与限制
- dmo list 通常应使用 --all。
- 使用 query describe 或 dmo get --json；不存在 dmo describe 命令。
- 映射及相关命令可能对 API 版本差异敏感。
- 统一 DMO 名称是规则集专属的，而非通用的。
- 数据图定义对字段选择和关系形态敏感。
- 如果 dmo list 可用但 identity-resolution list 受限，应视为阶段特定缺口，而非整个 Data Cloud 故障。
- 参考资料包括 README.md，以及 ../sf-datacloud/assets/definitions/ 下的 dmo.template.json、mapping.template.json、relationship.template.json、identity-resolution.template.json、data-graph.template.json，还有 ../sf-datacloud/references/feature-readiness.md。