convez.ai
SkillAutomaçãoIntermediário
johnson-xue

Summoner — Framework de Orquestração de IA

johnson-xue/summoner

Orquestração de workflows IA com checkpoints, memória e revisões

Ver no GitHub
BomPluginScore · de 0 a 100

Framework portável para orquestração de workflows com agentes IA, que adiciona checkpoints entre fases, revisões pós-execução e cadeia de memória que recupera automaticamente soluções anteriores. Funciona como um Makefile para fluxos de trabalho com IA, prevenindo saltos de diagnóstico e repetição de erros.

Instalação

$npx convez-ai johnson-xue/summoner

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
0
Saúde
100%
Último commit
há 2 dias
Versão
v0.5.0
Issues abertas
1
Contribuidores
2

Casos de uso

  • Automatizar fluxos de correção de bugs com diagnóstico estruturado e revisão
  • Coordenar workflows de desenvolvimento de features com fases definidas
  • Implementar processos de revisão de código com memory chain de soluções passadas
  • Orquestrar operações em produção com checkpoints e go/no-go decisions

Veredito

Summoner resolve um problema real — agentes IA sem processo pulam diagnósticos e repetem erros. O framework adiciona estrutura, memória e checkpoints humanos em pontos críticos. Implementação sólida (Go + SQLite), multiplataforma, e com suporte a Claude Code, Cursor e outras IDEs. Recomendado para equipes que automatizam workflows complexos com agentes.

README

A tradução para o português deste README ainda está na fila.


AI coding agents skip diagnosis, forget reviews, and repeat mistakes. Summoner adds a process layer — checkpoints between phases, post-game reviews, and a memory chain that auto-recalls past fixes.


Quick Start

Prerequisites: Go ≥ 1.16 · sqlite3 CLI (pre-installed on macOS; apt install sqlite3 on Ubuntu/Debian)

In Claude Code:

/plugin marketplace add johnson-xue/summoner
/plugin install summoner@summoner-marketplace

Then in your project (hooks work immediately — pre-compiled for macOS/Linux):

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}')

Restart Claude Code — hooks activate on the next session start.

Alternative: git clone https://github.com/johnson-xue/summoner.git ~/.claude/plugins/summoner/ — same result, no marketplace needed. If on an unsupported platform: cd ~/.claude/plugins/summoner/hooks && make build.


How It Works

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

Phase 0   Memory — auto-recalls past bug patterns
Phase 1   Diagnosis — root cause (iron law: never skip)
   ⏸️     Checkpoint → [enter] continue  [skip] skip  [recall] redo  [stop]
Phase 2   Reproduce — Prove-It test (auto-skipped for config-only fixes)
Phase 3   Fix — apply the fix
Phase 4   Verify — run test suite
Phase 5   Review — code review
   📋     Post-Game Review — 5-type questionnaire, auto-journaled to SQLite

Commands

CommandDoes
/summoner:fixBug fix: diagnose → reproduce → fix → verify → review
/summoner:newFeature: define → plan → implement → test → review
/summoner:shipPre-launch: fan-out 1-3 reviewers → merge → go/no-go
/summoner:debugDiagnosis only — no code changes
/summoner:opsServer operations (delegated to project skill)
/summoner:reviewStandalone code review

Platform Support

CommandsMemoryHooks
Claude Code✅✅ SQLite✅ Go
Gemini CLI✅✅ bash—
OpenCode✅✅ bash—
Cursor / Windsurf / Copilot / Aider✅✅ bash—

Token Cost

WorkflowTokensvs Direct
/summoner:fix (with memory)~9,300+86%
/summoner:fix (no memory hit)~8,300+66%
/summoner:debug (diagnose only)~4,300+35%

Multi-step workflows → Summoner. Single-step tasks → direct skill.


Install Size

63 files · 19 core · compiled hooks ~7.5 MB · zero external deps beyond Go + SQLite3


Feedback Needed

Summoner is in early development (v0.1.2). Your feedback shapes its direction.

WhatWhere
Bug reportGitHub Issues — include version, platform, and what you expected
Feature requestGitHub Issues — tell us your use case and current workaround
Questions / IdeasGitHub Discussions — Q&A, ideas, show your setup
Known IssuesSee v0.1.2 Release Notes for current limitations

Why report? Every issue you file teaches Summoner what real-world AI workflows need. Even a single sentence helps — "I tried X, expected Y, got Z."


Related


MIT © Jingshan Xue

Ver o original no GitHub

Bom para

Relacionados