recap
GitHub根据用户指令按日期汇总最近 Agent 会话及观察结果,支持灵活时间窗口解析,严格基于工具返回数据生成摘要,禁止臆造内容。
触发场景
安装
npx skills add rohitg00/agentmemory --skill recap -g -y
SKILL.md
Frontmatter
{
"name": "recap",
"description": "Summarize the last N agent sessions for the current project, grouped by date, with highlight observations per session. Use when the user asks \"recap\", \"what have we been doing\", \"today\", \"this week\", or wants a rollup of recent work.",
"argument-hint": "[last N | today | this week]",
"user-invocable": true
}
The user wants a recap. Time window args: $ARGUMENTS
Quick start
memory_sessions { "project": "<current-project-id>", "limit": 30 }
Then per surviving session: memory_recall { "query": "<top concepts>", "project": "<current-project-id>", "limit": 3 }.
When an agent is requested, pass the same agentId to both calls.
Expected output:
2026-06-07
7f3a9c2 · "Auth refresh rework" · 14 obs · completed
- [8] Rotate refresh tokens on every use
3 sessions across 2 days, 41 observations.
Why
Only summarize sessions and observations the tools returned. An empty window is a real answer, not a prompt to invent activity.
Workflow
- Parse
$ARGUMENTS:today= current local date;this week= last 7 days;last <n>or bare numeric = most recent N; empty =last 10. - Call
memory_sessionswith the exact recorded project identifier when known and the requestedagentId. FollownextCursorwith the same filters until the requested window is covered or pages end. When the project identifier is unknown, match normalizedcwdby directory boundary across pages before applying the time/count window. Sort bystartedAtdescending. - Group survivors by local calendar date (YYYY-MM-DD).
- Per session list id (first 8), title or first prompt, observation count,
status. Obtain highlights with
memory_recall, retaining project/agent scope, and verify each result belongs to that session before including it. - End with "N sessions across M days, K observations."
Anti-patterns
WRONG: window is empty, so you summarize "a productive week of auth work" from memory of the conversation.
RIGHT: "No sessions in the last 7 days for this project."
Checklist
- Window parsed correctly from the argument.
- Sessions filtered to the current project's cwd.
- Highlights come from
memory_recall, not paraphrase. - Totals line reflects the actual counts shown.
See also
handoff,session-history,recall: same session data, different lens.
Troubleshooting
See TROUBLESHOOTING.md if memory_sessions or memory_recall is not available.
版本历史
-
e01540e
当前 2026-10-19 02:22
强化项目上下文过滤逻辑,通过 cwd 精确匹配当前项目以隔离数据;新增对 agentId 的传递支持,提升多代理场景下的查询准确性。
- a8e7d19 2026-07-24 11:39


