团队到底在用什么 Skill 和 MCP：用量报表里三个会读错的口径

先说结论

1. 企业管理员现在能看到团队在用哪些 Skill、自定义 Agent、MCP Server、slash command 和插件了——GitHub 在 9 月 17 日把这五类活动加进了 Copilot 用量指标 API。
2. 但这份报表有三个官方明说的口径坑，不知道就会得出错误结论：自定义名称看不到（被归到 other）、MCP 的计数只算”连接/重连”而不是”调用工具”、插件计数是技能计数的子集（两者不能相加）。
3. 每个榜单只列前 5 项，所以它是”看趋势”的工具，不是”完整盘点”的工具。
4. 权限门槛：企业所有者、账单管理员、组织所有者，或拥有 “View Copilot Metrics” 权限的自定义角色才能拉这份报表。

新增了什么

官方在原有的 CLI 报表基础上，补上了 agentic 活动的维度。新增字段：

每个数组最多列 5 项，按活动量排序；每项都带 interaction_count。报表有两种粒度：按用户的报表回答”这个人在用什么”，聚合报表回答”整个企业/组织在用什么”。

三个口径坑（官方原文写明，不是我推测的）

坑一：自定义名称看不到，会被归到 other。
官方为了保护隐私，只显示 GitHub 自己提供的、可识别的条目名称；客户自定义的名称不显示，Skill、自定义 Agent、MCP Server、插件都会被归到 other 分组里。

→ 实际影响：如果你们团队自研了三个 MCP Server，报表里看到的会是 other 加上一个数字，你没法知道是哪一个在增长。想知道具体是哪个，得靠你们自己的埋点或服务端日志。

坑二：MCP 的 interaction_count 数的是”连接/重连”，不是”调用工具”。
官方原话是：对 MCP Server 而言，这个计数只在 Copilot CLI 尝试连接或重连时增加，成功和失败都算；在同一个已连接的 server 上反复调用工具，不会让它增加。

→ 实际影响：这个数字衡量的是连接稳定性，不是使用强度。一个高频调用的 server 可能数字很低（一直连着没断），而一个反复重连的 server 数字很高（可能恰恰说明它不稳）。把它当”使用热度”读会完全读反。

坑三：插件计数是技能计数的子集，不能相加。
官方原话是：插件指标只统计与该插件关联的 skill 调用。所以每一次插件交互同时也会出现在 skill 总量里；反过来，不来自插件的 skill 调用只出现在 skill 里。

→ 实际影响：不要把 totals_by_plugin 和 totals_by_skill 相加来算”总用量”，那样会重复计数。

另外还有一个边界：空数组和 0 表示”没有匹配的活动”，而字段为 null 或缺失表示”该数据不可用”——这两者含义不同，写脚本时别用同一种方式处理。

拿报表做自检时，可以先跑一遍这个最小校验（把字段名换成你实际拿到的 JSON 路径）：

# 自检一：插件计数是技能计数的子集 —— 合计值必须 <= 技能合计，否则你的口径理解有误
jq '[.totals_by_skill[].interaction_count] | add'  report.json   # 技能合计
jq '[.totals_by_plugin[].interaction_count] | add' report.json   # 插件合计（应 <= 上面那个）

# 自检二：榜单只列前 5 —— 想统计"总量"要另找来源，不能把前 5 加起来当全量
jq '.totals_by_skill | length' report.json

这份报表能拿来做决策的三件事

1. 找推广成功与失败的分界：哪些 Skill 进了前 5、哪些从来没出现——没用起来的能力就该停掉维护。
2. 看 MCP 的稳定性问题：结合”连接次数”与团队反馈，判断某个 server 是不是在反复掉线（这是它唯一的用途，别当热度看）。
3. 给投入定方向：官方给的定位就是”找出正在被采用的定制项、发现推广缺口、把投入集中在开发者真正在用的自动化上”。

读取时要注意的三件事

• 别把”前 5 名”当全量：榜单截断在 5，第 6 名之后不可见。
• 别把 other 当垃圾：那里藏着你们自研的全部东西——恰恰是最该关注的部分。
• 注意权限与统计口径：报表访问需要相应角色；同时它是按活动量统计的，不是按人数，一个高频用户就能把某个条目顶上去。

这次没核实的

• distinct_* 系列字段的具体语义*：我只核到 `totalsby` 的说明与”两个问题”的框架，没有逐字确认每个 distinct 字段的官方定义**，所以本文不对它下结论。
• 报表的刷新频率、保留时长、API 速率限制：公告未涉及。
• 我没有企业环境实测，所有口径说明都来自官方公告原文。

参考来源

• Agentic CLI customizations now in the usage metrics API——新增字段、隐私分组、MCP 计数口径、插件与技能的包含关系（2026-09-17 发布）
• GitHub Copilot 用量指标文档——报表入口与权限要求
• Model Context Protocol 规范——本文讨论的 MCP「连接」与「工具调用」在协议层面的区分