ZaxbyHub/opencode-swarm

OpenCode Swarm – AI駆動型、ゲート付きコード生成パイプライン

何であるか – OpenCode AIコーディングプラットフォーム用のプラグインで、単一のAIセッションをミニマムな開発チームに変換します。プラグインは専門的なエージェント（アーキテクト、コーダー、レビュアー、テストエンジニア、セキュリティクリティックなど）のロースターを自動生成し、コード生成ワークフローをゲート付きパイプラインで実行します。すべての必須チェックが通過するまで、コードはマージされません。

なぜ重要か – 多くのAIコーディングツールは、1つのモデルがコードを書いた後、同じモデルに「コードは良いですか？」と尋ねるだけです。Swarmは役割を分離します：計画、実装、レビュー、テスト、セキュリティスキャン、ドキュメント作成はそれぞれ専用の読み取り専用モデルインスタンスが担当します。これにより「モデルが完了と言った → 実際には動く」の信頼ギャップを低減し、手動のオフロードなしでプロダクションレベルのガードレールを提供します。

コアコンセプト

コンセプト	READMEに記載されている内容
エージェント	プラグイン設定から生成されるライブロースター（/swarm agents）。コアエージェントにはアーキテクト、コーダー、レビュアー、test_engineer、クリティック、クリティック_オーバーサイト、SME、ドキュメンテーションが含まれ、さらにデザイナー、さまざまなクリティック、キュレーター、評議会など多くのオプション/条件付きエージェントがあります。
ゲート付きパイプライン	レビュアー＋テストエンジニアの承認がなければコードはリリースされません。各フェーズごとにクリティック、ドリフト検証、幻覚検証など追加ゲートを有効化できます。
DEEP_DIVEプロトコル	専用エージェントを使用して、コードベース全体のオンデマンド読み取り専用監査を実行します。
外部スキルキュレーション	オプションのパイプラインで、正規表現ベースのインジェクション/不正命令スキャンと出所チェックにより、外部「スキル」プラグインを発見・隔離・検証し、昇格可能になるまで待機します。
スキルオプティマイザー	手動で単一スキルを最適化する（/swarm skill-opt …）機能。SKILL.md候補を草案作成、スモークテスト、検証、アトミックな有効化を実行します。
フェーズ完了ゲート	各フェーズは、完了検証とドリフト検証ゲートを通過しなければ、アーキテクトは次のフェーズに進みません。
再開可能なセッション	すべての状態は.swarm/下に保存され、セッションは一時停止して後で再開できます。
PRモニター	オプションのGitHub PR購読機能。gh CLIでCIステータスをポーリングし、結果をAutomationEventBusにフィードします。
言語サポート	13種類の第一級言語プロファイル（TS/JS、Python、Go、Rust、Java、Kotlin、C/C++、C#、Ruby、Swift、Dart、PHP）と、20の文法に対応するtree-sitterパーサー。
セキュリティガードレール	内蔵のSAST、シークレットスキャン、依存関係監査、静的シェル書き込み検出（POSIX、PowerShell、cmd）、スコープ制御、破壊的コマンドブロッキング。
実行モード	セッションレベルのモード（Balanced、Turbo、Lean Turbo、Full-Auto）で安全性とスピードのトレードオフを調整。プロジェクトレベルのexecution_mode（strict、balanced、fast）でデフォルトフックを設定。

---

インストールと初回実行

# Bun ≥1.3.13 または Node ≥22.13 を推奨する単一コマンドインストール
bunx opencode-swarm install

インストーラーはプラグインをOpenCodeに登録し、ネイティブのexploreおよびgeneralエージェントを無効化し、~/.config/opencode/opencode-swarm.jsonにグローバル設定を書き込み、プロジェクトオーバーライドスタブが存在しない場合は作成します。

npmを好む場合：

npm install -g opencode-swarm && opencode-swarm install

インストール後、OpenCodeを起動し、エージェントピッカーからSwarmアーキテクトを選択する（または自動選択されたデフォルトを使用）。初回実行時に.swarm/ディレクトリが作成され、設定が埋め込まれます。

通常のワークフロー（READMEデモに示される通り）

1. プロンプト – 例：JWT認証ヘルパーとテストを構築して。
2. アーキテクトがフェーズ別実装計画を作成し、クリティックゲートを通過させる。
3. コーダーが現在のタスクのコードを記述。
4. 自動チェック（SAST、シークレット、依存関係監査）が実行。
5. レビュアーが正しさとセキュリティを検証。
6. テストエンジニアがテストを記述・実行。
7. アーキテクトがリグレッションスイープを実行。ゲートが失敗した場合、構造化されたフィードバックが責任あるエージェントに返される。
8. ドキュメンテーションとリトロスペクティブが自動更新。
9. すべてのアーティファクト（計画、証拠、テレメトリ）は.swarm/に保存され、後で検査可能（/swarm evidence、/swarm status）。

---

キーとなるコマンド（スラッシュスタイル、OpenCodeセッション内で使用）

コマンド	目的
/swarm help	Swarmコマンド一覧を表示。
/swarm agents	登録済みエージェントのライブロースターを表示。
/swarm status	現在のフェーズ／タスク情報。
/swarm show-plan	完全な実装計画を表示（オプションでフェーズでフィルタ）。
/swarm evidence	タスクのテスト、レビュー、セキュリティ結果を表示。
/swarm pr subscribe …	GitHub PRのCIフィードバックを購読。
`/swarm auto-proceed [on	off]`
`/swarm turbo [on	off]、/swarm full-auto [on
/swarm reset --confirm	すべてのSwarm状態をクリア。
/swarm diagnose	ヘルスチェックとバージョン情報。

---

設定

• グローバル設定は~/.config/opencode/opencode-swarm.jsonにあります。
• プロジェクトレベルのオーバーライドは.opencode/opencode-swarm.jsonに配置可能（オプトイン）。
• 重要なトグルには以下があります：
  • external_skills.curation_enabled – 外部スキル発見パイプラインを有効化。
  • skill_opt.enabled – 単一スキルオプティマイザーを有効化。
  • pr_monitor.enabled – GitHub PRモニタリングを有効化。
  • execution_mode – デフォルトのセキュリティプロファイルを設定（strict、balanced、fast）。 |

---

更新方法

OpenCodeはプラグインをキャッシュするため、通常の再起動では新しいnpmバージョンが取得されません。提供されたヘルパーを使用してください：

bunx opencode-swarm update   # キャッシュのみ更新
# または
bunx opencode-swarm install  # 完全再インストール（設定を再適用）

/swarm diagnoseは実行中および最新のnpmバージョンを報告します。背景チェックを無効にするにはversion_check: falseを設定してください。

誰が使うべきか？

• AIコード生成に頼るが、プロダクションレベルの安全性（セキュリティレビュー、テストカバレッジ、監査トレース）が必要な開発者。
• コードレビューとテストポリシーを強制しながらも「1プロンプト」体験を望むチーム。
• 複数言語にまたがるトレーサブルで再開可能なAI駆動開発セッションが必要な組織。

---

まとめ

OpenCode Swarmは、実際のインストール可能なプラグインであり、OpenCode AIコーディング環境にフルスタックでマルチエージェントワークフローを追加します。単一モデルを連携したチームに変換し、ゲート付き実行を強制することで、AI生成コードがプロダクション利用に耐えうる信頼性を持つようにし、設定可能で言語に依存しない設計を維持しています。