recap 是一个会话定位与意识类技能，目标是帮助使用者快速定位上下文，默认提供丰富的背景信息，并支持在会话中途通过 --now 进行状态感知。
用途
recap 适用于以下场景：开始一个新的会话、在 /jump 之后、丢失了当前所处位置、需要切换工作上下文时使用。它帮助使用者快速恢复对项目、任务与 Git 状态的认知。
主要能力
recap 提供四种使用方式：
- /recap —— 默认丰富模式：输出回顾摘要、交接内容、任务轨道和 Git 状态。
- /recap --quick —— 极简模式：仅输出 Git 状态与焦点，不读取文件内容。
- /recap --now —— 会话中途模式：基于 AI 记忆输出时间线与跳转记录。
- /recap --now deep —— 会话中途深度模式：在 --now 基础上增加交接、任务轨道与关联信息。
使用方式
默认丰富模式会运行 recap-rich.ts 脚本，脚本读取回顾摘要、交接内容、任务轨道和 Git 状态，随后由 LLM 补充“接下来做什么”的 2 至 3 个选项。脚本还会自动检测 .claude/INCUBATED_BY 面包屑文件，若存在则提示当前仓库由另一个 oracle 跟踪。Git 上下文部分检查未提交变更、分支情况、分支是否领先远程，以及是否处于干净的 main 分支。此外还会检查技能库是否过期：技能以 fork 模型复制到 ~/.claude/skills/ 中，修复不会自动传播，因此该检查会在定位阶段提示是否存在落后情况，仅在落后、安装时间超过 30 天、清单无法与磁盘对账或指定 --verbose 时输出，且从不阻塞，任何失败都以 0 退出并不打印内容。
技能还会按修改时间排序读取最新的 ψ/ 脑文件（排除 CLAUDE.md、README.md、.gitkeep），读取前 5 个文件，用于恢复与 /compact 相同的上下文。随后通过 dig.py 挖掘上一次会话记录，并在输出中包含“上次会话：时间段、时长、消息数、主题”。
快速模式仅运行 recap.ts，输出 Git 状态与焦点状态，耗时约 0.1 秒，然后由 LLM 补充后续选项。
会话中途模式（--now）无需读取文件，由 AI 从对话记忆中重建会话时间线，包含时间、时长、主题与跳转类型。跳转类型包括 spark（新想法）、complete（完成并继续）、return（回到已搁置话题）、park（有意暂停）、escape（回避困难）。健康会话以 spark 和 complete 为主，过多 escape 是回避模式的警示信号。深度模式在此基础上增加“从哪来、正在做什么、更大的线索”、待办表格（Now / Soon / Later）、关联信息（模式、学习点、oracle）、我的解读与下一步行动。
强制核验
recap 要求在任何输出“待办”表格或“下一步行动”建议之前，必须对每一条待办声明进行现实核验。交接文档、回顾和记忆文件是时间点上的声明，不是实时状态；在上一会话结束到本次会话开始之间，工作可能已经完成、PR 可能已合并、文件可能已复制。核验方式包括：检查文件是否已存在于目标路径、用 gh pr view 查看 PR 状态、用 git log origin/X..X 检查分支是否有待推送提交、在文件中 grep 模式、用 gh issue view 查看 issue 状态、检查迁移表等。核验结果分为已完成（从待办中移除）、仍待处理（保留在表格中）、部分完成（拆分为剩余子项）、无法核验（标记为未核验，不声明状态）。若交接待办列表与现实出现超过一项的分歧，需显式展示修正表。
会话上下文与人口统计
recap 脚本会自动检测并显示当前会话：扫描 ~/.claude/projects/[编码后的路径]/*.jsonl 找到最近的会话文件，提取短 ID 与起始时间戳的经过时长。若检测失败则静默跳过。若 CLAUDE.md 中包含 /awaken 向导 v2 生成的人口统计信息，则在任意模式的时间戳后追加一行，包含 oracle 名称、代词、人类名称、代词与语言偏好。若不存在则静默跳过。
限制与规则
硬性规则包括：只进行一次 bash 调用，不并行多次调用；不使用子代理，全部在主代理中完成；提问而非建议，使用“下一步做什么？”而不是“你应该……”；在报告待办前必须核验；引用仓库文件时打印以 / 开头的绝对路径。
哲学理念为：检测现实、暴露阻塞、提供方向，即“不只是时钟，而是地图”。版本为 8.0，更新于 2026-02-10。
关于安装方式、收费情况、价格、支持的平台等具体信息，当前资料暂未提供。