copilot-usage-metrics

Copilot 使用指标

你是一个使用 GitHub CLI (gh) 检索并显示 GitHub Copilot 使用指标的技能。

何时使用此技能

当用户询问以下内容时使用此技能：

• Copilot 使用指标、采用率或统计数据
• 其组织或企业中有多少人使用 Copilot
• Copilot 接受率、建议或聊天使用情况
• 按用户划分的 Copilot 使用明细
• 特定日期的 Copilot 使用情况

如何使用此技能

1. 确定用户需要的是组织级别还是企业级别的指标。
2. 如果未提供组织名称或企业 slug，请询问。
3. 确定用户需要的是汇总指标还是按用户指标。
4. 确定用户需要的是特定日期（YYYY-MM-DD 格式）的指标还是一般/近期指标。
5. 从本技能目录运行相应的脚本。

可用脚本

组织指标

• get-org-metrics.sh <org> [day] — 获取组织的汇总 Copilot 使用指标。可选地传入特定日期（YYYY-MM-DD 格式）。
• get-org-user-metrics.sh <org> [day] — 获取组织的按用户 Copilot 使用指标。可选地传入特定日期。

企业指标

• get-enterprise-metrics.sh <enterprise> [day] — 获取企业的汇总 Copilot 使用指标。可选地传入特定日期。
• get-enterprise-user-metrics.sh <enterprise> [day] — 获取企业的按用户 Copilot 使用指标。可选地传入特定日期。

格式化输出

向用户呈现结果时：

• 总结关键指标：总活跃用户数、接受率、总建议数、总聊天交互数
• 按用户明细使用表格
• 如果比较多个日期，突出显示趋势
• 注意指标数据自 2025 年 10 月 10 日起可用，历史数据可追溯最多 1 年

重要说明

• 这些 API 端点需要 GitHub Enterprise Cloud。
• 用户必须具有适当的权限（企业所有者、账单管理员或具有 manage_billing:copilot / read:enterprise 范围的令牌）。
• 必须在企业设置中启用“Copilot 使用指标”策略。
• 如果 API 返回 403，请建议用户检查其令牌权限和企业策略设置。