prgrms-be-devcourse/NBE12-14-final-homestamp / .agents/skills/code-review
code-review
Verified바뀐 코드가 프로젝트 규칙을 지키는지 검토한다. 번호가 없으면 내 브랜치, PR 번호가 있으면 그 PR을 본다. 사람이 부를 때만 쓴다
code-review
바뀐 코드만 보고 규칙 위반을 찾는다. 파일은 고치지 않고, PR에 코멘트를 올리지도 않는다.
보는 범위
입력에 PR 번호가 있으면(/code-review 20, "PR #20 리뷰") 그 PR을, 없으면 지금 브랜치를 본다.
| 입력 | 보는 것 |
|---|---|
| 없음 (내 브랜치) | 1. git diff origin/dev...HEAD — 이 브랜치에서 커밋한 변경 2. git diff HEAD — 아직 커밋하지 않은 변경 (있으면 같이 본다) |
| PR 번호 | gh pr view <번호> --json title,body,baseRefName,headRefName,files 로 PR 정보, gh pr diff <번호> 로 변경 |
PR을 볼 때 지킬 것:
- 브랜치를 바꾸지 않는다.
gh pr checkout·git switch·git checkout을 쓰지 않는다 (사람이나 다른 에이전트가 지금 브랜치에서 작업 중일 수 있다) - 주변 코드를 읽으면 그 파일은 PR이 아니라 지금 체크아웃된 상태다. 판단은
gh pr diff의 줄을 기준으로 하고, 주변 코드를 근거로 쓴 지적에는 "(주변 코드는 지금 브랜치 기준)"을 붙인다 gh가 없거나 로그인이 안 돼 있으면 그렇게 알리고 멈춘다
바뀐 줄을 이해하는 데 필요하면 주변 코드를 읽어도 되지만, 지적은 바뀐 줄에만 한다.
볼 것
- 팀 규칙 (
AGENTS.md)- 이미
dev에 들어간 Flyway 마이그레이션(V*.sql)을 고쳤는지 → 새 V 파일로 해야 한다 - 비밀값(키, 비밀번호, 토큰)이 코드·설정 파일에 들어갔는지
- 이미
- 트랜잭션: 쓰기 작업에 트랜잭션이 없거나, 트랜잭션 안에서 외부 호출(HTTP, 메일)을 하는지
프로젝트 원칙 점검
기준은 원본 문서다. 아래는 코드에서 확인할 수 있는 것만 뽑은 점검 목록이고, 판단이 애매하면 원본을 읽는다.
원본: docs/decisions.md "늘 지키는 원칙" · docs/rules/09-프로젝트-구조.md 3장 "부르는 방향" · docs/rules/03-상태와-규칙.md 3장 "역할별 권한 표". 수용 기준·API·오류 코드는 docs/rules/06-요구사항-명세.md, 권한·불변식은 03에서 본다(06 0장 "주제별로 더 깊게"). 기능·수용 기준·API가 06과 다르면 06에 맞춰 고칠 곳으로 적는다. 단, 늘 지키는 원칙·03 5장 불변식·03 3장 권한 표와 06이 다르면 어느 쪽으로도 판정하지 않고 "문서가 서로 다름 — /decide 필요"로 적는다
| 원칙 | 코드에서 볼 것 |
|---|---|
덧붙이기만 (원칙 1, 05-ERD-초안.md 0장 "테이블 세 종류") | 위반: A(행동 기록)·B(사실 행)를 고치거나 지움, C(상태 행)에서 상태·기한·version·"지금 판" 말고 다른 칸을 바꿈, apply(*Transitions, 09 4장) 밖에서 C의 상태를 바꿈. 정상: apply가 C의 그 칸들을 바꾸는 것, B를 고칠 때 이전 판을 가리키는 새 행을 만드는 것. 예외(고치고 지울 수 있음): 같은 문서 "원칙의 예외"의 신원·연락처 칸, 개인정보가 찍힌 사진 파일 |
| 서버 시각만 (원칙 5) | 요청으로 받은 시각을 기록 시각으로 저장 |
| 개인정보 (원칙 7) | 주민등록번호 칸, 외부 CDN·OCR·분석 SDK 의존성 추가, 가리지 않은 휴대폰 번호를 응답에 담음 |
| 막히는 쪽으로 (원칙 8) | 가리기·보호 처리가 실패했을 때 catch에서 원본을 그대로 저장·응답하고 넘어감 |
| 도메인을 넘는 참조 (09) | 다른 도메인 엔티티에 JPA 관계(@ManyToOne 등) — ID 값만 가져야 한다 |
| 부르는 방향 (09) | 아래층(action·correction·notification)·global이 도메인을 import, respond가 아닌 곳에서 respond를 부름, 09 "같은 도메인 층끼리 방향" 표에 없는 방향으로 부름 |
| 잠금 (09) | 행동을 처리하면서 호실 기록 행을 맨 먼저 잠그지 않음 |
| 권한 (03) | 권한 표의 △ 조건("상대 측만", "등록 측", "초대받은 사람") 확인이 빠짐, 링크 열람자가 ✕ 행동을 할 수 있음 |
판정하지 않는다(원칙 3)처럼 문구·설계에 관한 원칙은 이 리뷰에서 보지 않는다 (사람이 PR에서 본다).
안 볼 것
- 들여쓰기, 줄바꿈, import 순서 (포매터가 맞춘다)
- 이름 취향, "이렇게 쓰면 더 예쁘다" 같은 의견
결과 모양
back/src/main/java/.../LeaseService.java:42 — 세입자 ID를 확인하지 않아 다른 사람 계약을 조회할 수 있음
back/src/main/resources/db/migration/V1__init.sql:10 — dev에 들어간 마이그레이션 수정, 새 V 파일로 옮길 것
- 한 줄에 하나,
파일:줄 — 한 줄 이유 - 심각한 것부터
- 없으면
위반 없음한 줄
PR 번호로 봤을 때 덧붙일 것
주인 확인: gh pr view <번호> --json author,reviewRequests,reviews로 작성자와 리뷰어를 본다.
- 바뀐 파일에서 필요한 주인을 모두 모은다. 기준은
pr-body스킬 "리뷰어 정하기"의 1단계(CODEOWNERS, 테이블 → 주인, 기능 ID → 주인, 공개 인터페이스·공통 DTO는 만든 주인 + 쓰는 쪽 주인) - 그중 작성자만 뺀다. 작성자가 자기 것(예:
ActionWriter)을 바꿨어도 쓰는 쪽 주인은 남는다 - 남은 주인 중 리뷰 요청(
reviewRequests)에도 리뷰(reviews)에도 없는 사람이 있으면 결과 맨 위에 한 줄 적는다. "리뷰어 확인 필요"로 분류된 것은 그대로 적는다
주인 확인 필요: 05 2-3 action 칸 변경 — B(@yoo-sihun) 리뷰어 없음
주인 확인 필요: ActionWriter 시그니처 변경 — 쓰는 쪽 A·C·D 중 @jinni1 리뷰어 없음
리뷰어 확인 필요: deletion_log 변경 (07 0장에 주인 없음)
결과 아래에 PR 코멘트 초안을 한 덩어리로 붙인다 (위 목록을 PR 작성자가 읽기 쉬운 문장으로, AI 도구 서명 없이).
이 스킬은 코멘트를 올리지 않는다. 사람이 초안을 보고 승인하면, 메인 에이전트나 사람이 gh pr review <번호> --comment --body-file -로 올린다.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |