用途
本技能面向 Salesforce TPM 系统管理员，用于将 TPE Analytics 仪表盘中的通用 KPI 槽位替换为客户自有的 KPI 度量。它不会改动已发布的基础模型，而是以客户指定的后缀克隆基础语义模型参数、可视化和仪表盘，使客户自己的 KPI 度量代码出现在 Promotion Analysis 与 Tactic Analysis 仪表盘上。
主要能力
- 处理 5 个 KPI 槽位：Promotion Measure 1-3（Promotion_Measure_{1,2,3}_prm / value）与 Tactic Measure 1-2（Tactic_Measure{1,2}_prm / _clc）。
- 每个槽位对应两个 SDM 工件：参数（*_prm，List 类型，含 allowedValues 菜单项与 defaultValue）和计算度量（可视化实际查询的对象，其表达式通过 apiName 回链参数）。定制一个槽位意味着同时克隆这两者。
- 无论某个槽位是否有覆盖请求，都会为全部 5 个槽位生成克隆（共 10 个工件）；未提及的槽位仍会作为基础工件的精确副本克隆，仅 apiName/label 加后缀。
- 支持两种覆盖模式：APPEND 模式（默认）按度量代码向基础菜单 upsert 一条 {measureCode, displayName} 条目；REPLACE 模式用客户提供的完整 allowedValues 数组替换整个菜单。
- 可生成 Promotion Analysis、Tactic Analysis 或两者。
使用方式
技能由 sf CLI 与 REST 驱动，针对已认证的 org 运行。开始前需收集：TPM 系统管理员用户名（通过 node ./scripts/sf-rest.js org-status --target-org <username> 验证连通性，不使用 sf org display --json 以免泄露 accessToken）；是否 dry-run（默认提供）；后缀（用于区分克隆元数据与基础模型，默认建议 Cust）；每个度量的覆盖内容（通过 AskUserQuestion 分批收集，Promotion Measure 1-3 一次调用，Tactic Measure 1-2 第二次调用）；要生成哪些仪表盘。
执行分为多个阶段：命名空间检测；Phase 0 预检与发现（验证连通性、固定 API 版本 v67.0、通过遍历应用资产列表解析已安装应用与资产 id，不硬编码 id）；Phase 1 解析 5 槽位计划并打印、获取用户明确确认；Phase 2-4 克隆参数、度量、可视化、仪表盘（运行 scripts/clone-tpe-dashboards.js）；Phase 5 验证所有创建工件正确引用新的带后缀克隆。
适用场景
适用于 Salesforce TPM 系统管理员在已安装 TPE Analytics 应用和 Extended TPM Analytics SDM 的 org 中，为组织自有 KPI 定制 TPE 仪表盘。
限制
- 前提是已通过 consumer-goods-tpe-dashboard-configure 安装 TPE Analytics 应用和 Extended TPM Analytics SDM；本技能不安装这些，只在其之上定制。
- 假设底层度量数据已由先前的 setup-rtr-datacloud-export/data-kit 设置填充；本技能不创建该底层数据。
- 三种工件类型（语义模型参数、可视化、仪表盘）均无原生克隆端点，每次克隆都采用 GET 基础工件、深拷贝 JSON 并应用覆盖、POST 为新工件的三步模式。
- 绝不修改基础模型工件；未经用户对 Phase 1 计划的明确同意不创建任何内容；绝不硬编码工件 id、api-name 或跨 org 的命名空间；绝不假设每个仪表盘只需克隆一个可视化。
- 具体 apiNames、JSON 形状、脚本 CLI 用法与写入注意事项见 references/procedure.md 与 references/payload-shapes.md。