Summoner：为AI Agent工作流打造的类Makefile编排框架

Summoner是一款AI Agent编排框架，通过检查点机制、事后复盘和记忆链功能，为AI编码工作流添加流程层，解决Agent跳过诊断、遗忘审查和重复犯错的问题。

• 原作者/维护者: johnson-xue
• 来源平台: GitHub
• 原始标题: summoner
• 原始链接: https://github.com/johnson-xue/summoner
• 发布时间: 2026年6月9日

---

当前AI编码Agent（如Claude Code、Cursor、Copilot等）在实际使用过程中普遍存在三个核心问题：跳过诊断、遗忘审查和重复犯错。当Agent遇到错误时，往往直接尝试修复而不深入分析根本原因；修复完成后很少进行系统性代码审查；同样的错误模式在不同会话中反复出现。

Summoner的设计理念正是针对这些痛点——它不是一个替代现有Agent的工具，而是为AI工作流添加一个流程层（process layer），通过结构化的阶段管理和记忆机制，让Agent的工作更加可靠和可追溯。

---

Summoner将自己定位为"AI工作流的Makefile"。就像Makefile定义了软件构建的各个目标和依赖关系，Summoner定义了AI任务的各个阶段和流转规则。其核心特性包括：

• 检查点机制（Checkpoint）：在关键节点暂停，允许人工介入决策
• 事后复盘（Post-Game Review）：任务完成后的结构化回顾，自动记录到SQLite
• 记忆链（Memory Chain）：自动调用历史修复模式，避免重复犯错
• 跨平台支持：Claude Code、Gemini CLI、OpenCode、Cursor/Windsurf/Copilot/Aider等

项目采用MIT许可证，代码量仅约7.5MB（63个文件，19个核心文件，编译后的hooks），零外部依赖（仅需Go + SQLite3）。

---

Summoner提供五个主要命令，覆盖从Bug修复到功能开发的完整场景：

这是最常用的命令，执行完整的五阶段修复流程：

1. Phase 0 - 记忆：自动检索历史bug模式
2. Phase 1 - 诊断（Diagnosis）：根因分析（遵循"铁律"：永不跳过）
   • 在此阶段会触发检查点，用户可选择：继续/跳过/重做/停止
3. Phase 2 - 复现（Reproduce）：Prove-It测试（配置类修复自动跳过）
4. Phase 3 - 修复（Fix）：应用修复方案
5. Phase 4 - 验证（Verify）：运行测试套件
6. Phase 5 - 审查（Review）：代码审查
   • 事后复盘：5类问题问卷，自动记录到SQLite

定义 → 规划 → 实现 → 测试 → 审查的完整新功能开发流程。

1-3名审查者的Fan-out审查 → 合并决策 → Go/No-Go判断。