prgrms-be-devcourse/NBE12-14-final-homestamp / .agents/skills/code-review
code-review
Verified바뀐 코드가 프로젝트 규칙을 지키는지 검토한다. 번호가 없으면 내 브랜치, PR 번호가 있으면 그 PR을 본다. 사람이 부를 때만 쓴다
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.2 KB |
| agents/openai.yaml | config | 43 B |
SKILL.md
View on GitHub---
name: code-review
description: 바뀐 코드가 프로젝트 규칙을 지키는지 검토한다. 번호가 없으면 내 브랜치, PR 번호가 있으면 그 PR을 본다. 사람이 부를 때만 쓴다
disable-model-invocation: true
---
# 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`로 작성자와 리뷰어를 본다.
1. 바뀐 파일에서 **필요한 주인을 모두** 모은다. 기준은 `pr-body` 스킬 "리뷰어 정하기"의 1단계(CODEOWNERS, 테이블 → 주인, 기능 ID → 주인, 공개 인터페이스·공통 DTO는 만든 주인 + 쓰는 쪽 주인)
2. 그중 **작성자만** 뺀다. 작성자가 자기 것(예: `ActionPipeline`)을 바꿨어도 쓰는 쪽 주인은 남는다
3. 남은 주인 중 리뷰 요청(`reviewRequests`)에도 리뷰(`reviews`)에도 없는 사람이 있으면 결과 맨 위에 한 줄 적는다. "리뷰어 확인 필요"로 분류된 것은 그대로 적는다
```
주인 확인 필요: 05 2-3 action 칸 변경 — B(@yoo-sihun) 리뷰어 없음
주인 확인 필요: ActionPipeline 시그니처 변경 — 쓰는 쪽 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | 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: 322k | 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: 322k | Updated | Claude CodeCodex | Verified | Install |