Android 기술 개요

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를 실행합니다.

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 블록 아래의 마크다운 본문에는 스킬이 활성 상태일 때 에이전트의 동작을 안내하는 명령어가 포함되어 있습니다.

---
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

기술의 작동 방식

기술은 온디맨드 전문성을 나타냅니다. 이 구조를 사용하면 에이전트가 모델의 즉각적인 컨텍스트 윈도우를 어수선하게 만들지 않고도 많은 수의 전문 기능을 유지할 수 있습니다.

모델은 요청과 스킬의 설명을 기반으로 스킬을 사용할 시기를 자율적으로 결정합니다. 관련 기능이 식별되면 모델은 작업을 완료하는 데 필요한 전체 안내와 리소스를 동적으로 가져옵니다.