원클릭으로 Manus에서 모든 스킬 실행

korean-pr-convention

스타1

포크0

업데이트2026년 6월 23일 14:26

ddan-ddan-server의 한국어 이슈/브랜치/PR 컨벤션. 이슈 제목 형식 [작업타입] 설명, 브랜치명 타입/#번호-설명, PR 제목 타입 설명, PR 본문 템플릿(작업 내용/기타/close 이슈) 패턴을 다룬다. 이슈 생성, 브랜치 생성, PR 생성 시 반드시 참조 — 팀 컨벤션 위반은 PR이 즉시 반려되는 사유다.

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

ddan-dda-ra

ddan-dda-ra/ddan-ddan-server

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

Korean PR Convention (ddan-ddan-server)

작업 타입

타입	용도
`feat`	새로운 기능 추가
`refactor`	동작 변경 없는 코드 정리
`fix`	버그 수정
`bug`	버그 수정 (`fix`와 혼용 — 최근 커밋 기준)
`docs`	문서/주석 수정
`chore`	빌드, 의존성, CI/CD, 설정

이슈

제목

[작업타입] 간단한 한국어 설명

예: [feat] 응원하기 API 추가
예: [refactor] Ranking 기능 레이어드 아키텍처로 변경
예: [fix] 초대수락자 이름이 뜨도록 수정

본문

작업 목적과 세부사항을 한국어로 기재. 길이 자유.

명령

gh issue create --title "[chore] Codex 하네스 구성" --body "..."

브랜치

명명 규칙

{타입}/#{이슈번호}-{간단한-영어-설명}

예: feature/#190-ranking-refactor-to-layered
예: fix/#261-invite-acceptor-name
예: chore/#194-Codex-harness-setup

주의: 디렉토리 깊이 표현으로 /가 들어간다. git checkout -b feature/#NNN-...로 만들 수 있다 (zsh 기준 따옴표 불필요하지만, #는 코멘트 문자이므로 인용 권장).

git checkout -b "chore/#194-Codex-harness-setup"

타입 → 브랜치 prefix 매핑

작업 타입	브랜치 prefix
feat	`feature/`
refactor	`refactor/`
fix / bug	`fix/`
docs	`docs/`
chore	`chore/`

브랜치 prefix와 PR 타입이 살짝 다름에 유의 (feat ↔ feature/).

PR

타겟 브랜치

항상 develop. main/master 직접 PR 금지.

제목

{타입}: {한국어 설명}

예: feat: 초대코드로 초대자 정보 조회 API 추가
예: refactor: 응원하기 API 성능 개선
예: chore: Codex 하네스 구성

주의: 제목 끝에 이슈 번호 (#N) 붙이지 않는다. 이슈 연결은 본문의 close #N으로 처리.

본문 템플릿

.github/pull_request_template.md를 따른다:

## 🔎 작업 내용
- 항목 1
- 항목 2

## ➕ 기타
- 추가 컨텍스트, 스크린샷, 리뷰어가 알아야 할 점

close #이슈번호

명령

gh pr create --title "chore: Codex 하네스 구성" --body "$(cat <<'EOF'
## 🔎 작업 내용
- ...

## ➕ 기타
- ...

close #194
EOF
)"

표준 워크플로우

# 1. 이슈 생성
gh issue create --title "[chore] Codex 하네스 구성" --body "..."
# → 이슈 번호 N 확인

# 2. 브랜치 생성 (develop 최신화 후)
git checkout develop
git pull
git checkout -b "chore/#N-Codex-harness-setup"

# 3. 작업 + 커밋
git add ...
git commit -m "chore: Codex 하네스 구성"

# 4. push
git push -u origin "chore/#N-Codex-harness-setup"

# 5. PR
gh pr create --title "chore: Codex 하네스 구성" --body "..."

자주 하는 실수

실수	올바른 형태
PR 제목 끝에 `(#194)`	본문에 `close #194`
브랜치를 `feat/...`로 시작	`feature/...`
이슈 제목에 `feat:` (콜론)	`[feat]` (대괄호)
PR을 main으로	develop으로
영어 본문	한국어 본문

이 저장소의 다른 Skills

같은 저장소

ddan-ddan-feature-dev

ddan-dda-ra/ddan-ddan-server

ddan-ddan-server의 기능 개발/버그 수정/리팩토링 워크플로우 오케스트레이터. 이슈 분석 → 설계 → 구현 → 테스트·API 문서 → 리뷰 → PR 생성을 6개 전문 에이전트(issue-analyzer, backend-architect, kotlin-spring-implementer, test-engineer, api-documenter, code-reviewer)가 협업하여 자동화한다. 다음 표현이 등장하면 반드시 트리거할 것 - "기능 추가", "API 만들어줘", "이슈

2026-06-231

kotest-testing-patterns

ddan-dda-ra/ddan-ddan-server

ddan-ddan-server의 테스트 작성 가이드. Kotest 5.9.1 FunSpec + MockK 1.13.11 조합, beforeEach 초기화, 한국어 테스트명, shouldBe/shouldThrow assertion DSL을 다룬다. 모든 테스트 코드 작성/수정 시 반드시 참조 — 이 프로젝트는 JUnit 어노테이션 스타일이 아닌 Kotest FunSpec 스타일을 표준으로 사용한다.

2026-06-231

kotlin-spring-conventions

ddan-dda-ra/ddan-ddan-server

ddan-ddan-server의 Kotlin/Spring Boot/MongoDB 코드 컨벤션. 생성자 주입, @Document 엔티티, JWT 인증, WebExceptionHandler 글로벌 예외 처리, LoggingFilter, OpenAPI 문서화 패턴을 다룬다. 새 코드 작성과 코드 리뷰 시 반드시 참조 — 컨벤션 위반은 PR 리뷰의 가장 잦은 지적 사유다.

2026-06-231

layered-architecture-guide

ddan-dda-ra/ddan-ddan-server

ddan-ddan-server의 layered 아키텍처 의존 규칙과 패키지 구조 가이드. domain/application/infrastructure/presentation 4개 레이어의 책임, 의존 방향, Gateway 패턴(폐기 예정) 처리 방침을 다룬다. 새 코드 추가, 리팩토링, 코드 리뷰 시 반드시 참조할 것 — 레이어 의존 위반은 가장 흔하고 가장 치명적인 결함이다.

2026-06-231

ddan-ddan-feature-dev

ddan-dda-ra/ddan-ddan-server

ddan-ddan-server의 기능 개발/버그 수정/리팩토링 워크플로우 오케스트레이터. 이슈 분석 → 설계 → 구현 → 테스트 → 리뷰 → PR 생성을 5개 전문 에이전트(issue-analyzer, backend-architect, kotlin-spring-implementer, test-engineer, code-reviewer)가 협업하여 자동화한다. 다음 표현이 등장하면 반드시 트리거할 것 - "기능 추가", "API 만들어줘", "이슈

2026-05-021

korean-pr-convention

ddan-dda-ra/ddan-ddan-server

2026-05-021

name	korean-pr-convention
description	ddan-ddan-server의 한국어 이슈/브랜치/PR 컨벤션. 이슈 제목 형식 [작업타입] 설명, 브랜치명 타입/#번호-설명, PR 제목 타입 설명, PR 본문 템플릿(작업 내용/기타/close 이슈) 패턴을 다룬다. 이슈 생성, 브랜치 생성, PR 생성 시 반드시 참조 — 팀 컨벤션 위반은 PR이 즉시 반려되는 사유다.

Korean PR Convention (ddan-ddan-server)

작업 타입

타입	용도
`feat`	새로운 기능 추가
`refactor`	동작 변경 없는 코드 정리
`fix`	버그 수정
`bug`	버그 수정 (`fix`와 혼용 — 최근 커밋 기준)
`docs`	문서/주석 수정
`chore`	빌드, 의존성, CI/CD, 설정

이슈

제목

[작업타입] 간단한 한국어 설명

예: [feat] 응원하기 API 추가
예: [refactor] Ranking 기능 레이어드 아키텍처로 변경
예: [fix] 초대수락자 이름이 뜨도록 수정

본문

작업 목적과 세부사항을 한국어로 기재. 길이 자유.

명령

gh issue create --title "[chore] Codex 하네스 구성" --body "..."

브랜치

명명 규칙

{타입}/#{이슈번호}-{간단한-영어-설명}

예: feature/#190-ranking-refactor-to-layered
예: fix/#261-invite-acceptor-name
예: chore/#194-Codex-harness-setup

git checkout -b "chore/#194-Codex-harness-setup"

타입 → 브랜치 prefix 매핑

작업 타입	브랜치 prefix
feat	`feature/`
refactor	`refactor/`
fix / bug	`fix/`
docs	`docs/`
chore	`chore/`

브랜치 prefix와 PR 타입이 살짝 다름에 유의 (feat ↔ feature/).

PR

타겟 브랜치

항상 develop. main/master 직접 PR 금지.

제목

{타입}: {한국어 설명}

예: feat: 초대코드로 초대자 정보 조회 API 추가
예: refactor: 응원하기 API 성능 개선
예: chore: Codex 하네스 구성

주의: 제목 끝에 이슈 번호 (#N) 붙이지 않는다. 이슈 연결은 본문의 close #N으로 처리.

본문 템플릿

.github/pull_request_template.md를 따른다:

## 🔎 작업 내용
- 항목 1
- 항목 2

## ➕ 기타
- 추가 컨텍스트, 스크린샷, 리뷰어가 알아야 할 점

close #이슈번호

명령

gh pr create --title "chore: Codex 하네스 구성" --body "$(cat <<'EOF'
## 🔎 작업 내용
- ...

## ➕ 기타
- ...

close #194
EOF
)"

표준 워크플로우

# 1. 이슈 생성
gh issue create --title "[chore] Codex 하네스 구성" --body "..."
# → 이슈 번호 N 확인

# 2. 브랜치 생성 (develop 최신화 후)
git checkout develop
git pull
git checkout -b "chore/#N-Codex-harness-setup"

# 3. 작업 + 커밋
git add ...
git commit -m "chore: Codex 하네스 구성"

# 4. push
git push -u origin "chore/#N-Codex-harness-setup"

# 5. PR
gh pr create --title "chore: Codex 하네스 구성" --body "..."

자주 하는 실수

실수	올바른 형태
PR 제목 끝에 `(#194)`	본문에 `close #194`
브랜치를 `feat/...`로 시작	`feature/...`
이슈 제목에 `feat:` (콜론)	`[feat]` (대괄호)
PR을 main으로	develop으로
영어 본문	한국어 본문