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