assignment-review

과제 전형 리뷰 명령

제출 전 과제(take-home) 레포를 채용사 시니어 프론트엔드 리뷰어 시점으로 평가합니다. 요구사항 충족은 Binary로, 코드 품질은 점수 앵커 기반으로 판정하며, 이 코드를 본 면접관이 실제로 물어볼 "예상 리뷰어 질문"을 함께 생성합니다.

사용법

/assignment-review ./my-assignment docs/requirements.md               # 요구사항 문서 기준 평가
/assignment-review ./my-assignment docs/requirements.md jd/[회사].md  # JD 정합성 평가 포함
/assignment-review ./my-assignment                                    # 요구사항 미확인 모드 (경고 포함)

---

실행 절차

경로 규칙: 입력 경로와 산출물 경로는 모두 커맨드를 실행한 현재 작업 디렉토리 기준입니다.

1단계: 입력 검증

1. 과제 레포 경로 확인: 첫 번째 인자의 디렉토리가 존재하는지 확인합니다.
   • 미존재 시: 현재 디렉토리의 하위 디렉토리 목록을 보여주고 경로 확인을 요청한 뒤 중단합니다. 임의로 추측해 진행하지 않습니다.
2. 요구사항 문서 확인 (두 번째 인자):
   • 경로가 지정되었는데 파일이 없으면 경로 확인을 요청하고 중단합니다 (오타 가능성이 높으므로 조용히 미확인 모드로 전환하지 않습니다)
   • 인자가 생략되었으면 레포 안에서 요구사항 문서로 보이는 파일 (REQUIREMENTS.md, ASSIGNMENT.md, docs/ 내 과제 안내 등)을 Glob으로 탐색해 후보로 제시하고, AskUserQuestion으로 후보 파일 사용 / 요구사항 미확인 모드 진행 / 중단 중 선택을 요청합니다
   • 요구사항 미확인 모드: 요구사항 충족(Binary) 판정 없이 4개 점수 차원만 평가합니다. 보고서 상단에 경고("요구사항 문서 미확인 — Binary 판정 생략됨")를 반드시 남깁니다
3. JD 파일 확인 (세 번째 인자, 선택): 지정되었는데 파일이 없으면 경로 확인을 요청하고 중단합니다.
4. <과제slug> 결정 규칙: 과제 레포 디렉토리의 베이스네임을 영문 소문자 케밥케이스로 정규화합니다 (공백·언더스코어 → 하이픈, 영숫자·하이픈 외 문자 제거. 예: My_Assignment FE → my-assignment-fe). 정규화 결과가 비면 assignment를 사용합니다.

2단계: JD 파싱 (JD 제공 시)

${CLAUDE_PLUGIN_ROOT}/skills/portfolio-strategy/jd-parsing.md의 5슬롯 파싱 규칙을 재사용합니다 (회사·도메인 / 핵심 책임 / 우대 기술 / 시니어리티 / 인재상 — 비정형 JD 처리 규칙 포함). 파싱 결과는 별도 파일로 저장하지 않고 4단계 프롬프트와 최종 보고서의 "JD 요약 (5슬롯)" 절에 기록합니다.

3단계: 레포 자료 수집 (메인 루프)

에이전트 호출 전에 메인 루프가 아래 자료를 직접 수집합니다 (에이전트는 Bash가 없어 git log·실행 검증을 스스로 수행할 수 없습니다):

수집 항목	방법	부재 시 처리
레포 구조	파일 트리 (node_modules·dist·build·.next·.git 제외)	—
package.json	전문 (scripts·dependencies 포함)	"없음"으로 전달 (실행성 판정 근거)
README	README.md 전문	"없음"으로 전달
git log	git -C <레포경로> --no-pager log --reverse --pretty=format:"%h|%ad|%s" --date=short + 총 커밋 수	.git 없으면 "git 저장소 아님"으로 전달
설정 파일	tsconfig·ESLint·Prettier·테스트 설정 파일 존재 여부 목록	—