SuperAPI AI 工具集

recall

编程与开发

查看项目

更新于 11-19 03:06

技能介绍

用途

Recall 用于在开始或恢复工作前,重建用户近期的工作上下文,并交回一份紧凑的简报:当前事情进展到哪一步、接下来该做什么。它强调简洁、切题,只读取当前范围所需的内容,读完即止。

上下文来源

Recall 认为上下文存在于两类记录中:

  • 自己的聊天记录:保存做过的事和做过的决定。
  • 共享记录:保存同一份代码在其他人名下发生的一切,包括用户反复报告的症状、已发布又被回滚的修复、仍在生产环境报出的错误。共享记录由 why 技能检索,覆盖源代码管理、问题跟踪器、聊天与 issue 频道、长文档以及错误跟踪系统。带有长期缺陷历史的功能,其大部分故事都在共享记录里,因此不能只凭自己的对话记录重建。

聊天记录路径为 ~/.cursor/projects/<slug>/agent-transcripts/<uuid>/<uuid>.jsonl,其中 <slug> 是工作区路径去掉开头斜杠、并把每个 / 换成 -(例如 /Users/you/proj 变为 Users-you-proj)。每行是一条聊天消息。

任务分类与路由

  • 恢复某一个特定的先前对话:属于 session-pickup 剧本,不是 Recall。
  • 把习惯固化为持久技能:属于 automate-me。
  • 面向人阅读的工作总结:是另一项任务。
  • Recall 的定位:在行动前跨近期多个对话加载工作上下文。若用户已给出完整的状态胶囊(路径、分支、改动),直接使用,跳过挖掘。

使用方式

  1. 搜索前锁定范围:确定时间窗口(「近期」是明确区间,默认最近 7 天)、主题(如已指定)和工作区(默认当前活动工作区;未经要求绝不读取其他项目的对话记录)。复述范围,绝不把「全部」悄悄改成「最近 N 条」。

  2. 并行检索聊天记录:在快速、廉价的模型上启动并行子代理,各自处理语料的一个切片。要求每个子代理:

    • 按真实修改时间(ls -t)排序候选,绝不按 UUID 名称排序;
    • 先 grep 主题,再只读取匹配的对话中相关区域;
    • 跳过当前对话以及明显噪声(subagent、eval、test 对话)。 每个子代理按统一结构返回,每个对话一块:主题、用户目标、决定、未结事项、困难与纠正、产出物(PR、工单、分支),并逐项标注对话 UUID。仅有一两个对话时,跳过并行,直接搜索。原始记录留在子代理中,主线程只拿到它们的发现。
  3. 清扫共享记录:只要主题点明功能、文件、子系统、领域或缺陷,就默认执行此步(不是可选项);「我在 X 上的工作」也不豁免。交给 why 技能的按来源调查者,但把问题从「为什么这样实现」转向「当前状态如何、试过什么但没站住、用户仍在报告什么」。复用其逐来源剧本,与聊天挖掘并行运行调查者,并继承其原则:每个来源一名调查者,无结果也是结果,某个 MCP 不可用则跳过并说明。把结果并入简报。仅当是纯粹的活动回顾且没有具名目标(如「我这周做了什么」)时,才跳过此步。

  4. 用实时状态核对:把挖掘与清扫中出现的 PR、分支、工单,用 git 和 gh 检查。当答案取决于代理实际做了什么(运行的工具、读过的文件、遇到的错误)时,读取完整对话记录,而不只是裁剪过的本地副本。

  5. 按输出契约撰写简报:按线程分组,紧扣具名主题。

输出契约

顺序为:先胶囊,再线程状态,再问题,最后下一步。更深的细节放在下方或被裁掉。

  • 胶囊:最多 5 条要点,说明这项工作是什么、整体处于什么状态。
  • 线程:每行一个,前缀为恰好一个状态标签:[merged #N]、[open PR #N]、[in flight <branch>]、[verified, uncommitted]、[reverted #N] 或 [planned, not started]。没有标签的线程视为未完成,必须打标签。
  • 问题:最多 5 个反复出现的问题。包含用户持续报告的症状,以及任何发布后又被回滚的修复,让下一次尝试从上次失败的地方开始。
  • 下一步:一个最有用、具体的下一个动作。

相邻功能或工单除非会阻塞当前事项,否则不纳入。当胶囊与线程行超出屏幕时,先裁细节,后裁线程。简报经由 unslop 技能撰写,聊天发现按 UUID 引用,共享记录发现按来源引用(PR 编号、工单 ID、聊天永久链接、错误跟踪器 issue),任何公开输出前先脱敏私人上下文。

回复内容即按上述契约撰写的简报。

适用场景

  • 隔了一段时间后继续同一项功能开发。
  • 跨多个近期对话汇总某主题的进展与未结事项。
  • 接手带有长期缺陷历史的功能前,了解已试过什么、什么被回滚、用户仍在报告什么。

限制

  • 仅针对单个具体先前对话恢复时,应使用 session-pickup,不是 Recall。
  • 把习惯固化为持久技能属于 automate-me;人力可读的工作总结是另一项任务。
  • 默认不读取当前活动工作区以外的对话记录。
  • 纯粹活动回顾且无具名目标时,不执行共享记录清扫。
  • 依赖本地聊天记录路径与 MCP 可用性;不可用的 MCP 会被跳过并说明。