SuperAPI AI 工具集

quarterly-review

通用与其它

查看项目

更新于 10-16 09:29

技能介绍

用途:为指定 GitHub 用户和季度生成结构化贡献回顾,包含总量、按月与按仓库分布,以及基于 PR 标题合成的成果叙述。

主要能力:通过 contributions GraphQL API 获取可访问仓库的提交、PR、评审、Issue 等总量;通过 gh search prs 与 GraphQL search 获取指定 org 下作者与评审的 PR;用 jq 生成按月、按仓库、月×仓库矩阵的分布;读取 PR 标题并按主题分组叙述。

使用方式:运行前确认季度(如 Q1 2026 → 2026-01-01..2026-03-31,未给年份用当前年)、GitHub 用户(默认 gh api user --jq .login)和 org。季度对应区间:Q1=01-01..03-31、Q2=04-01..06-30、Q3=07-01..09-30、Q4=10-01..12-31。主要命令为 gh api graphql 与 gh search prs --author <USER> --owner <ORG> --created <FROM>..<TO> --limit 300 --json repository,state,title,createdAt,url,number,之后用 jq 分组统计。输出格式含季度概览、月度、月×仓库表格、关键成果主题和一句话总结。

限制:contributions API 对 org 私有仓库常返回 0,需用 search API 补充;gh search prs 的 state 值为小写(merged/open/closed);mergedAt 不是 gh search prs 的合法 --json 字段;--limit 300 会截断结果,超出需分页或缩小窗口。