| name | code-review-init |
| description | 워크스페이스에 언어별 코드 리뷰 룰 파일 (`workspace/context/review/{lang}.md`) 을 셋업한다. `@pilot-code-review` 가 변경 언어의 룰 파일 부재를 인지하면 본 스킬로 1 회성 생성. 3 가지 시작 전략 (예시 복사 / 빈 템플릿 / AI 생성) 중 사용자가 선택. 생성 후 사용자가 본문 편집해 팀 컨벤션 반영. |
/pilot:code-review-init
워크스페이스의 언어별 코드 리뷰 룰 파일 workspace/context/review/{lang}.md 를 셋업한다.
대상 언어: $ARGUMENTS
사전 확인
-
$ARGUMENTS 파싱 — 첫 번째 토큰을 {lang} 슬러그로 사용 (python / typescript / javascript / ruby / php / kotlin / java / go / 또는 임의 슬러그).
-
비어있으면: 현재 디렉토리에서 dominant 확장자 감지하여 슬러그 추론.
git ls-files | awk -F. '{print $NF}' | sort | uniq -c | sort -rn | head -5
매핑: .py/.pyi → python · .ts/.tsx → typescript · .js/.jsx/.mjs/.cjs → javascript · .rb/.rake/.erb → ruby · .php/.phtml → php · .kt/.kts → kotlin · .java → java · .go → go · .rs → rust · .swift → swift · .sql → sql · 그 외 → 사용자에게 슬러그 질의.
사용자에게 "{추정 lang} 로 진행할까요?" 확인.
-
워크스페이스 확인:
workspace/context/ 디렉토리가 없으면 "워크스페이스 미초기화. /pilot:init 먼저 실행하세요." 안내 후 종료.
-
대상 경로: workspace/context/review/{lang}.md. workspace/context/review/ 가 없으면 생성한다.
-
이미 존재 시:
- "이미
{경로} 존재. 덮어쓸까요? (덮어쓰기 / 백업 후 새로 생성 / 취소)" 질의.
- 백업 선택 시
{경로}.bak.{timestamp} 로 이동.
동작 — 시작 전략 3 종
사용자에게 다음 3 가지 중 택 1 질의:
전략 A — 사전 작성된 예시 복사
${CLAUDE_PLUGIN_ROOT}/examples/code-review/{lang}.md 존재 시 활성화. 부재 시 비활성 (전략 B/C 만 제시).
- 파일 Read.
- 헤더 "참고용 예시" 안내 블록 (
> 시작 라인 2~3 줄) 제거.
- 사용자에게 사용 프레임워크 확인 (해당 시):
ruby → "Rails 사용? (예/아니오)"php → "Laravel·Symfony·둘 다·둘 다 아님 중 선택"kotlin → "Android·서버사이드 중 선택"java → "Spring 사용? (예/아니오)"javascript·typescript → "React 사용? (예/아니오)"
- 미사용 프레임워크 섹션 (
## Rails 특화 룰 / ## Spring 특화 등) 본문에서 제거.
- 대상 경로
workspace/context/review/{lang}.md 에 Write.
전략 B — 빈 형식 템플릿 복사
${CLAUDE_PLUGIN_ROOT}/skills/context/shared/review-rules-template.md 사용.
- 파일 Read.
- 템플릿 안내 (파일 상단
--- 위) 를 제거하고 --- 아래 본문만 남긴다.
{언어} placeholder 를 사람이 읽는 이름 (Python / Ruby / Java 등) 으로 치환. 첫 줄 lint: 예시는 해당 언어 lint 명령으로 바꾸거나 불필요 시 삭제.- 대상 경로에 Write.
- 사용자에게 "빈 형식 생성 완료. 본문의
관용구·패턴 / 자주 나오는 결함 섹션을 직접 채우세요." 안내.
전략 C — AI 생성 (코드베이스 기반)
본 스킬이 직접 LLM 생성:
-
코드베이스 탐색:
git ls-files | grep -E '\.({lang 확장자})$' | head -50
상위 5~10 개 파일을 Read 해 패턴 파악 (사용 중인 logger·테스트 프레임워크·DI 컨테이너·ORM 등).
-
review-rules-template.md 형식을 베이스로, 발견된 컨벤션·안티패턴을 자동 추출해 룰화.
-
생성 결과를 사용자에게 미리보기 로 보여주고 "이대로 저장 / 수정 후 저장 / 취소" 질의.
-
확정 시 대상 경로에 Write.
전략 C 주의: 생성된 룰은 LLM 추측 기반. 사용자가 검토·편집 필요. 본 스킬은 "draft" 생성기지 "정답" 생성기 아님.
결과 출력
코드 리뷰 룰 생성: {lang}.md
경로: workspace/context/review/{lang}.md
전략: {examples | empty-template | ai-generated}
요약:
룰 섹션: {N}개
프레임워크 섹션: {유지 항목 또는 "없음"}
▶ 다음 단계:
1. workspace/context/review/{lang}.md 를 열어 본문 검토·편집
2. 팀 컨벤션과 충돌하는 룰은 삭제
3. `/pilot:review` 실행 시 본 파일이 자동 로드됨
Do-NOT
- 기존 파일을 사용자 확인 없이 덮어쓰지 않는다 (사전 확인 4 항).
- 전략 C 의 결과를 자동 저장하지 않는다 (반드시 미리보기 → 사용자 승인).
- 생성된 룰의 정확성을 보증하지 않는다 — 사용자 책임. 본 스킬은 draft 도우미.
workspace/ 외부 경로에 Write 금지.
호출 시점
/pilot:review 결과에서 변경 언어의 {lang}.md 부재로 baseline 만 적용됐음을 인지 → 사용자가 명시 호출- 새 언어 도입 시 (예: TS 프로젝트에 Python 스크립트 추가) 선제적 호출
/pilot:init 후 주력 언어 셋업
