技能介绍

要解决什么问题

你在多个仓库里提交代码后，想按作者、时间、仓库或主题跨项目检索 commit，通常只能逐个 git log 翻历史，或者依赖托管平台的 Web 界面。Git Log Tracker 的思路是：在本地用 post-commit hook 把每次提交的元数据落盘，再用统一的 CLI 做查询和轻量维护，数据集中在 ~/.commit-logs/index.db。

它如何工作

自动采集：对指定仓库安装 hook 后，每次 git commit 会把 hash、日期、作者、仓库路径、主题等写入 SQLite；也支持全局模式，让新 clone 的仓库自动带上 hook。
跨仓查询：find 支持 hash 前缀匹配；list 以表格输出最近记录（HASH | DATE | AUTHOR | REPO | SUBJECT）；stats 做汇总统计。
仓库标签：通过 仓库级 label（如 work / personal）给 repo_path 打标，标签存在 ~/.commit-logs/labels.json，改标签会对该仓库全部历史记录立即生效，便于按「组」过滤。
数据维护：可手动 record 最新 commit、删除或更新部分字段（branch、subject、body、repopath、reponame 等），必要时 reset 数据目录。

适用边界与注意点

首次使用前必须按 references/ONBOARDING.md 完成环境配置；流程要求 Agent 先问清使用意图（单仓 / 多仓 / 全局），再执行对应步骤，不要一次性跑完所有命令。
Hook 只覆盖已安装 hook 的仓库；未 hook 的历史不会自动回填，除非手动 record 或另行扫描发现仓库。
可通过 ~/.commit-logs/config.toml 配置排除列表；CLI 本身经 uv tool install 安装，与 ~/.commit-logs 下的数据目录分离。