CLI Skills、MCP 与插件采用

CLI 定制指标帮助管理员观察 Skills、Custom agents、MCP、slash commands 与 plugins 的采用。它们在启用 Copilot usage metrics 后通过 API 提供，不在当前看板展示。

字段覆盖用户 1-day / 28-day、实体 1-day，以及实体 28-day 的每个 day_totals。

事件与字段

数组	名称字段	interaction_count	去重字段
totals_by_skill	skill	Skill 调用	distinct_skill_use_count
totals_by_custom_agent	custom_agent	Custom agent 启动	distinct_custom_agent_use_count
totals_by_mcp	mcp	MCP 连接或重连尝试，包括成功与失败	distinct_mcp_use_count
totals_by_slash_cmd	slash_cmd	斜杠命令调用	distinct_slash_cmd_use_count
totals_by_plugin	plugin	与插件关联的 Skill 调用	distinct_plugin_use_count

MCP 已连接后执行工具，不增加连接计数；重连次数很高也不证明工具使用很多。应结合连接故障与实际工作流判断。

插件交互已经包含在 Skill 交互内，不能把两者相加作为总使用量。

前五名限制

每个数组最多显示该记录中 interaction_count 最高的五项，按数量降序。条目缺失不表示零使用，不能用这些数组计算精确采用人数或完整排行榜。

可识别的第一方名称可能显示；客户自定义 Skills、agents、MCP、plugins 的特定标识不公开，归入 other。自定义斜杠命令则保留遥测的 custom 分类。

Distinct 的含义

Distinct 数的是发生过活动的不同标识，不是调用次数或人数。实体层面同一标识被多人使用仍只计一次，因此不能相加各用户 distinct 得到企业 distinct。

Distinct 覆盖前五名之外的标识；被归入一个 other 条目的多个隐藏标识，仍分别贡献 distinct。看到一个 other 和较大 distinct 并不矛盾。

空值与采用判断

字段可用时，空数组和 distinct=0 表示没有记录到相应活动；功能数据尚未提供时，字段可为 null 或缺省，不能当成确认为零。

某项在很多用户的前五项中出现，可以作为推广候选信号；只在少数用户出现时，还需考虑其他人的活动落在前五名之外。标准化前结合内部目录和用户反馈，不只根据事件总数决定保留或停用。