mcpField
C
capture

capture

github.com/sharpdeveyeAgent 工作流592238 次安装26 周前更新
代码仓库

关于 capture

capture 是 Maestro 的技能，可将会话工作记录为持久摘要和决策日志，供后续会话参考。它整理命令、决策、文件变更、问题及可执行的后续步骤。

主要功能

  1. 01整理命令、决策、文件、问题和后续步骤
  2. 02创建带日期的会话摘要文件
  3. 03向决策日志追加记录
  4. 04通过检查清单核对上下文

适用场景

  1. 01在工作会话结束时保存项目上下文
  2. 02记录决策与文件变更以供之后查看
  3. 03为下次会话列出可执行事项

安装

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

$npx skills add https://github.com/sharpdeveye/maestro --skill capture

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

详细介绍

强制准备

调用 /agent-workflow — 其中包含工作流原则、反模式和上下文收集协议。继续之前，请遵循该协议 — 如果尚无工作流上下文，必须先运行 /teach-maestro。

将当前会话的工作记录到持久摘要中。这会创建一份可跨会话保留的记录 — 未来的命令可以引用此处发生的内容。

要记录的内容

阅读对话历史并确定：

  1. 运行的命令 — 调用了哪些 Maestro 命令，以及调用顺序
  2. 作出的决策 — 架构选择、接受的权衡、采用的模式
  3. 更改的文件 — 创建、修改或删除了哪些文件
  4. 发现的问题 — 发现的错误、缺口或风险
  5. 后续步骤 — 接下来应采取的具体行动
输出格式

在 .maestro/sessions/{date}_{topic}.md 创建会话摘要文件：

# Session: {topic}
Date: {YYYY-MM-DD}

## Commands Run
- /diagnose → Score: 18/25
- /fortify → Added retry logic to API handlers
- /evaluate → Verified with 3 test scenarios

## Decisions
- Chose retry-with-backoff over circuit breaker (simpler, sufficient for current load)
- Kept synchronous error handling (async not justified yet)

## Files Changed
- `src/api/handler.ts` — added retry wrapper
- `src/middleware/auth.ts` — added input validation
- `tests/api.test.ts` — new test file

## Open Issues
- Rate limiting not yet implemented (deferred to next session)

## Next Steps
1. Run `/guard` to add rate limiting
2. Run `/evaluate` with adversarial test cases

同时在 .maestro/decisions.jsonl 中追加一条记录此次摘要的决策条目。

会话记录检查清单
  • 列出本会话中的所有命令
  • 记录关键决策及其理由
  • 列出更改的文件并简要说明
  • 记录尚未解决的问题（不要遗漏）
  • 后续步骤具体且可执行
  • 摘要已保存到 .maestro/sessions/
建议的下一步

记录完成后，下一次会话应从 /recap 开始以恢复上下文，然后继续执行上面列出的后续步骤。

绝对不要：

  • 将原始提示词或完整的大模型输出保存在会话文件中
  • 覆盖现有会话文件 — 应创建新文件
  • 跳过“后续步骤”部分 — 这是记录具有价值的关键
  • 未先阅读对话历史就进行记录
  • 未经用户调用此命令就自动记录

评论

支持 Markdown