android-kotlin

android-kotlin スキルの概要

android-kotlin は何に使うのか

android-kotlin スキルは、Kotlin で書かれた Android アプリのコードを扱うときに役立ちます。特に、プロジェクトで Coroutines、Flow、Jetpack Compose、Hilt、MockK を使っている場合に有効です。このスキルが最も力を発揮するのは、AI アシスタントに Android コードベースの構造を理解させ、単なる一般的な Kotlin の助言ではなく、アプリの層構造に沿った変更を出させたいときです。

最適な利用シーン

*.kt や *.kts ファイルを更新するとき、依存性注入をつなぎ込むとき、Compose 画面を編集するとき、あるいは repository・domain・UI のコードをまとめて調整するときに、android-kotlin スキルを使ってください。フロントエンドが Android の UI レイヤーであり、Web スタックではない場合の android-kotlin for Frontend Development ワークフローにもよく合います。

何を避けやすくなるか

このスキルは、Android のプロジェクト構成、Gradle Kotlin DSL、そして一般的なアプリアーキテクチャの境界についての推測を減らしたいときに有用です。Android のソースとは無関係な作業や、プロジェクト構造を踏まえずに一発のスニペットだけ欲しい場合には、あまり向いていません。

android-kotlin スキルの使い方

正しい文脈でインストールする

ワークスペースに Android Kotlin のソースが含まれていて、リポジトリを踏まえた文脈でアシスタントを動かしたいなら、android-kotlin install の流れで使ってください。典型的なインストールコマンドは次のとおりです。
npx skills add alinaqi/claude-bootstrap --skill android-kotlin

先に読むべきファイルを押さえる

まず SKILL.md を読み、そのあと app/build.gradle.kts、ルートの build.gradle.kts、そして対象機能に一致する *.kt ファイルを確認してください。この repo には追加の rules/、references/、resources/ ファイルがないため、スキル本文そのものが主なガイダンスになります。

タスクの形が見えるプロンプトにする

android-kotlin usage で結果をよくするには、機能、レイヤー、制約を具体的に書くことが重要です。たとえば「この画面を直して」ではなく、「Compose 画面と ViewModel のログイン状態を更新し、Hilt の注入は維持し、Flow ベースの state を保ち、repository インターフェースは変更しない」と依頼してください。

レイヤーを意識したワークフローで進める

強い android-kotlin guide は、最初に変更が data、domain、UI のどこに属するかを見極め、そのレイヤーだけをアシスタントに修正させることです。変更が複数レイヤーにまたがるなら、その旨を明示し、対象のファイル名や package を挙げて、出力がプロジェクト構造に沿うようにしてください。

android-kotlin スキル FAQ

android-kotlin は Android アプリのコード専用ですか？

はい。中心は Android Kotlin 開発です。一般的なバックエンド Kotlin、素の JVM ユーティリティ、Android 以外のフロントエンド作業向けではありません。

使うのに Jetpack Compose や Hilt は必要ですか？

いいえ。ただし、これらはこのスキルで主に想定されているパターンです。アプリが従来の XML View や別の DI 構成を使っている場合は、適合度が下がる可能性があるため、その点を最初に伝えてください。

通常のプロンプトと何が違うのですか？

通常のプロンプトでも Kotlin コードは生成できますが、android-kotlin スキルは Android のプロジェクト構造、Gradle Kotlin DSL、Coroutines、Flow、Compose、Hilt、そして MockK を使ったテストと整合する変更を保つことを狙っています。既存アプリに合わせたコードが欲しいとき、この違いが重要になります。一般的なサンプルコードでよい場合とは目的が異なります。

初心者にも向いていますか？

はい。既存の Android コードベースの中でガイドが欲しいなら向いています。ただし、どのレイヤーに変更が属するか分からない場合や、期待する UI、state、data flow を説明できない場合は、初心者向けとしてはやや使いにくくなります。

android-kotlin スキルを改善する方法

アプリのレイヤーとゴールを具体的に書く

品質を大きく上げるには、UI、domain、data、DI、build configuration のどのレイヤーかを明記することが一番です。あわせて、「retry behavior を追加する」「ViewModel から state を公開する」「新しい repository を Hilt 経由でつなぐ」といった期待結果も書いてください。

実装を形づくる制約を伝える

public API、navigation route、test のスタイル、既存の coroutine scope など、変更してほしくないものを必ず伝えてください。命名、package 配置、error handling に関するプロジェクト独自の規約があるなら、それも含めることで、android-kotlin skill が新しいパターンを勝手に作り出すのを防げます。

構造面のフィードバックから反復する

最初の出力が広すぎるなら、より狭い範囲での再実行を依頼してください。たとえば「ui/feature と FeatureViewModel だけに変更を限定して」「Gradle Kotlin DSL の diff だけ見せて」といった指定です。これは、最初から完全に磨き上げた答えを求めるより、たいてい良い結果につながります。