convez.ai
AgenteAutomaçãoAvançado
Lee-W

Maigo - Multi-Agent Workflow para Desenvolvimento

Lee-W/maigo

Multi-agent workflow com 5 personas para dev estruturado no Claude Code

Ver no GitHub
BomPluginScore · de 0 a 100

Framework de workflow multi-agent com personagens baseadas em MyGO!!!!! que orquestra exploração de código, planejamento, implementação, revisão e verificação. Funciona como plugin Claude Code, aplicando personas distintas (Explorer, Planner, Implementer, Reviewer, Verifier) para guiar o desenvolvimento end-to-end com validações automáticas.

Instalação

$npx convez-ai Lee-W/maigo

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
14
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 2 dias
Versão
v0.77.0
Issues abertas
0
Contribuidores
2

Casos de uso

  • Estruturar fluxo de desenvolvimento complexo com múltiplas fases de validação
  • Automatizar code review com critério rigoroso (Reviewer nega por padrão)
  • Explorar e planejar refatorações em codebases desconhecidas
  • Validar implementações com testes automáticos antes de conclusão

Veredito

Maigo é uma solução sofisticada e bem documentada para quem precisa de rigor metodológico no desenvolvimento. O design com personas é funcional (não apenas cosmetismo) e o sistema de hooks garante qualidade; recomendado para times que valorizam processos estruturados e validações múltiplas.

README

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

Maigo(迷子)

CI

Docs: https://lee-w.github.io/maigo/

「迷子になっても」——即使成為迷子也沒關係。

——『BanG Dream! It's MyGO!!!!!』

Maigo 是一套以 MyGO!!!!! 五位團員為人設的多 agent 通用開發工作流(Claude Code plugin)。

工程師日常都是迷子——debug 卡關、refactor 找不到入口、PR 不知道該怎麼拆。 Maigo 把五位團員的性格特質映射到開發角色,讓你即使迷失也能被帶回正軌。

角色映射

團員性格開發角色主要負責
要 樂奈 Raana神祕、看似放空但觀察力極強Explorer探索 codebase、找線索
高松 燈 Tomori詩人、把混亂結構化成 narrativePlanner設計策略、寫實作計畫
千早 愛音 Anon活潑推動者、不放棄Implementer寫 code、實作 feature
長崎 爽世 Soyo完美主義、執念細節ReviewerCode review、稽核
椎名 立希 Taki毒舌、直接、行動派Verifier跑 test、驗證結果

串起這五人、在開場與收場框住整場的 orchestrator,由兩位旁白擔任 —— 🌙 Doloris 與 🌑 Mortis。他們是 MyGO!!!!! 續作《Ave Mujica》的角色,以旁白身份站在故事外講述這場演出,本身不下場做事。

設計哲學

  • 實用 > 玩梗:角色化是為了好用、好記、好溝通;不為了梗犧牲效果
  • 通用化:不綁特定技術領域、不綁特定語言
  • Reviewer 真的會擋:Maigo 的核心特點是 Soyo 預設 BLOCKED、要 evidence 才放行;多層防禦(agent prompt + skill + hook validator)避免被偷雞跳過

Prerequisites

需要版本用途
Claude Code CLIlatestPlugin host
Python 33.13+hooks + 驗證 script
gitanyreview 本地 branch
gh CLI任意選用——review GitHub PR URL 時
pre-commit任意選用——只在貢獻 Maigo 本身時需要

安裝

cd /path/to/your/project
claude --plugin-dir /path/to/maigo

進 Claude Code 後輸入 / 應該能看到 /maigo:go、/maigo:team、/maigo:review。

持久化載入

快速試完想長期用,可透過 marketplace 持久化載入:

在 Claude Code 內:

/plugin marketplace add Lee-W/maigo
/plugin install maigo@maigo

之後啟動 claude 就會自動載入,不必再帶 --plugin-dir。

更新、停用、移除:

/plugin marketplace update maigo
/plugin disable maigo@maigo
/plugin uninstall maigo@maigo

命令快覽

日常 90% 用這三個:

/maigo:go <task>          # 5 人順序:探索 → 計畫 → 實作 → review → 驗證
/maigo:team <task>        # 同上,但 Soyo + Taki 並行(省 ~30% 牆鐘)
/maigo:review <pr|branch> # Anon 不上場;review 既有變更

完整 10 個命令(含 /maigo:quick、/maigo:remember、/maigo:memory、/maigo:retro、/maigo:describe-pr、/maigo:address-comments、/maigo:doctor)詳見 Commands reference。

Hook 自動行為

只要 plugin 載入就生效,使用者不用設定:

  • TeammateIdle — agent 輸出不符規格(如 Soyo 沒下 verdict、Taki 沒貼 exit code)就 block
  • Stop — 任務宣告完成前自動偵測專案類型跑 test,跳過 Taki 也擋下

→ 完整擋下條件、設定檔(.claude/skip-test-verification 等):docs/reference/hooks.md

產出檔案

計畫與 rubric 寫在 .maigo/(repo root 下,跨 session 留存)。 Artefact 在本機保留直到手動清除。SessionStart hook(repo_detect)會在 偵測到 git repo 時,把 .maigo/ 寫進該 repo 的 .git/info/exclude(不是 被追蹤的 .gitignore),所以不會污染 host repo、也不會被 commit 進去;若你 已用 global excludesfile 或 repo .gitignore 忽略 .maigo/,則 hook 視為 已忽略、不再重複寫入。

文件

  • Getting Started — 第一次裝 Maigo 的 5 分鐘入門
  • Commands reference — 三個命令的完整流程、合流邏輯、場景對照
  • Memory reference — 跨專案記憶層的 storage / schema / 讀寫
  • Hooks reference — SessionStart / TeammateIdle / Stop hook 完整行為與設定
  • Skills reference — skill 機制與完整 catalog(strict-review、teammate-flow、commit-message、doc-link-convention、copyable-deliverable、failure-handling 等)
  • Agents reference — 五位 agent 的 model tier 選擇邏輯
  • Contributing — 修 Maigo 本身的設定、原則、validator
  • CHANGELOG — 版本歷史

Acknowledgments

Maigo 的整體結構大幅受到 agent-flow 啟發—— multi-agent 分工、Claude Code plugin packaging、TeammateIdle / Stop hook 模式、 agent / command / skill / hook 四層分離,這些概念都來自 agent-flow。

Maigo 在這個基礎上做了三件事:

  • 把 agent 換成 MyGO!!!!! 五位團員的人設
  • 把焦點窄化到「reviewer 真的會擋」的 strict-review 流程
  • 簡化掉暫時用不到的元件(Graphify、personal-kb、/analyze、/explain 等)

如果你需要更完整的工程級 multi-agent orchestration(含知識圖譜整合), 直接用 agent-flow 會更合適。

License

MIT

Ver o original no GitHub

Bom para

Relacionados