用途：在长时间智能体会话（数小时、多工单、数千行改动）结束后，生成一份有边界、可快速阅读的复盘报告，替代无用的控制台尾部输出。核心原则：不写读 git log 就能得到的内容，而是以用户自己的语言说明“现在能做什么以前不能做的事”，并给出可直接运行的命令，提交记录只作为脚注证据。
主要能力：按五个步骤执行——解析时间窗口（不猜测，从 .recaps/entries/、会话记录、reflog 逐级解析并校验）；探测边界（检出基线版本与 HEAD，对比 --help、导出符号、路由、配置键、必需环境变量、测试名、迁移等，作为能力的主要来源）；采集 diff 无法体现的信息（看板变动、其他仓库、孤立工作、决策与拒绝、线上系统实测）；按模式撰写能力卡片（标题、可运行调用、一句话 before、≤3 条证据，缺 before 或调用则降级）；渲染并记录到 .recaps/。
报告结构：现在能做什么、哪里需要你、什么坏了及不可信之处、依赖相关变更（强制渲染）、关于线上系统的发现、决策与拒绝、HEAD 健康状态一行、证据、来源窗口一行。空段落省略，但第 3、4、7 段始终渲染。
用法：优先在独立会话中复盘已结束的会话，如 recap --session <id> 或 recap --since <t>；会话内运行只是便利，需更多依赖探测而非自身记忆。默认写入窗口解析所在仓库的 .recaps/，不默认提交；--private 写入 ~/.local/state/recaps/<repo>/。
限制：能力层 ≤200 词，整体 ≤600 词，能力卡片 ≤7 张，最多一张图表；无证据的声明需标注或删除；不得编造提交或分支用途。C=0（无新能力）是正常结果，应如实说明。具体安装方式与更多参数暂未提供。