用途
retro 是一个每周工程回顾技能，用于分析仓库的提交历史、工作模式和代码质量指标，生成一份完整的工程回顾报告。它面向以编程智能体作为效率杠杆的资深 IC 或 CTO 级构建者，并能识别当前执行命令的用户，对每个贡献者做逐人分析。
主要能力
- 时间窗口参数：默认最近 7 天；可指定 24h、14d、30d；支持 compare 模式对比当前窗口与之前等长窗口。
- 数据采集：并行运行多条 git 命令，获取提交时间、作者、文件变更、增删行数、测试文件与生产文件拆分、最常变更文件、PR 编号、按作者的文件热点、按作者的提交计数。
- 指标计算：提交数、贡献者数、合并 PR 数、插入/删除/净 LOC、测试 LOC 及占比、版本范围、活跃天数、会话数、平均每会话小时 LOC，并生成按提交数排序的贡献者排行榜，当前用户始终置顶并标注为 You。
- 提交时间分布：按太平洋时间显示小时直方图，指出高峰时段、空档、模式（双峰或连续）以及深夜提交簇。
- 工作会话检测：以 45 分钟间隔为阈值检测会话，分类为深度（50+ 分钟）、中等（20-50 分钟）、微型（<20 分钟），并计算总活跃编码时间、平均会话时长、每小时活跃时间的 LOC。
- 提交类型分解：按 conventional commit 前缀（feat/fix/refactor/test/chore/docs）统计百分比，若 fix 比例超过 50% 则标记为快速修复模式。
- 热点分析：列出前 10 个最常变更文件，标记高频变更文件、测试与生产文件对比、VERSION/CHANGELOG 频率。
- PR 规模分布：按 LOC 分箱为 Small、Medium、Large、XL，XL 需标记文件数。
- 专注度评分与一周最佳发布：计算提交触及最常变更顶层目录的百分比；自动识别窗口内最高 LOC 的 PR 并高亮。
- 团队成员分析：对每位贡献者计算提交与 LOC、关注领域、提交类型组合、会话模式、测试纪律、最大发布；对当前用户做最深入分析，对队友给出 2-3 句工作描述、具体表扬与一条成长建议。
- AI 协作说明：解析 Co-Authored-By 行，将 AI 协作者（如 noreply@anthropic.com）作为单独的 AI 辅助提交指标，不纳入团队成员。
- 周同比趋势：当窗口 >= 14 天时，按周分桶展示提交、LOC、测试比例、fix 比例、会话数趋势。
- 连续提交天数：同时统计团队连续提交天数和当前用户个人连续提交天数。
- 历史加载与对比：保存前检查 .context/retros/*.json，若存在最近快照则计算关键指标差值并展示 Trends vs Last Retro。
- 保存快照：按日期与序号保存 JSON 到 .context/retros/，包含日期、窗口、指标、作者、版本范围、连续天数、可推文摘要等字段。
使用方式
由用户调用，命令形式为 /retro，可附带参数：
- /retro — 最近 7 天（默认）
- /retro 24h — 最近 24 小时
- /retro 14d — 最近 14 天
- /retro 30d — 最近 30 天
- /retro compare — 当前周期对比之前周期
- /retro compare 14d — 使用显式窗口进行对比
参数校验：若参数不匹配数字加 d/h/w、compare 或 compare 加数字加 d/h/w，则显示用法说明并停止。
运行时会先 fetch origin、识别当前用户；所有 git 命令使用 --since 查询，时间统一以太平洋时间（TZ=America/Los_Angeles）呈现。
适用场景
适用于仓库级工程回顾，尤其是团队协作且提交活跃的项目；对单人仓库会跳过团队分解，作为个人回顾处理。报告结构包含可推文摘要、工程回顾日期范围、汇总表、与上次回顾的趋势对比、时间与会话模式、发布速度、代码质量信号、专注与亮点、你的这一周、团队分解、团队 Top 3 成果、3 项改进、下周 3 个习惯、周同比趋势。输出约 3000-4500 词，使用 markdown 表格和代码块展示数据，正文用叙述。
限制
- 依赖 git 仓库与 origin/main 分支的提交历史。
- 时间窗口、会话检测阈值、PR 规模分箱等为技能内置默认值，资料未提供可配置选项。
- 会话与 PR 规模基于提交记录估算，并非来自平台真实 PR 数据。
- 团队分析需多人提交，单人仓库跳过团队部分。
- 历史对比依赖 .context/retros/ 下已有 JSON 快照，首次运行无对比。
- 收费、价格、平台支持范围等，资料暂未提供。