session-history 是 rohitg00/agentmemory 提供的一个技能，用于以清晰的时间线形式展示本项目近期历史会话中发生的事情。当用户提出“上次我们做了什么”“会话历史”“过去……”等问题时，可以启用该技能。
用途
该技能面向“回顾项目近期活动”的需求：把该项目的过往会话按时间线方式列出，帮助用户快速了解最近做过哪些工作、产生了哪些决策和代码观察。
快速开始
使用 memory_sessions 工具进行查询，参数示例如下：
memory_sessions { "project": "<current-project-id>", "limit": 20 }
预期输出示例：
7f3a9c2 · app · 2026-06-07 09:00 · completed · 14 obs
- decision: Rotate refresh tokens on every use b21d004 · app · 2026-06-05 14:00 · completed · 9 obs
- code: limit.ts counts per-IP
为什么只展示返回内容
只展示工具返回的会话和观察。空历史是一个真实答案，绝不是编造过往工作的提示。
工作流程
使用宿主机记录的精确项目标识，并将其传给 memory_sessions；如有要求还需传入 agentId。如果项目标识未知，可使用 nextCursor 翻页浏览会话，在选择最近 20 条之前，按目录边界匹配规范化后的 cwd，绝不能用另一个项目替代。
每一页都要保留范围过滤条件；在达到请求数量或 nextCursor 为 null 时停止。当显示的历史只是部分页面时，需要明确说明。展示时按时间倒序排列，包含会话 id（前 8 位）、项目、开始时间、状态。
对于带有观察的会话，展示关键亮点（类型加标题）。
注明每个会话的观察总数。
当存在会话摘要时，呈现其标题和关键决策。
反面模式
错误做法：工具只返回两个会话，却描述成“几个稳步推进的会话”，并加入自己记忆中来自对话的其他会话。
正确做法：精确展示返回的两个会话，每个都带有真实 id、状态和观察条数。
检查清单
- 展示的每个会话都来自工具响应。
- 在选择展示窗口之前，已核对项目/目录范围。
- 顺序为倒序时间。
- 每个会话的观察条数与响应一致。
- 没有编造或合并任何会话或亮点。
相关技能
- recap：相同数据按日期分组并带亮点。
- handoff：直接进入最近的会话。
- recall：按主题跨所有会话搜索。
故障排查
如果 memory_sessions 不可用，请参阅 TROUBLESHOOTING.md。