用途:将 GitHub 上的活动(自己提交的 PR、评审的 PR、创建的 issue、提交贡献)抓取为按天缓存的 JSON 数据,输出到 ~/.cache/recap/github/{user}/{YYYY-MM-DD}/activity.json。
主要能力:调用 gh CLI 进行认证和 API 请求;支持按日期范围、用户、组织筛选;结果幂等(相同输入产生相同输出,可安全重跑);--reuse 在缓存存在且标记为完整时跳过抓取;对速率限制有感知,使用 gh api --paginate 并内置退避。
使用方式:命令形式为 /recap:github-activity --since 2026-03-23,可选 --until、--user、--org、--reuse。参数中 --since 必填,--until 默认今天,--user 默认已认证用户。快速运行需先确认认证 gh auth status,计算日期范围后执行脚本脚本 github-activity.sh,再验证缓存。输出 activity.json 含 user、date、prs_authored、prs_reviewed、issues 及 metadata(complete 和 counts)。提交贡献因 GraphQL 返回周期汇总而非逐日,单独缓存为 commits-{since}-{until}.json。
适用场景:需要按天回顾或汇总个人/组织 GitHub 活动,并希望结果可缓存、可重复读取的自动化流程。
限制与前提:需安装并认证 gh CLI(gh auth login),需 jq 解析 JSON;token 过期会报未登录,范围内无活动会得到空结果(空天也缓存为 complete),触发速率限制(403)需等待约一小时重试,PR 超过 1000 条受搜索 API 限制,应缩小日期范围或加 --org 过滤。