SuperAPI AI 工具集

gh-weekly-report

通用与其它

查看项目

更新于 10-16 05:44

技能介绍

用途:为单个 GitHub 账号生成一周活动的交互式 HTML 报告,覆盖该用户本周触及的所有仓库中的 issue、PR、评审、提交与 discussion,聚焦“这一周发生了什么”,不派生后续工作、不创建 issue、不修改仓库。

主要能力:周一至周日(UTC)完整一周为默认窗口,也可用 --from/--to 指定;可选出 --owner 缩小范围,默认不限 owner、以 actor 为界;上周前一并收集用于环比。报告含头条计数与周环比、固定工作桶(feature、fix、refactor、docs、chore/infra、triage/review、other)、按仓库的 2–4 句叙事,主导仓库另附按工作类型的逐项分列,以及点击下钻到每个条目。固定布局使相邻周可直接对比变化。

使用方式:先向用户确认 actor、owner 过滤(或“无过滤”)和窗口;然后运行 python3 <skill-dir>/scripts/collect.py --out <scratchpad>/gh-weekly [--owner O] [--actor A] [--from YYYY-MM-DD --to YYYY-MM-DD] 生成 week.json;把当前周期每个条目键映射到桶写入 buckets.json,并为每个活跃仓库写 narratives.json;再运行 python3 <skill-dir>/scripts/render.py --data <...>/week.json --buckets <...>/buckets.json --narratives <...>/narratives.json --out <tmpdir>/gh-week-<iso_week>-<actor>.html 产出报告,把 week.json 复制到报告旁作为重渲染凭据,打印两文件绝对路径并打开。最后在聊天中给出头条数字与环比、主导分类及计数器未体现的情况。

限制:需已认证的 gh 且可用 GitHub API;一次运行约 14 次搜索调用,面对 30 次/分钟的搜索配额,403 时会等待 60 秒重试一次,仍失败需稍后重跑;搜索被截断说明条目缺失,应把 stderr 警告告知用户;报告内嵌数据但 Tailwind 与 Chart.js 来自 CDN,离线时图表跳过并显示提示、页面仍可读;不要从提交的配置文件读取参数,也不要提交这些参数。