关于 recap
recap 是 Maestro 的技能,通过摘要最近的会话文件和决策来恢复项目上下文。它突出未解决问题和具体后续步骤;没有会话文件时则总结近期决策。
主要功能
- 01读取最近的会话摘要
- 02检查决策日志中的近期记录
- 03突出未解决问题和可执行后续步骤
- 04没有会话文件时改为总结近期决策
适用场景
- 01在会话间隔后继续工作
- 02继续工作前查看待处理问题
- 03从近期项目记录中查找下一步
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ sharpdeveye/ maestro --skill recap安装后在 Claude Code 中输入/recap确认已加载。
详细介绍
必须进行的准备
调用 /agent-workflow — 其中包含工作流原则、反模式和 上下文收集协议。继续之前请遵循该协议 — 如果尚无工作流上下文,必须先运行 /teach-maestro。
快速恢复进度。Recap 会读取最近的会话文件和近期决策,告诉你上次进行到哪里,以及接下来要做什么。
数据来源
.maestro/sessions/— 读取最近的会话文件(按文件名日期排序).maestro/decisions.jsonl— 读取最近 5 条决策
如果没有会话文件,则读取最近 10 条决策并据此总结。
如果完全没有数据,则回复:"未找到会话历史记录。请在下次会话结束时运行 /capture,开始记录。"
输出格式
┌─────────────────────────────────────┐
│ LAST SESSION RECAP │
├─────────────────────────────────────┤
│ Date: YYYY-MM-DD │
│ Commands: /diagnose → /fortify (2) │
│ Files: 3 changed, 1 created │
│ Outcome: Completed │
├─────────────────────────────────────┤
│ PICK UP HERE: │
│ 1. Run /guard — rate limiting │
│ 2. Run /evaluate — adversarial tests│
└─────────────────────────────────────┘
回顾规则
- 简洁明了 — 这是 30 秒内读完的内容,不是报告
- 以“从这里继续”部分开头 — 这是用户需要的内容
- 如果会话结束时仍有未解决的问题,请重点说明
- 指明具体文件和命令,不要含糊概括
回顾清单
- 已确定最近一次会话
- 用一行总结每条命令及其结果
- “从这里继续”部分包含具体、可执行的下一步
- 已指出上次会话中尚未解决的问题
建议的下一步
完成回顾后,运行“从这里继续”中列出的第一条命令,以接续上次的进度。
绝不要:
- 倾倒整个会话文件 — 应进行总结
- 不检查 decisions.jsonl 中近期活动就进行回顾
- 给出含糊的下一步(例如“继续工作”)— 应具体明确
- 假定当前对话中的上下文 — 只能使用持久化数据
评论
支持 Markdown