Androidアプリを解析し、メモの作成、メディアの再生、自動化またはAIエージェントがトリガーするメッセージの送信、音声コマンド、システムショートカットなどのAppFunctionの主要なユーザーワークフローを特定します。アプリのUIを開く必要はありません。
これらのワークフローをAndroidシステムに公開するKotlinコードを生成し、エージェントがオンデバイスで発見・実行できるようにします。
また、KDocドキュメントを洗練し、AIエージェントが提供された機能を正しく理解して使用できるようにします。
前提条件
アプリは targetSdk 36 以降を対象とし、compileSdk 37 以降を使用する必要があります。
AppFunctionsはAndroid 16以降で利用可能なAndroidプラットフォームAPIの一部です。
下位互換性を処理するため、常にJetpackライブラリを使用してください。
ワークフロー
このスキルにより、呼び出し元はシステムエージェントに提供される機能を発見し、それらをAppFunctionsで実装し、エージェント向けの機能説明を改善し、ローカル評価とテストにADBコマンドを使用できます。
完全なAppFunction開発フローは、次の4つのステップで構成されています：
- ステップ1：発見：Androidコードベースを分析し、潜在的なAppFunctionを特定して推奨します。ユーザーが「AppFunctionを発見する」「AIの機能を見つける」「アプリをエージェンティックツール向けに分析する」と依頼した場合にこのステップを使用します。
- ステップ2：実装と構成：AppFunctionのKotlin実装を生成し、システム全体の構成を管理し、ビルド依存関係を構成します。ユーザーが「AppFunctionを実装する」「AppFunctionsフレームワークをセットアップする」「HiltをAppFunctions用に構成する」と依頼した場合にこのステップを使用します。
- ステップ3：KDocの洗練：AIエージェントとModel Context Protocol向けにAppFunction KDocを最適化します。ユーザーが「KDocを書く」「MCP向けに最適化する」「LLM向けにツール説明をリファクタリングする」と依頼した場合にこのステップを使用します。
- ステップ4：テストとデバッグ：ADBを使用してAppFunctionを操作するコマンドを提供し、テストとデバッグを行います。ユーザーがデバイス上で「アプリ関数の一覧表示」「アプリ関数の呼び出し」「アプリ関数の登録確認」をしたい場合にこのステップを使用します。
ユーザーが一部のステップのみを要求する場合、すべてのステップを使用するよう促す必要があります。
該当する場合は、以下の参照情報を読み込む必要があります：
- コンテキストと用語：AppFunctionsスキルスイート全体でのユビキタス言語、アーキテクチャ定義、デザインパターンを定義します。コアアーキテクチャの用語を理解する必要がある場合や、最新とレガシーのAppFunctions APIの違いを確認する場合に読み込みます。
- サービスエントリポイントへの移行：バージョン1.0.0-alpha09以下のAppFunctionsを使用するAndroidアプリケーションを、バージョン1.0.0-alpha10で導入された
AppFunctionServiceEntryPointアーキテクチャに移行するための体系的な手順を文書化しています。ユーザーが既存のAppFunctionsコードの移行やアップグレードを依頼した場合、または従来のAppFunctionConfiguration.Provider実装に遭遇した場合に読み込みます。
重要な制約
- モジュールの一貫性：AppFunction実装を生成した直後にKDocを洗練する必要があります。
- セキュリティ：ユーザーの確認なしに機密データを公開したり、破壊的なアクションを実行したりしないでください。
トラブルシューティング
- Kotlinシンボル処理（KSP）の問題などビルド時のエラーが発生した場合は、実装と構成 を参照してください。
- サービスが見つからない、実行に失敗するなどのランタイムエラーが発生した場合は、テストとデバッグ を参照してください。
- アーキテクチャの定義や用語が必要な場合は、コンテキストと用語 を参照してください。
- レガシー設定のアップグレード時に問題が発生した場合は、サービスエントリポイントへの移行 を参照してください。