用途:recap 用于回顾当前项目最近的智能体会话,按本地日历日期分组,并为每次会话提取要点观察。当用户要求“recap”或询问最近做了什么时使用。
主要能力:通过 memory_sessions 获取会话列表,再对每个保留下来的会话调用 memory_recall 获取要点。输出包含日期、会话 id 前 8 位、标题或首个提示、观察数量、状态,以及要点条目,最后给出“N sessions across M days, K observations.”的统计行。
使用方式:时间窗口由 $ARGUMENTS 解析,today 为当前本地日期,this week 为最近 7 天,last <n> 或纯数字为最近 N 次,留空为最近 10 次。先调用 memory_sessions { "project": "<current-project-id>", "limit": 30 },已知项目标识符时使用精确记录值,并传入请求的 agentId;随后用 nextCursor 以相同过滤条件翻页,直到覆盖请求窗口或分页结束。项目标识符未知时,先跨页按目录边界匹配规范化 cwd,再应用时间或数量窗口,并按 startedAt 降序排序。对每个会话调用 memory_recall { "query": "<top concepts>", "project": "<current-project-id>", "limit": 3 },保留 project/agent 范围,并确认结果属于该会话后再纳入。
适用场景:需要快速了解某项目近期智能体会话概况、按日期查看会话要点、生成简短回顾时。
限制:只应汇总工具实际返回的会话和观察;空窗口就是真实答案,不应凭空编造活动。若 memory_sessions 或 memory_recall 不可用,参见 TROUBLESHOOTING.md。相关技能包括 handoff、session-history、recall。