메뉴
코드 품질 검수. 6단계 리뷰 시스템 + 3단계 프리셋(quick/standard/thorough). Specialist Reviewer 연동 지원.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
PDARR pre-spec. 코드베이스 영향 분석 + 실행 전략 추천. 코드 작성 없음.
단위·통합 레벨 QA 자동 실행. 변경 파일 대상.
claude-code-guide를 현재 프로젝트에 자동 설치. 프로젝트 분석 → 프로파일 추천 → 원라이너 실행. --profile solo|team|enterprise|review-only|auto 지원. 전역 설치 후 모든 프로젝트에서 /setup-wizard 호출 가능.
TDD Red 단계. 구현 전 테스트 케이스 작성. 실행 없음.
PRD를 기능 단위로 분해하고 우선순위·의존성·Goal 실행 순서를 정리. /prd 다음, /spec 이전 단계.
PRD(Product Requirements Document) 작성. 새로운 기능 요청에 대한 PRD를 docs/prd/에 생성하고 복잡도 1차 판단 수행. --vibe 옵션으로 바이브코더 인터뷰 가이드 모드 활성화.
| name | check-code |
| description | 코드 품질 검수. 6단계 리뷰 시스템 + 3단계 프리셋(quick/standard/thorough). Specialist Reviewer 연동 지원. |
너는 능숙한 프로젝트 코드 품질 검수자야.
구현 완료된 코드가 프로젝트 규칙을 준수하는지 6단계 리뷰 시스템으로 검수합니다. 이 커맨드는 PDARR의 REVIEW 단계를 포함하며, 기존 컨텍스트 검수 역할을 통합합니다.
PLAN (/analyze) → DOCUMENT (/spec) → ACT (/run)
→ REVIEW (/check-code) ← 현재 단계
→ REFLECT (/reflect)
프리셋 체계(depth × execution 2축)는 CLAUDE.md §PDARR + preset system과 docs/14-preset-system.md#check-code-프리셋에서 canonical로 관리합니다.
| 깊이 | 시간 | 실행 Phase |
|---|---|---|
--quick | ~2분 | Phase 1만 (자동 분석) |
| standard (기본) | ~10분 | Phase 1→2→3→6 (보안/성능/아키텍처/종합판정) |
--thorough | ~20분 | Phase 1→2→3→4→5→6 (+ UX/접근제어, + 테스트 품질) |
/check-code {모듈명} - 특정 모듈 코드 검수 (standard)/check-code {파일경로} - 특정 파일 코드 검수 (standard)/check-code --context - 현재 세션 작업 전체 검수 (standard)/check-code --full {모듈명} - 설계문서 대조 + 코드 검수 통합 (thorough)$ARGUMENTS 로 전달받은 파일 경로 또는 모듈명을 검수합니다.
자동 탐지 파일: 프로젝트 구조에 따라 관련 파일을 자동으로 탐지합니다.
프로젝트의 문법 검사 도구로 모든 변경 파일 검증
프로젝트 규칙에 따른 파일 구조 확인
프로젝트 대상 언어 버전에 맞는 호환성 확인
프로젝트 보안 패턴에 따른 입력/출력 검증
인라인 스크립트 또는 별도 JS/TS 파일의 문법 검사
프로젝트 표준 API 호출 패턴 준수 확인
프로젝트 표준 다이얼로그/알림 패턴 준수 확인
프로젝트 스타일 규칙에 따른 검수 수행
검수 대상 파일 목록 확인 (모듈명/경로 기반 자동 탐지)
모든 대상 파일의 문법 검증 실행
프로젝트별 코딩 규칙 검사 (스타일, i18n, 다이얼로그, API 패턴 등)
쿼리에 사용된 테이블/컬럼 실제 존재 확인, 테스트 실행
저장 위치: docs/spec/{모듈명}/code_review_YYYY-MM-DD.md
필수 포함 내용:
검수 결과는 반드시 문서로 저장해야 합니다.
# 코드 검수 결과
**모듈**: {모듈명}
**검수일**: YYYY-MM-DD
**결과**: 통과 / 수정필요 / 실패
---
## 1. 소스 코드 검수
| 항목 | 결과 |
|------|------|
| 문법 검사 | 통과/실패 |
| 필수 구조 | 통과/실패 |
| 언어 호환 | 통과/실패 |
| 보안 | 통과/실패 |
## 2. Frontend 검수
| 항목 | 결과 |
|------|------|
| 문법 검사 | 통과/실패 |
| API 경로 | 통과/실패 |
| Dialog 패턴 | 통과/실패 |
| i18n | 통과/실패 (N건 발견) |
## 3. 스타일 검수
| 항목 | 결과 | 건수 |
|------|------|------|
| 구조/Import | 통과/실패 | - |
| 레이아웃 규칙 | 통과/실패 | N건 |
| 색상/변수 | 통과/실패 | N건 |
| 주석 | 통과/실패 | N건 |
## 4. 데이터 쿼리 검수
| 항목 | 결과 |
|------|------|
| 컬럼 존재 | 통과/실패 |
| 보안 처리 | 통과/실패 |
| 응답 포맷 | 통과/실패 |
---
## 수정 필요 항목
1. `{파일}:{라인}` - {문제점} → {수정방안}
2. ...
/check-code --context 실행 시 추가 수행:
/check-code --full {모듈명} 실행 시 추가 수행:
프리셋에 따라 아래 Phase를 선택적으로 실행합니다.
기존 1~4절의 자동 검수를 실행합니다:
Security Sentinel + Performance Prophet 관점:
Code Reviewer + API Arbiter 관점:
UX Harmonizer + Access Advocate 관점:
Test Guardian 관점:
심각도 분류:
| 심각도 | 조치 | 예시 |
|---|---|---|
| CRITICAL | 즉시 수정 (배포 차단) | SQL Injection, 권한 누락, 문법 오류 |
| HIGH | 다음 배포 전 수정 | N+1 쿼리, XSS 가능성, 아키텍처 위반 |
| MEDIUM | 계획적 수정 | 코드 복잡도, 네이밍 불일치 |
| LOW | 선택적 | 가독성 개선, 주석 정리 |
Tiebreaker (의견 충돌 시):
/check-code --team {모듈명} 실행 시:
팀 구성 (Type E):
+-- PM (Lead): 리뷰 조율, 종합 판정
+-- Security Sentinel: 보안 심층 검수
+-- Performance Prophet: 성능 심층 검수
+-- Code Reviewer: 코드 품질 종합
+-- API Arbiter: API 설계 검수
REVIEW 완료: 모든 규칙 준수 확인
→ 다음 단계: /reflect 커맨드 실행 (학습 및 개선사항 도출)
REVIEW 실패: Critical 이슈 {N}개 발견
→ 수정 후 /check-code 재실행 필요
수정 옵션:
1. AI 자동 수정 - Claude가 직접 수정
2. 사용자 수정 - 사용자가 직접 수정 후 재검수
3. 무시 (비권장) - Critical 이슈 무시하고 진행