| name | backend-codeconvention |
| description | 백엔드 코드 컨벤션 검증 스킬. 유저가 "백엔드 코드 컨벤션 수행", "backend-codeconvention", "백엔드 코드 리뷰", "백엔드 컨벤션 체크" 등의 표현을 사용할 때 반드시 이 스킬을 사용한다. git diff로 변경된 Spring Boot 백엔드 파일을 springboot_backend.md 기준으로 자동 검증한다.
|
백엔드 코드 컨벤션 검증
목적
git diff로 변경된 백엔드 파일만 대상으로 springboot_backend.md 코드 컨벤션을 검증한다.
전체 코드베이스가 아닌 변경 분만 검토하므로 빠르고 정확하다.
실행 방법
backend-convention-checker agent를 사용해 아래 작업을 수행한다:
- 변경 파일 감지:
git diff --name-only HEAD 또는 git diff --name-only origin/chatforyou_v2...HEAD 로 변경된 파일 목록 추출
- 백엔드 파일 필터링:
springboot-backend/ 경로 하위 파일만 선별
- 컨벤션 기준 로드:
docs/springboot_backend.md 파일의 코드 컨벤션 규칙 참조
- 검증 수행: 변경된 각 파일에 대해 컨벤션 위반 여부 확인
- 결과 리포트: 위반 항목, 위치(file:line), 수정 가이드 출력
- 구현 가이드 업데이트:
springboot-backend/plan_docs/ 하위 구현 가이드 파일(*.md)이 있다면 실제 검증 결과에 맞춰 체크박스를 업데이트
- 검증 통과 시에만
Code conventions를 [x]
- 검증 미실행 또는 위반 잔존 시
Code conventions는 [ ] 유지
- 필요하면 구현 가이드의
Convention validation 또는 Open Issues 구역에 사유를 짧게 남김
리포트 형식
## 백엔드 코드 컨벤션 검증 결과
### 변경 파일 목록
- springboot-backend/src/.../SomeController.java
- springboot-backend/src/.../SomeService.java
### 위반 사항
| 파일 | 라인 | 규칙 | 내용 | 수정 방법 |
|------|------|------|------|-----------|
| SomeController.java | 42 | 응답 형식 | Map 반환 사용 | ResponseDto<T> 로 교체 |
### 통과 항목
- 패키지 구조: 정상
- ...
### 결론
[통과 / 수정 필요] — 위반 N건
### 체크박스 업데이트 결과
- [x] Code conventions
또는
- [ ] Code conventions (reason: validation not executed / violations remaining)
주의사항
- 변경 파일이 없으면 "변경된 백엔드 파일 없음"으로 종료
- 프론트엔드 파일은 대상에서 제외
- 구현 가이드 체크박스 업데이트는
springboot-backend/plan_docs/*.md 파일이 존재할 때만 수행
- 검증을 실행하지 않았다면 체크박스 갱신 금지
- 위반이 남아 있으면
[x] 선반영 금지
