1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | copilot-usage-metrics(github/awesome-copilot 合集仓库子技能) |
GitHub |
| 作者/维护者 | bbuna_microsoft(社区贡献者独立提交) | GitHub 提交记录 |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/copilot-usage-metrics | — |
| 许可证 | MIT | GitHub API |
| 最新版本 | 无独立版本号,单次提交后未再变更 | 仓库提交记录 |
| 安装方式 | gh skills install github/awesome-copilot copilot-usage-metrics,或手动复制目录 |
仓库文档 |
合集仓库整体约 3.9 万 Stars,属整个合集不代表本技能自身热度,自身热度见第 6 章。
2. 功能介绍与亮点
通过 GitHub CLI(gh)与 REST API 查询并展示 GitHub Copilot 在组织或企业层面的使用指标:活跃用户数、建议采纳率、Chat 交互量,并支持按日期查询与逐用户明细拆解。
亮点是把四类常用查询固化成四个独立的短脚本(组织级/企业级 × 汇总/逐用户),每个脚本只做一件事、只调用官方 gh api 端点,不引入任何第三方依赖或额外网络请求。SKILL.md 正文明确指引 Agent 先判断查询范围(组织/企业)、粒度(汇总/逐用户)、时间范围,再调用对应脚本,并提前告知数据可用范围(2025 年 10 月起、最长回溯一年)与常见 403 错误的排查方向。
3. 适用场景
固定分类:数据分析与可视化
适用于需要定期查看团队或企业 Copilot 采纳情况的工程管理者、DevEx/平台团队,用于评估工具投入效果、发现低使用率团队或规划培训重点;也适用于需要生成阶段性使用报告的技术负责人。
4. 跨 Agent 兼容性
- Claude Code:原生支持——标准 SKILL.md + 脚本结构,可放入
.claude/skills/或经插件市场安装 - Codex:需适配——不自动发现
~/.codex/skills之外的技能,需手动引用路径 - OpenClaw:未验证
- Hermes Agent:原生支持——按路径扫描子目录探测 SKILL.md
5. 推荐理由
多数团队缺乏简便手段回答“我们的 Copilot 到底有没有用起来”,本技能把四个官方 API 端点包装成开箱即用的对话式查询入口,脚本极短、逻辑透明、无额外依赖,管理者一句话就能拿到结构化的采纳率与使用趋势数据。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | skills.sh 记录约 8,800 次独立安装,属实测证据支撑到 7 档;未见独立第三方媒体报道或专门讨论 |
| 可用性 | 7 | 复制即用、零第三方依赖,四个脚本职责单一、文档清楚说明各自用途与数据范围;但需 GitHub Enterprise Cloud 套餐与 manage_billing:copilot/read:enterprise 权限范围才能实际调用,目标用户面较窄;正文自提交后近 7 个月未见更新 |
| 安全性 | 9 | 四个脚本均只调用官方 gh api,无第三方网络请求,不单独存储或回传凭据(复用用户已有的 gh 登录态),逻辑短小可逐行审计,无可疑指令 |
安全检查清单:①有 shell 命令执行,但范围仅限调用 gh api 查询只读的官方 Copilot 使用数据端点,无写操作 ②无第三方外联,全部请求指向 GitHub 自身 API ③不要求用户额外提供或存储 API key,复用已登录的 gh CLI 凭据 ④脚本逻辑透明,无可疑指令或混淆代码 ⑤作者信誉良好,未见造假迹象 ⑥License 明确(MIT)⑦仓库未见 archived 迹象,最近一次仓库整体提交为近日。
综合评分 = (7 + 7 + 9) / 3 ≈ 7.67
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| sql-object-impact-analysis(github/awesome-copilot) | 修改 SQL 对象前追踪其在代码库内的全部引用 | 面向代码库内部依赖分析;本技能面向组织级产品使用数据查询,数据源完全不同 |
| datanalysis-credit-risk(github/awesome-copilot) | 信贷风控领域的数据清洗与变量筛选流水线 | 垂直金融数据科学工具,处理本地数据文件;本技能查询远程 SaaS 平台的实时使用指标 |
| context-map(github/awesome-copilot) | 编码任务前列出相关文件与依赖的轻量清单 | 面向单次编码任务的上下文梳理;本技能面向持续性的组织级使用趋势监控,服务对象是管理者而非开发者本人 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。skills.sh 统计的约 8,800 次独立安装是目前可获得的唯一独立使用规模信号。
9. 安装使用方式
- GitHub CLI(推荐):
gh skills install github/awesome-copilot copilot-usage-metrics - 手动安装:复制
skills/copilot-usage-metrics/整个目录(含 SKILL.md 与四个.sh脚本) - 触发方式:向 Agent 提出“查一下我们组织的 Copilot 使用情况”或“某企业某天的 Copilot 采纳率”等问题即可自动进入查询流程
- 前置条件:需已安装并登录 GitHub CLI(
gh auth login),且账号具备企业 owner / billing manager 权限或对应 token scope;企业设置中需开启“Copilot usage metrics”策略
10. 注意事项
- 仅支持 GitHub Enterprise Cloud,普通组织或个人账号无法调用对应 API 端点
- 数据仅从 2025 年 10 月起可用,且最长只能回溯一年
- 权限或策略未正确配置时会返回 403,需要用户自行检查 token scope 与企业策略开关
- 自提交以来内容未再更新,若 GitHub Copilot 使用指标 API 未来发生字段变更,脚本可能需要同步调整