AIエージェントとKoinスキル
Koinスキルは、コーディングエージェントにKoin 4.xおよびKoin Compiler Pluginの使い方(どのスタイルを使用すべきか、定義をどのように宣言・接続するか、他のDIフレームワークからどのように移行するか、Koinのエラーをどのように診断するか)を教えます。これらはGitHub上のkoin-skillsリポジトリでKoinチームによってメンテナンスされており、Claude Code向けのkoinプラグインおよび他のエージェント向けの標準エージェントスキルとして公開されています。このページでは、それらのインストール方法と各スキルの機能について説明します。
Claude Codeでのインストール
/plugin marketplace add InsertKoinIO/koin-skills
/plugin install koin@koin-skills最初のコマンドはKoinスキルリポジトリをプラグインマーケットプレイスとして追加し、2番目のコマンドはそこからkoinプラグインをインストールします。後から/plugin marketplace update koin-skillsで更新できます。
Kotlin、Android、Compose、KMP、またはKtorプロジェクトでタスクが依存性注入に関わる場合、スキルは自動的に読み込まれます。名前を指定して呼び出す必要はありません。
その他のエージェントでのインストール
Cursor、Codex、Copilot、Windsurf、Geminiなど、エージェントスキルを読み込めるその他のエージェントの場合は、skills CLI(Node.js 22以降)を使用します。
npx skills add InsertKoinIO/koin-skillsこれにより、koin-skillsリポジトリ(完全なURL https://github.com/InsertKoinIO/koin-skills も使用可能)からスキルが読み取られ、4つのスキルが一覧表示され、選択したエージェント向けに選択したスキルがインストールされます。プロンプトなしですべてインストールする場合: npx skills add InsertKoinIO/koin-skills --skill '*' -y。各GitHubリリースには、スキルごとの.skillアーカイブと、完全なプラグインとしてのkoin-plugin.zipも添付されています。
スキルの機能
| スキル | 用途 |
|---|---|
koin-setup | 新規または既存のプロジェクトにKoinを追加する、あるいは既存のDIコンテナと併用して追加する |
koin | プロジェクトのスタイルに合わせてKoinコードを作成する:定義、モジュール、エントリーポイント、スコープ、テスト |
di-migration | Hilt、Dagger、Toothpick、Kodein、Metro、Koin 3.x、Koin DSL、またはKoin KSPからモジュール単位で移行する |
koin-diagnose | Koinのエラーやクラッシュを修正し、ランタイム時のアプリの動作を確認する |
これらのスキルは本ドキュメントのルールに従います。コンストラクタインジェクション、Compiler Plugin DSL、またはKoin Annotationsを使用し、新規コードにKoin KSPを使用することはありません。移行は段階的に行われ、最後のバインディングが移行されるまで古いコンテナは動作し続けます。
Kotzilla MCPサーバー
各スキルはKotzilla MCPサーバーを使用して、Koinエラーの診断やランタイム時の定義の動作(ライフタイム、スコープ、起動コスト)を計測できます。これには無料のKotzillaアカウントが必要です。スキルはそれが役立つ場合に提案を行いますが、必須とすることはありません。
Claude Codeでは、koinプラグインにサーバーが含まれています。サインインするまで非アクティブな状態を維持します。/mcpを実行し、plugin:koin:kotzillaを選択してサインインしてください。その他のエージェントでは、エージェントのMCP設定にエンドポイントhttps://mcp.kotzilla.io/mcp(HTTPトランスポート、OAuth)を追加します。
制限事項
- スキルはKoin 4.2.2以降およびKotlin 2.3.20以降を対象としています。古いバージョンのKoinでは現在のセットアップで動作し、アップグレードを一度提案します。
- スキルはエージェントをガイドするものであり、レビューの代わりにはなりません。マージする前に変更内容を確認してください。
- ランタイムチェック(起動、メモリ、二重生成されたインスタンス)には、アプリ内にKotzilla SDKが必要です。SDKがない場合、スキルは計測結果ではなくコードから考えられる原因を指摘します。
関連情報
- Compiler Pluginのセットアップ: スキルが依存するビルド時チェック。
- Koin vs Hilt: Hiltから移行する際の変更点。
- モニタリング: ランタイムチェックを支えるKotzilla SDK。
- GitHubのKoinスキル: ソース、Issue、リリース。
