android-java

android-java skill の概要

android-java は何のための skill か

android-java は、Java ベースの Android アプリコードを扱うための特化型 Android Java skill です。特に、プロジェクトで MVVM、ViewBinding、Espresso テストを使っている場合に力を発揮します。Android の構成を手探りで推測せずに、ソースファイルを編集・拡張したいときに android-java skill が最も役立ちます。

どんな人に向いているか

Java で書かれた Android アプリで、画面、ViewModel、Repository、Gradle 設定、テストコードを変更するなら、この android-java skill を使ってください。Android のフロントエンド開発で、ゼロから新しいアーキテクチャを考えるのではなく、UI・状態・アプリ構造を正しくつなぐ作業に向いています。

何が違うのか

主な価値は、data、domain、ui、依存性注入、テストフォルダといった Android アプリの一般的なレイヤーに対する実践的なガイダンスです。そのため、android-java guide は汎用的な Android プロンプトよりも、プロジェクトの慣習を保ちながら変更を進めるのに役立ちます。アプリが Kotlin 優先、Compose 優先、あるいはフレームワーク依存が強い場合は、適性が下がります。

android-java skill の使い方

インストールして、正しいファイルを開く

android-java install を行うには、ディレクトリツールまたは skill manager から skill を追加し、最初に SKILL.md を開いてください。そこから、周辺のプロジェクト文脈として重要になりやすい README.md、AGENTS.md、metadata.json、そして存在する場合は rules/、resources/、references/、scripts/ フォルダも確認します。このリポジトリでは skill 本体が 1 ファイルにまとまっているため、SKILL.md が出発点です。

skill に具体的な Android タスクを伝える

android-java usage は、プロンプトで具体的な機能、対象ファイル領域、制約を明示すると最も効果的です。「Android を手伝って」ではなく、たとえば「app/src/main/java/.../ui/login/ のログインフローを更新して、エラー状態をサポートし、MVVM を維持し、失敗パスの Espresso カバレッジを追加して」といった形で依頼してください。そうすると、android-java skill がレイヤー配置、命名、テスト範囲について適切に判断しやすくなります。

編集前にリポジトリの配置を確認する

skill 内のファイルツリーを使って作業の見取り図を作りましょう。app/src/main/java/.../data はローカルまたはリモートのデータアクセス、domain はビジネスルール、ui は Activity・Fragment・ViewModel、androidTest はインストルメンテーションテストの範囲です。変更先が分からないときは、まず最寄りの feature フォルダを見てから、アプリ全体を書き換えるのではなく依存関係を外側へたどってください。

アーキテクチャとテスト意図を明示して依頼する

強い android-java guide プロンプトでは、アーキテクチャ上の期待値と受け入れ条件を明確にします。例: 「ユーザー詳細を取得する repository メソッドを追加し、ViewModel 経由で公開し、ViewBinding で fragment の UI を更新し、repository の unit test と happy path の Espresso test を含めてください」。これは曖昧な機能要望よりも、どのレイヤーを変える必要があるか、どんな正しさの証拠が必要かを skill に伝えられるため有効です。

android-java skill の FAQ

android-java はフロントエンド開発専用ですか？

いいえ。android-java for Frontend Development という側面は確かにありますが、skill は UI の振る舞いに影響するデータフロー、Repository、依存性注入、テストもカバーします。画面に流れ込むアプリロジックに触れるなら、この skill は引き続き役立ちます。

既存の Android Java プロジェクトがないと使えませんか？

はい、それが最適な用途です。android-java skill は、既存の Java Android コードベースで、フォルダ構成や Gradle ファイルがすでに整っている状態を前提にしています。一般的な Java バックエンド向け skill ではなく、構造のない白紙のアプリ案に使うのも適切ではありません。

通常のプロンプトと何が違いますか？

通常のプロンプトだと、一般的な Android アドバイスが返りやすくなります。android-java は、Android プロジェクトの配置を尊重し、変更を正しいレイヤーに置き、ViewBinding、MVVM、Espresso をまとめて考えさせたいときにより有効です。その分、初稿のあとに必要になる手戻りが減ります。

どんなときは使わないほうがいいですか？

プロジェクトが Kotlin 専用、Jetpack Compose 優先、あるいは主な作業が Android のソースコードと無関係なら、android-java install は避けてください。また、実装支援よりも深いプロダクト設計支援が必要な場合も、適性は低めです。

android-java skill を改善するには

最小限で完結する機能ブリーフを渡す

最良の出力は、画面、データソース、成功・失敗時の挙動を明示した入力から生まれます。たとえば「FeatureFragment で新しい API レスポンスの loading、empty、error 状態を表示し、UI state を整形する処理は ViewModel のみに限定してください」と伝えます。「画面をよくして」よりも、実装を絞り込み、不要なリファクタを防げます。

実装に影響する制約を明示する

プロジェクトで Hilt、Retrofit、Room、または既存の ViewBinding パターンを使っているなら、はっきり書いてください。android-java skill は、minSdk、互換性要件、テスト種別、新しいライブラリを増やしたくないかどうかといった制約があると、より良いコードを出しやすくなります。こうした情報で、その提案が実際にリリース可能かどうかが決まることも多いです。

テストと想定エッジケースを指定する

android-java usage をさらに良くするには、必要なテスト層を依頼し、気にしているエッジケースを列挙してください。たとえば「null レスポンス処理の unit test と、ネットワーク失敗後に retry をタップする Espresso test を追加してください」です。これにより、skill は happy path だけで終わらず、実際の Android アプリの挙動に合った実装へ進めます。

まずファイル配置を見てから反復する

最初の回答のあと、変更が適切なフォルダに入っているか、UI から domain、data へと依存関係がきれいに流れているかを確認してください。出力が近いけれど噛み合っていない場合は、「parsing を fragment から外して」「このロジックは repository に残して」「ViewBinding のみに変えて」のように、より狭く修正を依頼するとよいです。