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 | 詩人、把混亂結構化成 narrative | Planner | 設計策略、寫實作計畫 |
| 千早 愛音 Anon | 活潑推動者、不放棄 | Implementer | 寫 code、實作 feature |
| 長崎 爽世 Soyo | 完美主義、執念細節 | Reviewer | Code review、稽核 |
| 椎名 立希 Taki | 毒舌、直接、行動派 | Verifier | 跑 test、驗證結果 |
串起這五人、在開場與收場框住整場的 orchestrator，由兩位旁白擔任 —— 🌙 Doloris 與 🌑 Mortis。他們是 MyGO!!!!! 續作《Ave Mujica》的角色，以旁白身份站在故事外講述這場演出，本身不下場做事。
- 實用 > 玩梗：角色化是為了好用、好記、好溝通；不為了梗犧牲效果
- 通用化：不綁特定技術領域、不綁特定語言
- Reviewer 真的會擋：Maigo 的核心特點是 Soyo 預設 BLOCKED、要 evidence 才放行；多層防禦（agent prompt + skill + hook validator）避免被偷雞跳過
| 需要 | 版本 | 用途 |
|---|---|---|
| Claude Code CLI | latest | Plugin host |
| Python 3 | 3.13+ | hooks + 驗證 script |
git |
any | review 本地 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 既有變更完整 9 個命令（含 /maigo:fix、/maigo:remember、/maigo:memory、/maigo:retro、/maigo:describe-pr、/maigo:address-comments）詳見 Commands reference。
只要 plugin 載入就生效，使用者不用設定：
- TeammateIdle — agent 輸出不符規格（如 Soyo 沒下 verdict、Taki 沒貼 exit code）就 block
- Stop — 任務宣告完成前自動偵測專案類型跑 test，跳過 Taki 也擋下
→ 完整擋下條件、設定檔（.claude/skip-test-verification 等）：docs/reference/hooks.md
計畫與 rubric 寫在 /tmp/maigo/<repo>/（<repo> = basename "$PWD"）。
刻意放在 /tmp——不污染 repo、不需 gitignore、重開機自動清掉。想保留就自己另存它處。
- Getting Started — 第一次裝 Maigo 的 5 分鐘入門
- Commands reference — 三個命令的完整流程、合流邏輯、場景對照
- Memory reference — 跨專案記憶層的 storage / schema / 讀寫
- Hooks reference — SessionStart / TeammateIdle / Stop hook 完整行為與設定
- Skills reference — skill 機制與目前 catalog（
strict-review） - Agents reference — 五位 agent 的 model tier 選擇邏輯
- Contributing — 修 Maigo 本身的設定、原則、validator
- CHANGELOG — 版本歷史
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 會更合適。
MIT