> 이 문서는 AI 코드리뷰 에이전트(이하 **Codex**)가 일관된 기준으로 리뷰·수정 제안을 하도록 돕는 **리뷰 규범**입니다. 팀 합의에 맞게 자유롭게 수정하세요.
Sign in to like and favorite skills
이 문서는 AI 코드리뷰 에이전트(이하 Codex)가 일관된 기준으로 리뷰·수정 제안을 하도록 돕는 리뷰 규범입니다. 팀 합의에 맞게 자유롭게 수정하세요.
.envblackisortflake8ruffnumpymypyeslintprettiertsc --noEmitapt-get update && installHEALTHCHECKpydanticpandera| 등급 | 기준 | 권장 액션 |
|---|---|---|
| S0 - Blocker | 보안 취약점, 데이터 손상, 대규모 성능 퇴행 | 머지 금지, 즉시 수정 제안/패치 |
| S1 - High | 장애 가능성, 주요 기능 오동작 | 머지 보류, 수정 후 재검토 |
| S2 - Medium | 베스트프랙티스 위반, 커버리지 부족 | 제안 적용 권고, 필요 시 추가 테스트 |
| S3 - Low | 스타일/사소한 리팩터 | 머지 허용, 추후 정리 태스크 |
@codex review예시(코드 제안 블록):
# 변경 제안 예시 (Python) # TODO: 입력 검증 추가 및 early return if not is_valid(user_input): return make_error("invalid input")
## 목적 - <왜 바꾸는지 한 줄 요약> ## 변경사항 - <핵심 변경 포인트 2~4개> ## 테스트 - [ ] 유닛/통합 테스트 추가 - [ ] 재현 스텝/명령어 ## 영향도 - 마이그레이션/환경변수/문서화 필요 여부 - 역호환 여부 ## 리뷰 포인트 - 집중해서 봐야 할 파일/로직
아래 문구를 PR 코멘트로 붙여 넣어 Codex에 작업을 요청하세요. 필요에 맞게 대괄호 부분을 채우면 됩니다.
@codex review@codex review focusing on security regressions@codex review focusing on performance of [module/function/path]@codex review only for files under [path/glob]@codex suggest unit tests for [module/function], target coverage ≥ [80]%@codex list untested branches/paths and propose tests@codex check that failure/edge cases are covered; propose minimal tests@codex identify hot paths and propose optimizations@codex propose a vectorized rewrite for [loop/file]@codex benchmark [function] with input size [N] and summarize@codex scan for secrets, unsafe eval/exec, SQL/command injection risks@codex review authorization checks around [endpoint/resource]@codex propose safer input validation for [function]@codex apply lint fixes and small refactors limited to non-behavioral changes@codex convert [file] to typed code and add minimal type annotations@codex ensure README/CHANGELOG reflect API updates@codex generate a migration note for [breaking change]@codex assess risk level (S0~S3) and list rollback steps@codex enumerate monitoring/alerting to add for this change/AGENTS.md