用途:为指定时间窗口生成结构化的 Git 工程回顾,属于只读分析,除可选的 JSON 快照外不修改任何文件。
主要能力:检测默认分支与时区;采集提交哈希、作者、日期、主题、文件变更与增删行数;计算提交数、贡献者数、变更文件数、净增删、平均提交大小;按星期与小时统计时间分布;以 2 小时间隔划分工作会话;按 conventional commit 前缀及 diff 启发式分类提交类型;识别被修改最多的热点文件(超过 50% 提交触及则标记);在 GitHub 远程下用 gh 分析已合并 PR 的规模分布与评审/合并周转;计算聚焦分数(触及不超过 3 个文件的提交占比);按作者汇总;与 .engineering-retros/ 中最近快照做周对比;保存 JSON 快照并生成叙述性总结。
使用方式:命令为 /engineering-retro [TIME_WINDOW] [PATH_SCOPE]。TIME_WINDOW 可选 24h、7d(默认)、14d、30d;PATH_SCOPE 可选,用于限定子目录以支持 monorepo,例如 services/api。示例:/engineering-retro、/engineering-retro 30d、/engineering-retro 14d services/api。
限制:默认分支检测失败时中止,不做猜测;时区与分支均动态检测,不硬编码;非 GitHub 远程或 gh 不可用时跳过 PR 分析并在输出中说明;作者拆分仅用于认可工作,不做个人绩效评判;快照仅存于 .engineering-retros/,需确保其加入 .gitignore;所有 git 命令在提供范围时须包含 -- $PATH_SCOPE。