SuperAPI AI 工具集

git-activity

编程与开发

查看项目

更新于 10-15 17:24

技能介绍

用途:从本地 Git 仓库读取提交历史,按仓库、按天缓存为 JSON 原子文件,路径为 ~/.cache/recap/git/{repo}/{YYYY-MM-DD}/log.json,供 /recap 编排器做渐进式时间尺度汇总(周读 7 个天原子,月读约 30 个)。

主要能力:仅读取本地仓库,不调用 API、无分页;输出幂等,可安全重复运行;按天缓存,--reuse 在缓存存在且标记完整时跳过抓取;可用 --author 过滤作者,用 --all-branches 记录所有本地与远程跟踪分支;过滤抓取会缓存在独立 scope 目录(名称含过滤条件与 --author 模式的摘要),避免混用。

用法示例: /recap:git-activity --repos coworker:~/Work/basecamp/coworker --since 2026-03-23 /recap:git-activity --repos coworker:~/Work/basecamp/coworker,house-skills:~/Work/basecamp/house-skills --since 2026-03-23 --until 2026-03-30 /recap:git-activity --repos coworker:~/Work/basecamp/coworker --since 2026-03-23 --reuse /recap:git-activity --repos coworker:~/Work/basecamp/coworker --since 2026-03-23 --author "Jeremy Daer" --all-branches 参数中 --repos(name:path 逗号分隔)与 --since 必填,--until 默认今天,--author、--all-branches、--reuse 可选。

限制与失败模式:路径非 Git 仓库会报 “not a git repo”;某天无提交会缓存为空且标记完整,属预期;提交信息含异常字符时 awk/jq 可能解析出错,会自动回退到更简单格式。}