mcpField
R
recap

recap

github.com/rohitg00Agent 工作流30.0k13.9k 次安装今天更新
代码仓库

关于 recap

recap 是依据返回的记忆数据，按指定时间范围整理项目会话的 Agent 技能。它按日期分组，并汇报会话详情、经核实的要点和统计总数。

主要功能

  1. 01解析指定时间范围
  2. 02按项目和 Agent 筛选会话
  3. 03按日期分组会话
  4. 04展示核实要点和统计总数

适用场景

  1. 01回顾项目最近一周
  2. 02检查指定时间段内的会话
  3. 03汇总会话要点与数量

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/rohitg00/agentmemory --skill recap

安装后在 Claude Code 中输入/recap确认已加载。

附带文件EXAMPLES.mdTROUBLESHOOTING.md

详细介绍

用户希望获取一份回顾。时间范围参数：$ARGUMENTS

快速开始

memory_sessions { "project": "<current-project-id>", "limit": 30 }

然后，对于每个保留的会话：memory_recall { "query": "<top concepts>", "project": "<current-project-id>", "limit": 3 }。 如果指定了 Agent，请在两次调用中传入相同的 agentId。

预期输出：

2026-06-07
  7f3a9c2 · "Auth refresh rework" · 14 obs · completed
    - [8] Rotate refresh tokens on every use
3 sessions across 2 days, 41 observations.

原因

只总结工具返回的会话和观察结果。时间范围内没有内容也是有效答案，不要凭空编造活动。

工作流

  1. 解析 $ARGUMENTS：today = 当前本地日期；this week = 过去 7 天； last <n> 或纯数字 = 最近 N 条；为空 = last 10。
  2. 已知项目的确切记录标识符时，使用该标识符和请求的 agentId 调用 memory_sessions。使用相同的筛选条件跟进 nextCursor，直到覆盖请求的时间范围或没有更多页面。如果项目标识符未知，则先跨页面按目录边界匹配规范化后的 cwd，再应用时间／数量范围。按 startedAt 降序排序。
  3. 按本地日历日期（YYYY-MM-DD）分组保留的会话。
  4. 每个会话列出 id（前 8 位）、标题或首条提示词、观察数量和状态。使用 memory_recall 获取重点，保留项目／Agent 范围，并在纳入结果前确认每条结果都属于该会话。
  5. 以“共 N 个会话，跨 M 天，K 条观察。”结尾。

反模式

错误：时间范围内没有内容，于是根据对话记忆总结出“高效地完成了一周的身份验证工作”。

正确：“该项目过去 7 天内没有会话。”

检查清单

  • 根据参数正确解析时间范围。
  • 会话已按当前项目的 cwd 筛选。
  • 重点来自 memory_recall，而非改写内容。
  • 汇总行反映所列出的实际数量。

另请参阅

  • handoff、session-history、recall：使用相同的会话数据，但视角不同。

故障排查

如果 memory_sessions 或 memory_recall 不可用，请参阅 TROUBLESHOOTING.md。

评论

支持 Markdown