mcpField
R
recall

recall

github.com/pwgulerAgent 工作流10745 次安装3 周前更新
代码仓库

关于 recall

recall 是一项在继续工作前重建项目近期上下文的技能。它指导 Agent 搜索会话记录和仓库历史、核实发现,并生成简洁且带引用的简报。

主要功能

  1. 01按项目和主题限定范围
  2. 02搜索并筛选会话记录
  3. 03核实分支、PR、提交和工单
  4. 04汇总状态、事项、问题与下一步

适用场景

  1. 01中断后恢复项目工作
  2. 02回顾某项功能或缺陷的既往决策
  3. 03确认先前修复在当前状态中是否仍有效

安装

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

$npx skills add https://github.com/pwguler/skills --skill recall

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

附带文件references/transcripts.md

详细介绍

在开始或继续工作之前,先还原当前进展,并简要汇报。只阅读主题所需的内容,然后停止。

快速路径:如果用户的消息中已经包含当前状态,就直接使用并跳过会话搜索。状态包括路径、分支和正在进行的更改。

  1. 明确范围,并用一行复述。默认查看最近 7 天,除非用户指定其他时间范围。若用户指定了主题,也要加入主题。项目范围是当前工作目录。只有用户提出要求时,才读取其他项目的会话。“全部”就表示全部。绝不要擅自缩小到最近几条,除非明确说明。
  2. 按你的 Agent 的 transcripts.md 中所述,查找本项目过往会话的记录。按修改时间排序(ls -t)。排除当前会话和子 Agent 运行记录。如果你的 Agent 没有可读取的会话记录,就说明这一点,并根据代码仓库及其历史记录开展工作。
  3. 先搜索,再阅读。对每份记录搜索主题,然后只阅读匹配的行。阅读 Agent 在对话轮次之前已撰写的摘要。当匹配行总数超过约 2,000 行时,将记录分配给多个子 Agent。每个子 Agent 为每个会话返回一个区块。区块包含主题、用户目标、决策、未解决事项、用户的更正和产物。产物包括分支、PR、提交和工单。每个区块都标注会话 ID。
  4. 当主题涉及某项功能、文件、区域或 Bug 时,也要执行 research 技能的历史追踪流程。了解当前状态、已尝试但未奏效的方法,以及用户仍在反馈的问题。
  5. 使用 git 和 gh,对照实时状态检查搜索中找到的每个分支、PR、提交和工单。通过会话条目查看 Agent 的操作:运行的命令和遇到的错误。绝不要推断。
  6. 将简报分为四个部分。当前进展最多包含五条要点。事项中每个事项单独占一行。每行必须以且仅以一个标签开头:[in flight <branch>]、[open PR #N]、[merged #N]、[reverted #N]、[done, uncommitted] 或 [planned]。问题最多包含五项:列出反复出现的问题。包括用户仍在提出的意见,以及后来被撤销的已落地修复。下一步是一项具体行动。

规则:

  • 聚焦主题。只有当相关事项阻碍当前工作时,才将其纳入。当简报超过一屏时,先删减细节,不要删减事项。
  • 为每条发现注明来源:会话需标注其 ID,历史记录需标注来源(提交、PR 或工单)。
  • 回顾时只读。不修改文件、分支或工单。
  • 对会话中发现的秘密信息进行脱敏。将令牌、密钥、密码或连接字符串替换为占位符。

评论

支持 Markdown