Skip to content

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以降)を使用します。

bash
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-migrationHilt、Dagger、Toothpick、Kodein、Metro、Koin 3.x、Koin DSL、またはKoin KSPからモジュール単位で移行する
koin-diagnoseKoinのエラーやクラッシュを修正し、ランタイム時のアプリの動作を確認する

これらのスキルは本ドキュメントのルールに従います。コンストラクタインジェクション、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がない場合、スキルは計測結果ではなくコードから考えられる原因を指摘します。