code-review-init

/pilot:code-review-init

워크스페이스의 언어별 코드 리뷰 룰 파일 workspace/context/review/{lang}.md 를 셋업한다.

대상 언어: $ARGUMENTS

---

사전 확인

1. $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} 로 진행할까요?" 확인.

2. 워크스페이스 확인:

   • workspace/context/ 디렉토리가 없으면 "워크스페이스 미초기화. /pilot:init 먼저 실행하세요." 안내 후 종료.

3. 대상 경로: workspace/context/review/{lang}.md. workspace/context/review/ 가 없으면 생성한다.

4. 이미 존재 시:

   • "이미 {경로} 존재. 덮어쓸까요? (덮어쓰기 / 백업 후 새로 생성 / 취소)" 질의.
   • 백업 선택 시 {경로}.bak.{timestamp} 로 이동.

---

동작 — 시작 전략 3 종

사용자에게 다음 3 가지 중 택 1 질의:

전략 A — 사전 작성된 예시 복사

${CLAUDE_PLUGIN_ROOT}/examples/code-review/{lang}.md 존재 시 활성화. 부재 시 비활성 (전략 B/C 만 제시).

1. 파일 Read.
2. 헤더 "참고용 예시" 안내 블록 (> 시작 라인 2~3 줄) 제거.
3. 사용자에게 사용 프레임워크 확인 (해당 시):
   • ruby → "Rails 사용? (예/아니오)"
   • php → "Laravel·Symfony·둘 다·둘 다 아님 중 선택"
   • kotlin → "Android·서버사이드 중 선택"
   • java → "Spring 사용? (예/아니오)"
   • javascript·typescript → "React 사용? (예/아니오)"
4. 미사용 프레임워크 섹션 (## Rails 특화 룰 / ## Spring 특화 등) 본문에서 제거.
5. 대상 경로 workspace/context/review/{lang}.md 에 Write.

전략 B — 빈 형식 템플릿 복사

${CLAUDE_PLUGIN_ROOT}/skills/context/shared/review-rules-template.md 사용.

1. 파일 Read.
2. 템플릿 안내 (파일 상단 --- 위) 를 제거하고 --- 아래 본문만 남긴다.
3. {언어} placeholder 를 사람이 읽는 이름 (Python / Ruby / Java 등) 으로 치환. 첫 줄 lint: 예시는 해당 언어 lint 명령으로 바꾸거나 불필요 시 삭제.
4. 대상 경로에 Write.
5. 사용자에게 "빈 형식 생성 완료. 본문의 관용구·패턴 / 자주 나오는 결함 섹션을 직접 채우세요." 안내.

전략 C — AI 생성 (코드베이스 기반)

본 스킬이 직접 LLM 생성:

1. 코드베이스 탐색:

   git ls-files | grep -E '\.({lang 확장자})$' | head -50
   

   상위 5~10 개 파일을 Read 해 패턴 파악 (사용 중인 logger·테스트 프레임워크·DI 컨테이너·ORM 등).

2. review-rules-template.md 형식을 베이스로, 발견된 컨벤션·안티패턴을 자동 추출해 룰화.

3. 생성 결과를 사용자에게 미리보기 로 보여주고 "이대로 저장 / 수정 후 저장 / 취소" 질의.

4. 확정 시 대상 경로에 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 후 주력 언어 셋업