Android 스킬은 AI 도구와 에이전트가 Android 개발에 관한 권장사항과 안내를 따르는 특정 패턴을 더 잘 이해하고 실행하도록 지원하는 AI에 최적화된 안내입니다. 이러한 스킬은 Android 스킬 GitHub 저장소에 있습니다.
Android 스킬을 사용하여 다음과 같은 작업을 할 수 있습니다.
- XML에서 Compose로 이전
- AGP 9로 업그레이드
- Navigation 3과 같은 최신 프레임워크 설정
- 앱 UI를 더 넓은 화면으로 만들어 현대화
- R8 구성을 감사하여 성능 개선
Android 스킬을 사용하면 전문 Android 워크플로에 관한 최신 지식과 컨텍스트를 사용하여 LLM의 근거를 한정할 수 있습니다.
Android 스킬은 에이전트 스킬 개방형 표준을 따르므로 스킬을 지원하는 모든 AI 도구와 호환됩니다. 이 페이지에서는 Android 스튜디오에서 스킬을 사용하는 방법과 Android CLI를 사용하여 선택한 에이전트 및 도구와 함께 사용할 스킬을 설치하는 방법을 설명합니다.
Android 스킬의 주요 이점
Android 스킬은 고품질 Android 코드를 더 효율적으로 생성하기 위해 에이전트 워크플로를 가속화하는 데 도움이 되는 여러 가지 주요 이점을 제공합니다.
- 전문 지식으로 근거 한정: 에이전트에 더 많은 Android 관련 컨텍스트를 제공하여 필요에 따라 근거를 한정하고 일반 모델 학습 주기를 넘어 기본 지식과 전문성을 확장합니다.
- 반복 가능한 워크플로: Android 개발의 다단계 작업을 일관되게 실행하는 데 도움이 되는 표준 안내를 제공합니다.
- 리소스 번들링: 기본 SKILL.md 안내와 함께 스크립트, 템플릿 또는 추가 문서를 포함하여 에이전트가 필요한 모든 것을 한곳에 모아 프롬프트에 파일을 수동으로 첨부할 필요가 없도록 합니다.
- 전문성 공유: 팀의 Android 개발 패턴을 공유 폴더에 패키징하여 통합 액세스 및 공동작업을 지원합니다.
Android 스킬 사용
Android 스킬은 선택한 에이전트와 함께 사용할 수 있도록 Android CLI에 통합되어 있습니다.
Android CLI
Android CLI를 사용하여 Android 스킬을 설치하는 것이 좋습니다. 이렇게 하면 선택한 에이전트의 스킬을 더 쉽게 검색, 다운로드, 관리할 수 있습니다.
- 사용 가능한 스킬 목록을 보려면
android skills list를 실행합니다. - 스킬을 설치하려면
android skills add --skill skill-name을 실행합니다. 이미 스킬이 설치되어 있는 경우skills add를 실행하면 최신 버전으로 업데이트됩니다.
Android 스튜디오
Android 스킬 GitHub 저장소에서 스킬을 다운로드하여 Android 스튜디오의 프로젝트로 가져올 수 있습니다.
스킬 활성화
에이전트는 작업과 관련된 스킬을 자동으로 활성화합니다. 스킬을 사용하려면 에이전트에 스킬과 관련된 작업을 완료하도록 프롬프트합니다(예: '앱 UI를 더 넓은 화면으로 만들기'). 사용 가능한 스킬이 있으면 에이전트가 자동으로 스킬을 찾아 사용합니다.
Android 스튜디오에서는 채팅 창에 @skill-name을 입력하여 스킬을
직접 수동으로 호출할 수도 있습니다.
나만의 스킬 만들기
나만의 스킬을 만들어 팀의 워크플로를 패키징하고 공유할 수 있습니다. 스킬 요구사항에 관해 자세히 알아보려면 에이전트 스킬 사양을 참고하세요.
에이전트는 프로젝트 루트에 있는 .skills/ 또는 .agent/skills/ 디렉터리부터 스킬을 찾습니다. 커스텀 스킬을 빌드하려면 다음 단계를 따르세요.
- 스킬의 디렉터리 만들기 (예:
my-new-skill/) - 새 디렉터리 내에
SKILL.md파일 만들기 (대소문자 구분)
스킬은 다음 규칙을 따라야 합니다.
- 스킬당 하나의 디렉터리: 각 스킬에는 고유한 디렉터리
가 있어야 하며, 여기에는
SKILL.md파일과 추가 리소스가 포함됩니다. - 중첩: 모든 스킬은 프로젝트 루트의
.skills/또는.agent/skills/디렉터리에 있어야 합니다. 하지만 더 나은 구성을 위해 하위 디렉터리를 사용할 수 있습니다 (예:skills/ui-flows/<skill name>/SKILL.md또는skills/testing/<skill name>/SKILL.md). - 범위: 프로젝트의 코드베이스 내에 있는 스킬만 지원됩니다.
SKILL.md 파일은 메타데이터에 YAML 블록을 사용하고 안내에 표준 Markdown을 사용합니다.
name: 스킬의 고유 식별자입니다. 디렉터리 이름과 일치해야 합니다.description: 스킬의 기능과 에이전트가 스킬을 사용해야 하는 시기를 명확하게 설명합니다.- 본문: YAML 블록 아래의 Markdown 본문에는 스킬이 활성 상태일 때 에이전트의 동작을 안내하는 안내가 포함되어 있습니다.
---
name: skill-name
description: A description of what this skill does and when to use it.
metadata:
author: example-org
version: "1.0"
---
Skill content
형식 가이드라인
- 이름: 최대 64자 (영문 소문자, 숫자, 하이픈만 사용)
- 설명: 최대 1,024자
- 본문 콘텐츠: 10,000~20,000자 (약 2,500~5,000개 토큰)를 목표로 합니다. 안내가 이보다 길면 자세한 문서를 리소스 파일로 이동하는 것이 좋습니다. 선택적 스킬 디렉터리에 설명된 대로
선택적 스킬 디렉터리
SKILL.md 파일을 간결하고 모듈식으로 유지하려면 스킬 폴더 내의 다음 선택적 디렉터리에 추가 리소스를 포함할 수 있습니다.
scripts/: 에이전트가 실행할 수 있는 실행 코드 (예: Python 또는 Bash)가 포함되어 있습니다.references/: 자세한 기술 문서, API 참조 또는 도메인별 가이드가 포함되어 있습니다.assets/: 문서 템플릿, UI 다이어그램 또는 JSON 스키마와 같은 정적 리소스가 포함되어 있습니다.
SKILL.md 안내 내에서 이러한 파일을 참조할 때는 스킬 루트의 상대 경로를 사용합니다. 예: Run the script at scripts/cleanup.py
스킬 작동 방식
스킬은 주문형 전문성을 나타냅니다. 이 구조를 사용하면 에이전트가 모델의 즉각적인 컨텍스트 창을 어수선하게 만들지 않고도 많은 전문 기능을 유지할 수 있습니다.
모델은 요청과 스킬의 설명을 기반으로 스킬을 사용할 시점을 자율적으로 결정합니다. 관련 스킬이 식별되면 모델은 작업을 완료하는 데 필요한 전체 안내와 리소스를 동적으로 가져옵니다.