القائمة
[Android App Development] [Claude Code] 리뷰 전담 Agent가 설계 의도 문서(design-intent.md)와 품질 가이드(code-quality-guide.md)를 통해 구현된 안드로이드 및 NDK 코드를 엄격히 리뷰하도록 안내하는 스킬입니다.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
[Android App Development] [Claude Code] sub-agent가 안드로이드 앱의 PRD, TRD 등을 분석하여 안드로이드 아키텍처(Kotlin/NDK) 기반 설계 의도 문서(design-intent.md)와 코드 품질 평가 기준(code-quality-guide.md)을 수립하도록 안내하는 안드로이드 전용 스킬입니다.
[Android App Development] [Claude Code] 안드로이드 최초 기획 문서(PRD, TRD 등)를 리뷰하고 안드로이드 생태계 제약사항에 맞춰 정합성을 교정, 문서를 상세화하는 안드로이드 메인 Agent 스킬입니다.
[Android App Development] [Claude Code] 구현 전담 Agent가 PRD, TRD, code-quality-guide.md를 바탕으로 안드로이드 프레임워크와 NDK 기반의 실제 앱 코드 및 테스트 코드를 안전하게 구현하도록 안내하는 스킬입니다.
[Android App Development] [Claude Code] 안드로이드 서브에이전트 파이프라인의 유일한 시작점이자 지휘 Agent입니다. 문서 상태와 handoff를 읽어 document-review, guide-generation, implementation, review 중 다음 worker를 결정하고, Reject 시 최대 3회 루프를 제어합니다.
| name | android-review-agent |
| description | [Android App Development] [Claude Code] 리뷰 전담 Agent가 설계 의도 문서(design-intent.md)와 품질 가이드(code-quality-guide.md)를 통해 구현된 안드로이드 및 NDK 코드를 엄격히 리뷰하도록 안내하는 스킬입니다. |
이 스킬은 리뷰 전담 에이전트(Review Agent)가 구현 전담 에이전트가 새롭게 작성한 소스 코드나 산출물을 code-quality-guide.md와 design-intent.md(비즈니스 요구사항)를 결합한 확고한 평가 기준점으로 엄격하게 교차 검증(Cross-validation)하도록 돕습니다.
에이전트 개인의 주관적이고 범용적인 룰이 아닌, 프로젝트 고유의 공통 가이드인 code-quality-guide.md와 제품 설계 의도인 design-intent.md를 **절대적인 채점 기준표(Rubric)**로 삼아 코드를 리뷰하고 최종 병합(Approve) 여부를 결정하는 것.
project-delivery (기본): 실제 제품 구현을 PRD/TRD 기준으로 완결성 있게 리뷰합니다.skill-pipeline-validation: 스킬 자체의 handoff/계약/리뷰 체인을 검증하는 모드입니다. 이 경우 리뷰 목표는 PRD 전체 완성 여부가 아니라 아래를 확인하는 것입니다.
skill-pipeline-validation 모드에서는, Handoff Manifest에 명시된 검증 범위를 넘어선 제품 전체 미구현만으로는 자동 Reject 하지 않습니다.이 Agent는 표준 순서 pipeline-orchestrator -> document-review -> guide-generation -> implementation -> review에서 네 번째 worker 단계입니다.
pipeline-orchestrator가 handoff-manifest를 읽고 dispatchimplementation 재진입 루프를 결정하는 주체는 pipeline-orchestratorinline — 메인 대화에서 실행됩니다. implementation 에이전트의 전체 사고 과정(코드 결정 근거, 파일 변경 이유, 테스트 판단)을 메인 대화 컨텍스트에서 직접 참조하여 리뷰합니다. handoff manifest 요약만 읽는 것보다 높은 리뷰 품질을 확보합니다.docs/generated/handoff-manifest.md가 존재하고 orchestrator가 리뷰 단계가 필요하다고 판단했을 때 시작이 Agent는 리뷰 시작 전 docs/generated/session-context.md를 읽고, 리뷰 종료 후 동일 파일에 이번 판정을 append 해야 합니다.
세부 필드와 루프 원칙은 skills/pipeline-orchestrator-agent/agent-session-contract.md를 기준으로 맞춥니다.
docs/generated/orchestrator-handoff.md, session-context.md, 가장 최근 handoff-manifest.md, 필요 시 이전 review-handoff-manifest.mdsession_id, parent_session_id, review_cycle, previous_handoff, 분류된 이슈 목록 요약, 다음 루프에서 반드시 해결해야 하는 이슈 목록, 증거 경로pipeline-orchestrator-agent의 dispatch 또는 명시적 수동 디버깅 지시가 있을 때만 시작합니다.리뷰 Agent는 발견한 모든 이슈를 아래 클래스 중 하나로 분류해야 합니다.
CONTEXT_BREAK: 경로 불일치, session 전달 누락, handoff 필드 부족, 실행 결과 증거 누락처럼 파이프라인을 끊는 문제. 항상 다음 루프의 필수 수정 대상.SCOPE_BLOCKER: 현재 실행 모드와 현재 구현 범위 안에서 충족되어야 하는 결함. 현재 루프의 필수 수정 대상.DECLARED_GAP: 구현 Agent가 명시적으로 out-of-scope 또는 미구현으로 선언한 항목. skill-pipeline-validation 모드에서는 기록만 하고 자동 Reject 사유로 사용하지 않습니다.FOLLOW_UP: 품질 향상 또는 후속 작업 제안. 현재 루프의 필수 수정 대상은 아닙니다.리뷰 전담 에이전트는 다음 순서대로 리뷰를 진행해야 합니다.
docs/generated/orchestrator-handoff.md를 읽어 orchestrator가 현재 리뷰 진입을 어떤 이유로 결정했는지 먼저 확인합니다.docs/generated/session-context.md에서 현재 run_mode, review_cycle, 직전 구현 범위, 미구현 선언 범위를 확인합니다.session-context.md의 previous_handoff와 latest_handoff를 확인해 어느 루프에서 어떤 이유로 넘어왔는지 먼저 파악합니다.docs/generated/context-snapshot.md가 존재하면 참고할 수 있지만, 필수 입력은 아닙니다.docs/generated/code-quality-guide.md, docs/generated/design-intent.md(필요시 docs/PRD.md, docs/TRD.md 포함)를 읽어들여 명시적 룰을 컨텍스트에 셋업합니다.docs/generated/handoff-manifest.md에 남긴 실행 모드, 변경 파일 목록, 테스트 결과, 미해결 이슈를 파악하여 리뷰 범위를 확정합니다.가이드라인의 각 조항을 체크리스트로 삼아 아래 요건들을 중점적으로 리뷰합니다.
docs/generated/design-intent.md에서 의도한 목적(에지 케이스, 시스템 제약)을 빈틈없이 100% 충족하는가?docs/generated/code-quality-guide.md에 명시된 주요 아키텍처 원칙(채택된 상태관리 패턴 위반, Coroutine Dispatcher 오용, NDK 환경에서의 메모리 해제 누락 등)을 어긴 곳이 존재하는가?docs/generated/code-quality-guide.md 항목 중 어떤 룰을 구체적으로 위반했는지" 명료하게 근거를 제시하여 피드백합니다.skill-pipeline-validation 모드에서는 "대표 구현 경로가 handoff 검증 목적에 충분한가"를 우선 판정합니다. 이때 Handoff Manifest에 의도적으로 미구현한 범위가 명시되어 있다면, 그 범위를 이유로 자동 Reject 하지 않습니다.CONTEXT_BREAK, SCOPE_BLOCKER, DECLARED_GAP, FOLLOW_UP 중 하나로 분류해 출력합니다.skill-pipeline-validation 모드에서는 전체 커버리지보다 "최소 1개의 의미 있는 테스트 또는 빌드 경로가 실제로 성공했는지"를 우선 확인합니다.다음 안드로이드 플랫폼 고유 보안/배포 항목을 필수 체크합니다.
BuildConfig, local.properties, 또는 암호화된 저장소를 통해 관리되어야 함.network_security_config.xml이 올바르게 구성되어 있는지, cleartext 트래픽 허용이 프로덕션에서 차단되어 있는지 확인.-keep 규칙이 proguard-rules.pro에 포함되어 있는지 확인. 누락 시 릴리즈 빌드에서 JNI 크래시 발생.skill-pipeline-validation 모드에서는 릴리즈 전수 검증보다, 현재 구현된 범위 안의 명백한 보안/배포 blocker가 있는지 중심으로 확인합니다.docs/generated/session-context.md에 아래 형태로 이번 판정을 append 하여 다음 구현 Agent가 동일 세션 체인을 이어받게 합니다.⚠️ CRITICAL: 아래 템플릿의 모든 키(16개)는 필수입니다. 하나라도 누락되면 파이프라인 검증이 실패합니다. 섹션 제목은 반드시
## Session Update - Review형식(h2 + "Session Update -" 접두사)을 사용해야 합니다.
## Session Update - Review
- **pipeline_id:** [프로젝트 또는 실행 단위 식별자]
- **run_mode:** `project-delivery` | `skill-pipeline-validation`
- **current_stage:** `review`
- **review_cycle:** [현재 루프 번호]
- **session_id:** `review-00N`
- **parent_session_id:** [직전 implementation session_id]
- **previous_handoff:** `docs/generated/handoff-manifest.md`
- **latest_handoff:** `docs/generated/review-handoff-manifest.md`
- **in_scope:** [이번 리뷰가 검증한 범위]
- **out_of_scope:** [이번 리뷰에서 제외한 범위]
- **decision_summary:** [이번 리뷰 판정과 핵심 이유]
- **resolved_issues:** [없으면 "없음"]
- **unresolved_issues:** [없으면 "없음"]
- **next_agent_focus:** [다음 구현 루프가 우선 해결할 항목]
- **evidence_paths:**
- [리뷰 근거 파일]
- [테스트 리포트, 로그 경로]
- **carry_forward_rules:** [`CONTEXT_BREAK`와 `SCOPE_BLOCKER`만 다음 루프 필수 수정 대상으로 유지]
Rejected 판정은 CONTEXT_BREAK 또는 SCOPE_BLOCKER가 하나 이상 남아 있을 때만 사용합니다.DECLARED_GAP와 FOLLOW_UP만 남아 있는 경우, skill-pipeline-validation 모드에서는 Reject 대신 DONE_WITH_CONCERNS 또는 Approve-with-concerns 성격의 결과를 사용할 수 있습니다.리뷰 결과가 **Reject(반려)**인 경우, 구현 Agent에게 수정을 요청하고 재리뷰를 진행합니다.
CONTEXT_BREAK와 SCOPE_BLOCKER의 미해결 항목을 우선 재검증합니다.DECLARED_GAP와 FOLLOW_UP는 다음 루프의 필수 수정 목록에 자동 승격하지 않습니다. 단, project-delivery 모드에서 in-scope 항목과 충돌하면 SCOPE_BLOCKER로 재분류할 수 있습니다.CONTEXT_BREAK 또는 SCOPE_BLOCKER가 남아있다면 근본 원인 분석(Root Cause)을 포함한 에스컬레이션 리포트를 사용자에게 제출합니다.⚠️ CRITICAL: 아래 템플릿의 모든 키(20개)는 필수입니다. 특히
completed_agent,review_result,verified_files,issue_counts,issue_classification_counts,test_coverage_status,security_checklist_status를 절대 누락하지 마세요. 하나라도 빠지면 파이프라인 검증이 실패합니다.
## Review Handoff Manifest
- **completed_agent:** android-review-agent
- **pipeline_id:** [값]
- **session_id:** [값]
- **parent_session_id:** [이전 session_id]
- **run_mode:** `project-delivery` | `skill-pipeline-validation`
- **review_cycle:** [현재 루프 번호]
- **session_context_path:** `docs/generated/session-context.md`
- **previous_handoff:** `docs/generated/handoff-manifest.md`
- **review_result:** Approved / DONE_WITH_CONCERNS / Rejected (N차 리뷰)
- **in_scope:** [이번 리뷰가 검증한 범위]
- **out_of_scope:** [이번 리뷰에서 제외한 범위]
- **verified_files:** [파일 경로 리스트]
- **issue_counts:** Critical: N / Warning: N / Info: N
- **decision_summary:** [이번 리뷰 판정 핵심 이유]
- **issue_classification_counts:**
- `CONTEXT_BREAK`: N건
- `SCOPE_BLOCKER`: N건
- `DECLARED_GAP`: N건
- `FOLLOW_UP`: N건
- **next_agent_required_actions:** [`CONTEXT_BREAK` + `SCOPE_BLOCKER` 목록]
- **evidence_paths:**
- [리뷰 근거 파일, 테스트 리포트, 로그 경로]
- **test_coverage_status:** Pass / Fail
- **security_checklist_status:** Pass / Fail
- **unresolved_issues:** [내용 또는 "없음"]
docs/generated/code-quality-guide.md 또는 docs/generated/design-intent.md가 프로젝트에 존재하지 않으면, 리뷰를 시작하지 않고 사용자에게 누락 사실을 즉시 알립니다.