用途：learn-retro 对 git 活动与决策质量生成回顾报告，支持 --lens git、--lens decision、--lens all（默认）三种视角。
主要能力：git 视角统计提交、代码行、测试比例、churn、活跃天数、会话（按 >2 小时间隔聚类）、文件热点与按作者分布，并在存在历史 retro-*.json 时做趋势对比；决策视角从 wiki、specs、git log、阶段上下文与 learnings.md 收集决策，建立含 id、标题、来源、依据、备选与证据的注册表，再以 technical、cost、hindsight 三个并行智能体视角评分，并做生命周期分类（Validated/Aging/Questionable/Stale/Reversed）。
使用方式：git 视角可用 --days N（默认 7）、--author、--area、--compare；决策视角可用 --phase、--tag、--id。输出写入 .workflow/knowhow/KNW-retro-{date}.md 与 KNW-retro-{date}.json。若未加 -y，spawn 评估智能体与追加 learnings 前均需经 request_user_input 确认。
限制：所有文件写入仅限上述两个 retro 文件与 .workflow/specs/learnings.md，绝不修改源代码、git 历史或路径之外文件；分析为只读。git 视角要求处于 git 仓库且有窗口内提交（E001/E002），否则阻断；决策视角未找到决策（E003）或用户拒绝 spawn 时阻断。需遵循各阶段 Gate 与智能体终止约定（必须调用 report_agent_job_result 一次）。收费、平台与安装方式资料暂未提供。