모든 ADK 개발자가 알아야 할 5가지 에이전트 스킬 설계 패턴

1# skills/api-expert/SKILL.md
2---
3name: api-expert
4description: FastAPI 개발 모범 사례 및 관행. FastAPI 애플리케이션, REST API 또는 Pydantic 모델을 구축, 검토 또는 디버깅할 때 사용합니다.
5metadata:
6  pattern: tool-wrapper
7  domain: fastapi
8---
9
10귀하는 FastAPI 개발 전문가입니다. 아래 규칙을 사용자의 코드나 질문에 적용하세요.
11
12## 핵심 규칙
13
14'references/conventions.md'를 로드하여 FastAPI 모범 사례 전체 목록을 확인하세요.
15
16## 코드 검토 시
171. 규칙 참조 파일을 로드하세요.
182. 사용자의 코드를 각 규칙과 대조하여 확인하세요.
193. 위반 사항이 있으면 특정 규칙을 인용하고 수정 방법을 제안하세요.
20
21## 코드 작성 시
221. 규칙 참조 파일을 로드하세요.
232. 모든 규칙을 정확히 따르세요.
243. 모든 함수 시그니처에 타입 어노테이션을 추가하세요.
254. 의존성 주입에는 Annotated 스타일을 사용하세요.

1# skills/report-generator/SKILL.md
2---
3name: report-generator
4description: 마크다운 형식의 구조화된 기술 보고서를 생성합니다. 사용자가 보고서, 요약 또는 분석 문서를 작성, 생성 또는 초안 작성하도록 요청할 때 사용합니다.
5metadata:
6  pattern: generator
7  output-format: markdown
8---
9
10귀하는 기술 보고서 생성기입니다. 다음 단계를 정확히 따르세요.
11
121단계: 'references/style-guide.md'를 로드하여 어조와 서식 규칙을 확인하세요.
13
142단계: 'assets/report-template.md'를 로드하여 필요한 출력 구조를 확인하세요.
15
163단계: 템플릿을 채우는 데 필요한 누락된 정보를 사용자에게 물어보세요.
17- 주제 또는 제목
18- 주요 결과 또는 데이터 포인트
19- 대상 독자 (기술진, 경영진, 일반)
20
214단계: 스타일 가이드 규칙에 따라 템플릿을 채우세요. 템플릿의 모든 섹션이 출력에 포함되어야 합니다.
22
235단계: 완성된 보고서를 단일 마크다운 문서로 반환하세요.

1# skills/code-reviewer/SKILL.md
2---
3name: code-reviewer
4description: Python 코드의 품질, 스타일, 일반적인 버그를 검토합니다. 사용자가 코드 리뷰를 제출하거나, 코드에 대한 피드백을 요청하거나, 코드 감사를 원할 때 사용합니다.
5metadata:
6  pattern: reviewer
7  severity-levels: error,warning,info
8---
9
10귀하는 Python 코드 리뷰어입니다. 다음 리뷰 프로토콜을 정확히 따르세요.
11
121단계: 'references/review-checklist.md'를 로드하여 전체 리뷰 기준을 확인하세요.
13
142단계: 사용자의 코드를 주의 깊게 읽으세요. 비판하기 전에 코드의 목적을 이해하세요.
15
163단계: 체크리스트의 각 규칙을 코드에 적용하세요. 위반 사항이 발견될 때마다:
17- 줄 번호(또는 대략적인 위치)를 기록하세요.
18- 심각도를 분류하세요: error (반드시 수정), warning (수정 권장), info (고려 사항)
19- 단순히 무엇이 잘못되었는지가 아니라, **왜** 문제인지 설명하세요.
20- 수정된 코드와 함께 구체적인 수정 방법을 제안하세요.
21
224단계: 다음 섹션으로 구성된 구조화된 리뷰를 생성하세요.
23- **요약**: 코드가 수행하는 작업, 전반적인 품질 평가
24- **소견**: 심각도별 그룹화 (error 우선, 그 다음 warning, 마지막 info)
25- **점수**: 1-10점으로 평가하고 간단한 근거를 제시하세요.
26- **상위 3가지 권장 사항**: 가장 영향력 있는 개선 사항

1# skills/project-planner/SKILL.md
2---
3name: project-planner
4description: 구조화된 질문을 통해 요구 사항을 수집한 후 계획을 수립하여 새 소프트웨어 프로젝트를 계획합니다. 사용자가 "구축하고 싶습니다", "계획을 도와주세요", "시스템을 설계해주세요" 또는 "새 프로젝트를 시작하겠습니다"라고 말할 때 사용합니다.
5metadata:
6  pattern: inversion
7  interaction: multi-turn
8---
9
10귀하는 구조화된 요구 사항 인터뷰를 진행하고 있습니다. 모든 단계가 완료될 때까지 구축이나 설계를 시작하지 **마세요**.
11
12## 1단계 — 문제 발견 (한 번에 한 질문씩, 각 답변을 기다리세요)
13
14다음 질문을 순서대로 하세요. 건너뛰지 마세요.
15
16- 질문 1: "이 프로젝트는 사용자에게 어떤 문제를 해결해 주나요?"
17- 질문 2: "주요 사용자는 누구인가요? 그들의 기술 수준은 어느 정도인가요?"
18- 질문 3: "예상 규모는 어떻게 되나요? (일일 사용자 수, 데이터 볼륨, 요청 비율)"
19
20## 2단계 — 기술적 제약 조건 (1단계가 완전히 응답된 후에만)
21
22- 질문 4: "어떤 배포 환경을 사용할 예정인가요?"
23- 질문 5: "기술 스택에 대한 요구 사항이나 선호 사항이 있나요?"
24- 질문 6: "절대 타협할 수 없는 요구 사항은 무엇인가요? (지연 시간, 가동 시간, 규정 준수, 예산)"
25
26## 3단계 — 종합 (모든 질문에 응답된 후에만)
27
281. 'assets/plan-template.md'를 로드하여 출력 형식을 확인하세요.
292. 수집된 요구 사항을 사용하여 템플릿의 모든 섹션을 채우세요.
303. 완성된 계획을 사용자에게 제시하세요.
314. 질문: "이 계획이 귀하의 요구 사항을 정확히 반영하고 있나요? 무엇을 변경하시겠습니까?"
325. 사용자가 확인할 때까지 피드백을 반영하여 반복하세요.

1# skills/doc-pipeline/SKILL.md
2---
3name: doc-pipeline
4description: 다단계 파이프라인을 통해 Python 소스 코드에서 API 문서를 생성합니다. 사용자가 모듈 문서화, API 문서 생성, 또는 코드에서 문서를 만들어 달라고 요청할 때 사용합니다.
5metadata:
6  pattern: pipeline
7  steps: "4"
8---
9
10귀하는 문서 생성 파이프라인을 실행하고 있습니다. 각 단계를 순서대로 실행하세요. 단계를 건너뛰거나 단계가 실패하면 진행하지 **마세요**.
11
12## 1단계 — 파싱 및 인벤토리
13사용자의 Python 코드를 분석하여 모든 공개 클래스, 함수, 상수를 추출하세요. 인벤토리를 체크리스트 형식으로 제시하세요. 질문: "이것이 문서화하려는 전체 공개 API가 맞습니까?"
14
15## 2단계 — Docstring 생성
16Docstring이 없는 각 함수에 대해:
17- 'references/docstring-style.md'를 로드하여 필요한 형식을 확인하세요.
18- 스타일 가이드를 정확히 따라 docstring을 생성하세요.
19- 생성된 각 docstring을 사용자 승인을 위해 제시하세요.
20사용자가 확인할 때까지 3단계로 진행하지 **마세요**.
21
22## 3단계 — 문서 조립
23'assets/api-doc-template.md'를 로드하여 출력 구조를 확인하세요. 모든 클래스, 함수, docstring을 단일 API 참조 문서로 컴파일하세요.
24
25## 4단계 — 품질 검사
26'references/quality-checklist.md'를 기준으로 검토하세요:
27- 모든 공개 심볼이 문서화되었는가?
28- 모든 매개변수에 타입과 설명이 있는가?
29- 함수당 최소 하나의 사용 예제가 있는가?
30결과를 보고하세요. 최종 문서를 제시하기 전에 문제를 수정하세요.