用途
retro 用于从 Git 提交历史中读取近期开发活动，把代码库的变化转化为可分享的团队回顾。它的角色设定是工程经理：关注趋势、产出节奏和潜在的疲劳信号，并将提交记录整理为具体、可执行的观察与建议。
主要能力
- 时间窗口解析：支持
7或空参数（默认 7 天）、14（14 天）、30（30 天）、24h（1 天）。 - 原始数据采集：通过 git 命令收集提交元数据、文件级统计、贡献者汇总、提交时间分布、热点文件（改动最多的文件），以及在 gh CLI 可用时获取已合并 PR 数据。
- 指标表计算：包括提交总数（非合并）、独立贡献者数、合并 PR 数、净代码行变更（新增/删除）、测试代码行占比、活跃天数、Feat/Fix/Refactor 等提交类型占比。
- 多轮分析：涵盖每小时提交分布、工作会话识别、提交类型拆解、热点分析、PR 规模分布、专注度评分、每位贡献者的深入分析、周环比趋势、连续开发记录，以及与上次快照的历史对比。每轮分析会给出需要标记的信号及触发阈值。
- 快照保存：将当次指标写入
.hamster/retros/{YYYY-MM-DD}.json，用于后续回顾的趋势对比。 - 回顾叙述生成：输出约 1500-3000 字的叙述，结构包括一句话总结、指标汇总表、与上次回顾的趋势对比、时间与会话模式、交付速度、代码质量信号、专注度与亮点、团队逐人分析、前三项成果、三项改进建议、下周三个习惯建议。
使用方式
运行前项目必须存在 .hamster/ 目录，否则会提示需要初始化 hamster 管理的项目并停止。命令参数为时间窗口，例如 7、14、30 或 24h。工具会并行执行 git 命令采集数据；若窗口内没有提交，会报告“无活动”并建议扩大窗口。gh CLI 不可用时会跳过 PR 数据并在输出中注明；没有历史快照时跳过历史对比并注明这是首次回顾；日期命令兼容 macOS 与 Linux 两种语法。
适用场景
- 每周运行（7 天窗口）获取可执行的团队洞察。
- 14 天与 30 天窗口适合冲刺回顾和月度复盘。
- 生成的叙述可直接分享到团队沟通工具、文档或站会。
限制
- 该命令为只读操作，不修改代码，也不执行除保存快照 JSON 外的 git 操作。
- 快照保存在
.hamster/retros/，每次运行会覆盖同日期快照，可安全重复运行。 - 依赖项目已有的 Git 历史与
.hamster/目录；PR 相关分析依赖 gh CLI 可用性。