关于 cawplan-support-metrics
用于将 Support Ops 指标导出至 CawPlan、校验并导入获批数据的受控工作流技能。它限定 V1 指标契约，并要求在写入前进行试运行、对账和明确审批。
主要功能
- 01使用捆绑的 Apps Script 导出流程
- 02校验数据源与产品 ID
- 03导入前预览汇总结果
- 04分批写入规范指标
- 05导入后进行对账
- 06经审批后追加更正数据
适用场景
- 01准备 Support Ops 指标导出
- 02校验产品映射和导出总数
- 03导入获批的工单创建指标
- 04核对导入数据或规划更正
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/cawplan-support-metrics确认已加载。
附带文件assets/CawPlanSupportMetrics.gs
详细介绍
CawPlan 支持指标
将此技能用于受控的 Support Ops → CawPlan 关键指标工作流。它基于固定的 Support 数据契约，对通用的 cawplan metrics 命令进行专门化。
初始化
cawplan skill check
如果缺少身份验证，请运行 cawplan auth login，向用户显示打印出的 URL；用户确认批准后，运行 cawplan auth login --device-auth --complete。不要在 Apps Script 中请求或嵌入 API 密钥。
内置导出器
使用 assets/CawPlanSupportMetrics.gs 作为维护中的导出器。将其复制到绑定的 Support Ops Apps Script 项目中；不要从头重新生成导出器。
首次导出前：
- 运行
cawplanSupportInspectSource()，并检查日志中记录的人员工作表表头和解析出的源列。 - 在
CAWPLAN_SUPPORT_CONFIG.products中设置准确的 CawPlan 产品unique_id值。 - 将准确的、已批准的 B、C、E、F、H 和 I 列表头文本复制到
CAWPLAN_SUPPORT_CONFIG.approvedHeaders。 - 设置包含起止日期的
startDate和endDate。 - 运行
cawplanSupportExportMetrics()，并使用日志中记录的 Drive 文件 URL 和 SHA-256 进行试运行。
此导出器对 Sheets 仅执行读取操作，并且只会在 Drive 中创建所请求的 JSON 文件。只有在与当前仪表板和周报定义进行比较后，才能修改其源映射。
支持的工作流
将请求路由到以下其中一种模式：
- 准备导出器：检查提供的 Apps Script 或工作表布局，然后配置或针对内置导出器进行范围有限的补丁。绝不要添加直接的 CawPlan HTTP 调用。
- 验证／试运行：验证文件、解析并确认产品 ID、拒绝重复身份或不受支持的词汇，并显示总计，但不写入数据。
- 导入：只有在用户查看并批准试运行后，才能通过
cawplan metrics ingest分批上传规范条目，且每批数量须有限。 - 核对：查询准确的导入范围和维度，检查
truncated，并将 CawPlan 总计与导出结果进行比较。 - 更正：绝不要覆盖或删除先前的数据点。预览增量更正差值，并且只有在获得明确批准后才能写入。
V1 契约边界
唯一常规的 V1 写入内容是：
domain = cawplan_csm
metric = ticket_created
field = value
允许使用的基础标签为 product_line、channel、assignee 和 source_system。dimensions.product 必须是已确认的 CawPlan 产品 unique_id；工作区归属由服务端注入，不得自行提供。
Zendesk 状态快照、Solved／Pending KPI、Jira SPRT 问题、每周总计、百分比和报告文件均不属于 V1 写入契约。如果用户提出要求，可以分析或导出这些内容，但在平台负责人批准新的规范指标契约之前，不得导入。
写入安全
- 将验证、预览和查询视为只读操作。
- 不要仅因用户附加了文件就进行导入；用户必须明确要求写入并批准试运行。
- 绝不要同时导入按受理人划分的行及其派生的
Total行。 - 绝不要使用重新生成的时间戳或修改过的标签重试。先进行核对；只有在必要时，才使用字节完全一致的规范条目重试。
- 如果遇到未知列、产品不明确、意外标签、基础值为负数、源范围不完整、查询结果被截断或总计不匹配，请停止操作。
- 每次写入都要报告源校验和、范围、条目数、接受数和核对结果。