| name | pr-review-orchestrator |
| description | PR·diff·변경 파일 목록을 받아 정적 분석, 보안 검토, 테스트 영향 검토를 병렬로 수행하고 하나의 리뷰 리포트로 통합한다. 사용자가 'PR 리뷰', 'diff 점검', '변경사항 리뷰', '코드 리뷰 자동화'를 요청하면 이 스킬을 사용한다. 단일 파일의 간단한 스타일 조언은 code-reviewer 스킬로 처리하고, 전체 코드베이스 보안 감사는 security-auditor 스킬로 위임한다. |
| allowed-tools | ["Read","Grep","Glob","Bash"] |
PR Review Orchestrator
목표
변경사항 하나를 네 에이전트 팀으로 검토한다. 오케스트레이터는 직접 코드를 고치지 않는다.
팀을 만들고, 작업 큐를 배치하고, 팀원 간 직접 메시지를 허용하고, 최종 리포트만 통합한다.
입력
diff_path 또는 PR diff 텍스트- 변경 파일 목록
- 선택 입력: 리뷰 기준, 금지된 변경 영역, 릴리스 위험도
산출물
_workspace/pr-review/static.md_workspace/pr-review/security.md_workspace/pr-review/tests.md_workspace/pr-review/final-review.md_workspace/pr-review/team-log.jsonl
Phase 0. 사전 조건
- 변경 파일 목록을 읽고 리뷰 범위를 확정한다.
_workspace/pr-review/ 디렉터리 존재를 확인한다.- diff가 없거나 변경 파일이 0개면 사용자에게 중단 사유를 보고한다.
- 파일 수가 40개를 넘으면 먼저 범위를 나누고, 이번 실행에서는 가장 위험도가 높은 묶음 하나만 리뷰한다.
Phase 1. 팀 생성
TeamCreate로 pr-review-team을 만든다.
팀원 네 명을 AgentTool로 스폰한다.
| 이름 | 역할 | 출력 |
|---|
| static-reviewer | 버그·성능·스타일 검토 | _workspace/pr-review/static.md |
| security-reviewer | 입력 검증·권한·비밀 노출 검토 | _workspace/pr-review/security.md |
| test-reviewer | 테스트 영향·누락 회귀 검토 | _workspace/pr-review/tests.md |
| review-integrator | 세 리포트 병합·중복 제거 | _workspace/pr-review/final-review.md |
각 팀원 프롬프트에는 공통 규칙을 넣는다.
- 발견 즉시 관련 팀원에게 SendMessage로 알린다.
- 최종 판단은 파일에 저장한다.
- Critical 발견 시 오케스트레이터와 관련 팀원에게 동시에 보고한다.
- 코드 수정은 하지 않는다.
Phase 2. 작업 큐 배치
TaskCreate로 네 작업을 만든다.
static-pass: static-reviewer 담당. diff 전체의 버그·성능·스타일 검토.security-pass: security-reviewer 담당. 외부 입력·권한·비밀 노출 검토.test-pass: test-reviewer 담당. 변경 파일과 테스트 매핑, 누락 테스트 검토.integrate-review: review-integrator 담당. 앞 세 작업 완료 후 실행. depends_on = ["static-pass", "security-pass", "test-pass"].
Phase 3. 팀원 간 메시지 규칙
SendMessage는 리더를 거치지 않는다.
- static-reviewer가 데이터 구조(shape) 변경을 발견하면 test-reviewer에게 테스트 영향 확인을 요청한다.
- security-reviewer가 인증·권한 변경을 발견하면 test-reviewer에게 보안 회귀 테스트 존재 여부를 묻는다.
- test-reviewer가 테스트 불가능한 설계를 발견하면 static-reviewer에게 구조 리스크 확인을 요청한다.
- Critical 이슈는 오케스트레이터에도 요약 메시지를 보낸다.
메시지 형식은 고정한다.
{
"type": "finding",
"severity": "Critical|High|Medium|Low",
"file": "path/to/file.ts",
"line": 42,
"claim": "문제를 주장하는 한 문장",
"request": "상대 팀원이 확인할 질문"
}
Phase 4. 통합 게이트
review-integrator는 세 리포트를 모두 읽고 다음 순서로 통합한다.
- Critical·High를 먼저 배치한다.
- 같은 원인의 중복 이슈는 하나로 합친다.
- 증거가 없는 제안은 제외한다.
- 테스트 누락만 있는 항목은 "권고"로 낮추고, 실제 버그 증거가 있으면 "차단"으로 올린다.
- 최종 리포트에는
must-fix, should-fix, watch 세 섹션만 둔다.
Phase 5. 종료
- 네 팀원에게
shutdown_request를 SendMessage로 보낸다.
- 각 팀원이 진행 중 파일 쓰기를 끝냈는지 확인한다.
- TeamDelete로 팀을 해체한다.
_workspace/pr-review/team-log.jsonl에 팀 생성·작업 배치·종료 시각을 append-only로 남긴다.
실패 처리
- 팀원 1명 실패: 같은 역할을 한 번 재시도한다.
- 같은 팀원 2회 실패: 해당 리포트 누락을 final-review에 명시하고 진행한다.
- 팀원 2명 이상 실패: TeamDelete 후 사용자에게 중단 보고한다.
- Critical 발견: 나머지 리뷰는 계속하되 최종 판정은
must-fix를 포함한 차단 상태로 둔다.
- TeamDelete 실패: 숨기지 않고 수동 정리 필요 항목을 보고한다.
최종 응답 형식
사용자에게는 세 가지만 보고한다.
- 차단 이슈 수와 파일 위치.
- 권고 이슈 수.
- 전체 리포트 경로
_workspace/pr-review/final-review.md.
