refactor(commit): 커밋 정책을 commit-policy 스킬로 분리한다
This commit is contained in:
24
AGENTS.md
24
AGENTS.md
@@ -99,24 +99,12 @@
|
||||
별도 규칙 파일이 추가되면 본 문서보다 해당 규칙을 우선 반영한다.
|
||||
|
||||
## 커밋 메시지 규칙 (표준 Conventional Commits)
|
||||
기본 형식:
|
||||
```text
|
||||
<type>(scope): <description>
|
||||
```
|
||||
|
||||
핵심 규칙:
|
||||
- `type`은 소문자 사용 (`feat`, `fix`, `chore`, `docs`, `refactor`, `test` 등).
|
||||
- `scope`는 선택 사항이지만 가능하면 모듈 단위로 명시.
|
||||
- 커밋 상세 가이드/절차는 `.opencode/skills/commit-policy/SKILL.md`를 단일 기준으로 사용한다.
|
||||
- 커밋 작업 시작 시 `skill` 도구로 `commit-policy`를 먼저 로드한다.
|
||||
- 기본 형식은 `<type>(scope): <description>`를 사용한다.
|
||||
- `type`은 소문자(`feat`, `fix`, `chore`, `docs`, `refactor`, `test` 등)를 사용한다.
|
||||
- 제목(description)은 한글로 작성하고, 명령형/간결한 현재형으로 작성한다.
|
||||
- 브레이킹 변경은 `!` 또는 `BREAKING CHANGE:` footer로 명시.
|
||||
- 이슈 참조는 footer 사용(예: `Refs: #123`).
|
||||
|
||||
예시:
|
||||
```text
|
||||
feat(chat): 채팅 쿼터 구매 엔드포인트를 추가한다
|
||||
fix(member): 마이페이지 API의 null 인증 주체 처리를 보완한다
|
||||
refactor(content): 랭킹 조회 로직을 전용 리포지토리로 분리한다
|
||||
```
|
||||
- 이슈 참조 footer는 `Refs: #123` 또는 `Refs: #123, #456` 형식을 사용한다.
|
||||
|
||||
### 커밋 메시지 검증 절차
|
||||
- `git commit` 실행 직전에 `work/scripts/check-commit-message-rules.sh`를 실행해 규칙 준수 여부를 확인한다.
|
||||
@@ -127,7 +115,7 @@ refactor(content): 랭킹 조회 로직을 전용 리포지토리로 분리한
|
||||
- 변경 전: 유사 기능 코드를 먼저 찾아 네이밍/예외/응답 패턴을 맞춘다.
|
||||
- 변경 중: 공개 API 스키마를 임의 변경하지 말고, 작은 단위로 안전하게 수정한다.
|
||||
- 변경 후: 최소 단일 테스트 또는 `./gradlew test`를 실행하고, 필요 시 `./gradlew ktlintCheck`를 수행한다.
|
||||
- 커밋 전/후: `git commit` 직전과 직후에 `work/scripts/check-commit-message-rules.sh`를 실행해 커밋 메시지 규칙 준수 여부를 확인한다.
|
||||
- 커밋 전/후: `commit-policy` 스킬을 먼저 로드하고, `git commit` 직전과 직후에 `work/scripts/check-commit-message-rules.sh`를 실행해 커밋 메시지 규칙 준수 여부를 확인한다.
|
||||
|
||||
## 작업 계획 문서 규칙 (docs)
|
||||
- 모든 작업 시작 전에 `docs` 폴더 아래에 계획 문서를 먼저 생성하고, 해당 문서를 기준으로 구현을 진행한다.
|
||||
|
||||
Reference in New Issue
Block a user