用途：该技能从 git 历史中重建“为什么”类文档，与只分析当前代码的 generate-docs 互补；后者回答“现在有什么”，它回答“如何演变成现在这样、为什么”。
主要产出：架构决策记录（ADR），从大型重构、依赖变更或结构调整中识别；模块编年史，记录各模块引入时间、重大变更与增长模式；模式演进，如 callback→promise→async/await 迁移；贡献者地图，按提交集中度标注代码归属。
执行模型：第一阶段由主智能体仅用 git 命令收集元数据，成本低；第二阶段派发 doc-explorer 子智能体，依据元数据撰写回溯文档。
工作流：先用 git log --oneline | wc -l、git shortlog -sn --no-merges 等评估历史范围；再用 --shortstat、--diff-filter 等扫描大提交、依赖变化、新目录、重命名与合并模式；结合提交信息与 --stat 分析关键事件；为每个模块建立时间线；检测模式演进；最后生成 docs/retrospective.md 与 docs/adrs/ 下的 ADR 文件，标题结构须与 adr-create 一致；最后向用户确认推断是否准确。
规则与限制：只使用 git 元数据，不读取历史提交的完整文件内容；推断需标注“appears to be”等措辞，不得编造；提交信息是“为什么”的主要来源；聚焦决策而非变更；按时间顺序呈现；超过 1000 次提交时只关注最重要的 10–20 个事件；少于约 50 次提交的项目不建议使用；不使用内置 explore 子智能体。其他细节暂未提供。