recall

用户希望回忆有关以下内容的过往上下文：$ARGUMENTS

快速开始

memory_smart_search { "query": "jwt refresh token rotation", "limit": 10 }

预期输出：

2 results across 2 sessions.
[importance 8] decision · "Rotate refresh tokens on every use" (session 7f3a9c21)
[importance 5] code · "limit.ts counts per-IP" (session b21d004e)

原因

只展示工具返回的内容。切勿捏造观察记录、会话 ID 或重要性评分。如果没有返回任何内容，请如实说明。

工作流

1. 使用用户提供的文本作为 query，并将 limit 设为 10，调用 memory_smart_search。 如果用户指定了特定仓库，则传入 project；如果用户要求查看某个 Agent 的历史记录，则传入 agentId。 对于明确保存的知识，使用 targetLayer: "memory"；对于捕获的活动记录，使用 targetLayer: "observation"。混合搜索时省略该参数。
2. 搜索结果较为简略。引用完整内容或描述来源前，使用选定的 ID 组成逗号分隔的 expandIds 字符串，并保留相同的项目、Agent 和层级筛选条件，再次调用 memory_smart_search。如果扩展失败或记录已不可用，请说明这一限制；仅有标题并不代表完整事实。
3. 按会话对扩展后的观察记录分组，并展示返回的类型、标题和叙述内容。仅当响应提供来源信息时才将其纳入。
4. 优先展示高信号观察记录（重要性 >= 7）。
5. 使用 memory_recall 时，在将空响应或缩短的响应视为知识缺失之前，先检查 matched_count、excluded_by_budget 和 content_truncated。使用相同的项目、Agent 和层级筛选条件，通过 memory_smart_search 的 expandIds 获取完整内容。当预算过小时，minimum_budget 会报告生成最简预览所需的预计预算。
6. 如果没有匹配项，请建议 2-3 个替代搜索词，然后停止。不要猜测。

反面示例

错误：结果为空，于是你凭空猜测“我们上周可能讨论过令牌过期”。

正确：“没有与该查询匹配的记忆。可以试试 refresh token、session expiry 或 auth rotation。”

检查清单

• 展示的每条观察记录都来自工具响应。
• 结果按会话分组，并按重要性从高到低排列。
• 空结果应触发替代搜索词建议，而非凭空编造。
• 不得转述或四舍五入会话 ID 或评分。

另请参阅

• remember：写入端；回忆会检索其存储的内容。
• recap、handoff、session-history：针对会话的同一数据视图。
• memory-discipline：何时应主动运行此搜索。

故障排除

如果无法使用 memory_smart_search，请参阅 TROUBLESHOOTING.md。