ADK 엔지니어은(는) 무엇을 하나요?
프로덕션에 바로 투입 가능한 Agent Development Kit (ADK) 에이전트 및 멀티 에이전트 시스템을 엔지니어링합니다: 깔끔한 구조, 테스트 용이성, 안전한 도구 사용, 배포 자동화.
개요
이 스킬을 사용하여 유지보수 가능하고 출시 가능한 ADK 에이전트 코드를 설계하고 구현하세요: 명확한 모듈 경계, 구조화된 도구 인터페이스, 회귀 테스트, 배포 체크리스트 (로컬 또는 Agent Engine).
전제 조건
- 프로젝트의 고정된 버전과 일치하는 대상 런타임 (Python/Java/Go)
- ADK 설치 (필요한 모델/공급자 SDK 구성 포함)
- 저장소에서 사용 가능한 테스트 러너 (최소 단위 테스트)
- 배포 시: Google Cloud 프로젝트에 대한 액세스 및 선택한 배포 대상에 대한 권한
지침
- 요구 사항 명확화: 에이전트 목표, 도구 표면, 지연 시간/비용 제약 조건, 배포 대상.
- 아키텍처 제안: 단일 에이전트 대 멀티 에이전트, 오케스트레이션 패턴, 상태 전략 (Memory Bank / 외부 저장소).
- 구조 스캐폴딩: 에이전트 진입점, 도구 모듈, 구성, 테스트.
- 점진적 구현:
- 입력 검증 및 구조화된 출력과 함께 한 번에 하나의 도구 추가
- 각 도구 및 중요 프롬프트 흐름에 대한 회귀 테스트 추가
- 운영 가드레일 추가: 재시도/백오프, 시간 제한, 로깅, 안전한 오류 메시지.
- 로컬 검증 (테스트 + 스모크 프롬프트) 및 배포 계획 제공 (요청 시).
출력
- 구체적인 아키텍처 계획 및 파일 레이아웃
- 에이전트 및 도구 구현 (또는 패치) 및 테스트
- 검증 체크리스트 (실행할 명령어, 예상 출력, 장애 처리)
- 선택 사항: 배포 지침 및 배포 후 상태 확인
오류 처리
- 빌드/테스트 실패: 실패 모듈 격리, 재현 최소화, 수정, 회귀 테스트 추가.
- 도구/런타임 오류: 구조화된 오류 응답 적용 및 적절한 경우 안전한 재시도.
- 배포 실패: 정확한 실패 명령어 제공, 검사할 로그, 최소 권한 IAM 수정.
예시
예시: 기존 ADK 에이전트 프로덕션화
- 요청: "이 에이전트를 깔끔한 모듈 구조로 리팩터링하고 배포 전에 테스트를 추가해 주세요."
- 결과: 재구성된
src/레이아웃, 도구 경계, 테스트 스위트, 배포 체크리스트.
예시: 멀티 에이전트 워크플로우
- 요청: "순차 오케스트레이터를 사용하여 검증기 + 배포기 + 모니터 에이전트 팀을 구축해 주세요."
- 결과: 오케스트레이터 스켈레톤, 에이전트별 책임, 각 단계별 스모크 테스트.
리소스
- 전체 상세 플레이북 (참고용):
${CLAUDE_SKILL_DIR}/references/SKILL.full.md - 저장소 표준 (진실 공급원):
000-docs/6767-a-SPEC-DR-STND-claude-code-plugins-standard.md000-docs/6767-b-SPEC-DR-STND-claude-skills-standard.md
- ADK / Agent Engine 문서: https://cloud.google.com/vertex-ai/docs/agent-engine