Summoner

像 Makefile 一样定义 AI 工作流。
框架动词固定。项目 skill 可替换。

version MIT macOS Linux

GitHub · English

它做什么

AI coding agent 能力很强,但缺乏纪律 — 跳过诊断、忘记审查、重复犯错。Summoner 加上流程层 — Phase 间强制暂停(checkpoint)、赛后复盘(post-game review)、自动检索历史经验的记忆链(Memory Chain)。

快速开始

git clone https://github.com/johnson-xue/summoner.git ~/.claude/plugins/summoner/
cd ~/.claude/plugins/summoner/hooks && make build
cd your-project
~/.claude/plugins/summoner/scripts/summoner-init.sh
~/.claude/plugins/summoner/scripts/init-memory-db.sh $(grep -A2 '^project:' summoner.yaml | grep 'name:' | head -1 | awk '{print $2}')

工作方式

/summoner:fix "线上报错 SC_ErrInnerLogic..."

Phase 0   记忆检索 — 自动匹配历史 bug pattern
Phase 1   诊断根因 — 铁律:禁止跳过
   ⏸️     Checkpoint → 继续 / 跳过 / 回城(重做) / 停
Phase 2   复现测试 — Prove-It 模式(纯配置修复自动跳过)
Phase 3   修复
Phase 4   验证 — 跑测试套件
Phase 5   审查 — 代码审查
   📋     赛后复盘 — 5 种问卷,自动写入 SQLite

命令

命令流程
/summoner:fix诊断 → 复现 → 修复 → 验证 → 审查
/summoner:new定义 → 计划 → 实现 → 测试 → 审查
/summoner:ship并行 1-3 个 reviewer → 合并 → 发版决策
/summoner:debug仅诊断 — 不改代码
/summoner:ops运维操作(委托给项目 skill)
/summoner:review独立代码审查

平台支持

平台命令记忆Hooks
Claude Code✅ SQLite✅ Go
Gemini CLI✅ bash
OpenCode✅ bash
Cursor / Windsurf / Copilot / Aider✅ bash

Token 成本

工作流Tokens开销
/summoner:fix(记忆命中)~9,300+86%
/summoner:fix(无记忆)~8,300+66%
/summoner:debug~4,300+35%
多步骤工作流 → Summoner。单步骤任务 → 直接调 skill。

Star History