Android 앱을 분석하여 메모 작성, 미디어 재생, 자동화 또는 AI 에이전트 트리거 메시지 전송, 음성 명령, 시스템 단축키와 같은 AppFunctions의 주요 사용자 워크플로를 식별합니다. 앱 UI를 열 필요 없이 수행합니다.
이러한 워크플로를 Android 시스템에 노출하는 Kotlin 코드를 생성하여 에이전트가 기기에서 이를 발견하고 실행할 수 있도록 합니다.
또한 AI 에이전트가 제공된 기능을 올바르게 이해하고 사용할 수 있도록 KDoc 문서를 개선합니다.
전제 조건
앱은 Android 16부터 Android 플랫폼 API의 일부인 AppFunctions를 사용할 수 있도록 targetSdk 36 이상이어야 하며 compileSdk 37 이상을 사용해야 합니다.
항상 Jetpack 라이브러리를 사용하세요. 이는 하위 호환성을 처리합니다.
워크플로
이 스킬을 통해 호출자는 시스템 에이전트에 제공될 기능을 발견하고, AppFunctions로 구현하고, 에이전트를 위한 기능 설명을 개선하며, 로컬 평가 및 테스트를 위해 ADB 명령을 사용할 수 있습니다.
전체 AppFunction 개발 흐름은 다음 4단계로 구성됩니다.
- 1단계: 발견: Android 코드베이스를 분석하여 잠재적인 AppFunctions를 식별하고 추천합니다. 사용자가 "AppFunctions 발견", "AI용 기능 찾기", "에이전트 도구용 앱 분석"을 요청할 때 이 단계를 사용하세요.
- 2단계: 구현 및 구성: AppFunctions의 Kotlin 구현을 생성하고, 시스템 전체 구성을 관리하며, 빌드 종속성을 구성합니다. 사용자가 "AppFunctions 구현", "AppFunctions 프레임워크 설정", "AppFunctions용 Hilt 구성"을 요청할 때 이 단계를 사용하세요.
- 3단계: KDoc 개선: AI 에이전트 및 Model Context Protocol을 위한 AppFunction KDoc를 최적화합니다. 사용자가 "KDoc 작성", "MCP 최적화", "LLM용 도구 설명 리팩토링"을 요청할 때 이 단계를 사용하세요.
- 4단계: 테스트 및 디버깅: ADB를 사용하여 AppFunctions와 상호 작용하는 명령을 제공하여 테스트 및 디버깅합니다. 사용자가 기기에서 "앱 함수 나열", "앱 함수 호출", "앱 함수 등록 확인"을 원할 경우 이 단계를 사용하세요.
사용자가 단계의 일부만 요청하는 경우 모든 단계를 사용하도록 권장해야 합니다.
해당하는 경우 다음 참조를 로드해야 합니다.
- 컨텍스트 및 용어: AppFunctions 스킬 제품군 전반에 걸친 보편적인 언어, 아키텍처 정의 및 디자인 패턴을 정의합니다. 핵심 아키텍처 용어를 이해하거나 최신 및 레거시 AppFunctions API 간의 차이점을 확인해야 할 때 로드하세요.
- 서비스 진입점으로 마이그레이션: AppFunctions 버전 1.0.0-alpha09 이하를 사용하는 Android 애플리케이션을 버전 1.0.0-alpha10에 도입된
AppFunctionServiceEntryPoint아키텍처로 마이그레이션하는 체계적인 절차를 문서화합니다. 사용자가 기존 AppFunctions 코드를 마이그레이션하거나 업그레이드하도록 요청하거나 레거시AppFunctionConfiguration.Provider구현을 발견할 때 로드하세요.
중요한 제약 사항
- 모듈 일관성: AppFunction 구현을 생성한 직후 KDoc를 개선해야 합니다.
- 보안: 사용자 확인 없이 민감한 데이터를 노출하거나 파괴적인 작업을 실행하지 마십시오.
문제 해결
- Kotlin Symbol Processing(KSP) 문제와 같은 빌드 타임 오류가 발생하면 구현 및 구성을 참조하세요.
- 누락된 서비스 또는 실행 실패와 같은 런타임 오류가 발생하면 테스트 및 디버깅을 참조하세요.
- 아키텍처 정의 및 용어가 필요한 경우 컨텍스트 및 용어를 참조하세요.
- 레거시 구성 업그레이드 중 문제가 발생하면 서비스 진입점으로 마이그레이션을 참조하세요.