htlee
72a7655aa5
- Claude Code 활용 가이드 신규 추가 (스킬 8종 + 에이전트 3종) - 릴리즈 관리 가이드 신규 추가 (2계층 릴리즈 노트) - 초기 환경 설정에 GITEA_TOKEN 설정 섹션 추가 - Git 워크플로우에 /push, /mr 스킬 추천 보강 - 프로젝트 시작하기 템플릿 파일 구조 v1.5.0 업데이트 - chat 봇 연동/디자인 시스템 섹션 임시 주석처리 - 팀 워크플로우 v1.5.0 동기화 (스킬, 에이전트, 규칙)
198 lines
5.7 KiB
Markdown
198 lines
5.7 KiB
Markdown
---
|
|
name: mr
|
|
description: 커밋 + 푸시 + Gitea MR을 한 번에 생성합니다
|
|
user-invokable: true
|
|
argument-hint: "[target-branch: develop|main] (기본: develop)"
|
|
---
|
|
|
|
현재 브랜치의 변경 사항을 커밋+푸시하고, Gitea에 MR을 생성합니다.
|
|
타겟 브랜치: $ARGUMENTS (기본: develop)
|
|
|
|
## 수행 단계
|
|
|
|
### 0. 권한 확인
|
|
|
|
```bash
|
|
# GITEA_TOKEN 확인
|
|
if [ -z "$GITEA_TOKEN" ]; then
|
|
echo "GITEA_TOKEN이 필요합니다. Gitea → Settings → Applications에서 생성하세요"
|
|
exit 1
|
|
fi
|
|
|
|
# Gitea API로 리포 권한 조회
|
|
REMOTE_URL=$(git remote get-url origin)
|
|
GITEA_HOST=$(echo "$REMOTE_URL" | sed -E 's|^https?://([^/]+)/.*|\1|')
|
|
REPO_PATH=$(echo "$REMOTE_URL" | grep -oE '[^/]+/[^/]+\.git$' | sed 's/.git$//')
|
|
PERMISSIONS=$(curl -sf "https://${GITEA_HOST}/api/v1/repos/${REPO_PATH}" \
|
|
-H "Authorization: token ${GITEA_TOKEN}")
|
|
CAN_PUSH=$(echo "$PERMISSIONS" | python3 -c "import sys,json; print(json.load(sys.stdin)['permissions']['push'])")
|
|
```
|
|
|
|
- `CAN_PUSH`가 `False`이면: "MR 생성 권한이 필요합니다. 프로젝트 관리자에게 요청하세요." 안내 후 종료
|
|
|
|
### 1. 사전 검증
|
|
|
|
```bash
|
|
# 현재 브랜치 확인 (main/develop이면 중단)
|
|
BRANCH=$(git branch --show-current)
|
|
```
|
|
|
|
- 현재 브랜치가 `main` 또는 `develop`이면: "feature 브랜치에서 실행해주세요" 안내 후 종료
|
|
|
|
### 2. 커밋 + 푸시 (변경 사항이 있을 때만)
|
|
|
|
```bash
|
|
git status --short
|
|
```
|
|
|
|
**커밋되지 않은 변경이 있으면**:
|
|
- 변경 범위(파일 목록, 추가/수정/삭제) 요약 표시
|
|
- Conventional Commits 형식 커밋 메시지 자동 생성
|
|
- **사용자 확인** (AskUserQuestion): 커밋 메시지 수락/수정/취소
|
|
- 수락 시: `git add -A` → `git commit` → `git push`
|
|
|
|
**변경이 없으면**:
|
|
- 이미 커밋된 내용으로 MR 생성 진행
|
|
- 리모트에 push되지 않은 커밋이 있으면 `git push`
|
|
|
|
### 3. MR 대상 브랜치 결정
|
|
|
|
타겟 브랜치 후보를 분석하여 표시:
|
|
|
|
```bash
|
|
# develop과의 차이
|
|
git log develop..HEAD --oneline 2>/dev/null
|
|
# main과의 차이
|
|
git log main..HEAD --oneline 2>/dev/null
|
|
```
|
|
|
|
**사용자 확인** (AskUserQuestion):
|
|
- **질문**: "MR 타겟 브랜치를 선택하세요"
|
|
- 옵션 1: develop (추천, N건 커밋 차이)
|
|
- 옵션 2: main (N건 커밋 차이)
|
|
- 옵션 3: 취소
|
|
|
|
인자($ARGUMENTS)로 브랜치가 지정되었으면 확인 없이 바로 진행.
|
|
|
|
### 4. RELEASE-NOTES.md 갱신 (develop 대상 MR일 때만)
|
|
|
|
타겟이 `develop`일 때 릴리즈 노트를 자동 갱신한다.
|
|
|
|
**4-1. 커밋 분석**
|
|
|
|
```bash
|
|
# develop 대비 현재 브랜치의 커밋 목록 (Conventional Commits 파싱)
|
|
git log develop..HEAD --format="%s"
|
|
```
|
|
|
|
모든 커밋 타입을 타입별 섹션으로 분류:
|
|
|
|
| 타입 | 섹션 |
|
|
|------|------|
|
|
| feat | 추가 |
|
|
| fix | 수정 |
|
|
| refactor, perf | 변경 |
|
|
| docs | 문서 |
|
|
| test | 테스트 |
|
|
| style, chore, ci | 기타 |
|
|
|
|
- 커밋 메시지에서 이슈 번호를 자동 추출하여 `(#번호)` 형태로 연결
|
|
- 커밋 메시지의 scope는 제거하고, 설명부만 사람이 읽기 좋은 형태로 변환
|
|
- 예: `feat(auth): 로그인 검증 로직 추가` → `- 로그인 검증 로직 추가`
|
|
|
|
**4-2. RELEASE-NOTES.md 갱신**
|
|
|
|
`docs/RELEASE-NOTES.md` 파일이 없으면 새로 생성:
|
|
|
|
```markdown
|
|
# Release Notes
|
|
|
|
이 문서는 [Keep a Changelog](https://keepachangelog.com/ko/1.0.0/) 형식을 따릅니다.
|
|
|
|
## [Unreleased]
|
|
```
|
|
|
|
기존 파일이 있으면 `[Unreleased]` 섹션에 항목을 추가한다.
|
|
이미 같은 내용이 있으면 중복 추가하지 않는다.
|
|
|
|
**4-3. 사용자 첨삭 확인**
|
|
|
|
사용자에게 릴리즈 노트 초안을 표시하고 **AskUserQuestion**으로 확인:
|
|
- **질문**: "릴리즈 노트 초안입니다. 수정할 내용이 있으면 알려주세요."
|
|
- 옵션 1: 이대로 진행 (추천)
|
|
- 옵션 2: 수정 (Other 입력)
|
|
- 옵션 3: 릴리즈 노트 생략
|
|
|
|
사용자가 수정 사항을 입력하면 반영 후 커밋.
|
|
생략을 선택하면 릴리즈 노트 변경 없이 MR 생성 진행.
|
|
|
|
**4-4. 추가 커밋 + 푸시**
|
|
|
|
릴리즈 노트 변경이 있으면:
|
|
```bash
|
|
git add docs/RELEASE-NOTES.md
|
|
git commit -m "docs: 릴리즈 노트 업데이트"
|
|
git push
|
|
```
|
|
|
|
### 5. MR 정보 구성
|
|
|
|
```bash
|
|
# 커밋 목록
|
|
git log {target}..HEAD --oneline
|
|
# 변경 파일 통계
|
|
git diff {target}..HEAD --stat
|
|
```
|
|
|
|
- **제목**: 커밋이 1개면 커밋 메시지 사용, 여러 개면 브랜치명에서 추출
|
|
- `feature/ISSUE-42-user-login` → `feat: ISSUE-42 user-login`
|
|
- `bugfix/fix-timeout` → `fix: fix-timeout`
|
|
- **본문**:
|
|
```markdown
|
|
## 변경 사항
|
|
- (커밋 목록 기반 자동 생성)
|
|
|
|
## 관련 이슈
|
|
- closes #이슈번호 (브랜치명에서 추출, 없으면 생략)
|
|
|
|
## 테스트
|
|
- [ ] 빌드 성공 확인
|
|
- [ ] 기존 테스트 통과
|
|
```
|
|
|
|
### 6. Gitea API로 MR 생성
|
|
|
|
```bash
|
|
curl -X POST "https://{host}/api/v1/repos/{owner}/{repo}/pulls" \
|
|
-H "Authorization: token ${GITEA_TOKEN}" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{
|
|
"title": "MR 제목",
|
|
"body": "MR 본문",
|
|
"head": "현재브랜치",
|
|
"base": "타겟브랜치"
|
|
}'
|
|
```
|
|
|
|
### 7. 결과 출력
|
|
|
|
```
|
|
✅ MR 생성 완료
|
|
브랜치: feature/my-branch → develop
|
|
MR: https://gitea.gc-si.dev/gc/my-project/pulls/42
|
|
커밋: 3건, 파일: 5개 변경
|
|
릴리즈 노트: docs/RELEASE-NOTES.md [Unreleased] 갱신됨
|
|
|
|
다음 단계: 리뷰어 지정 → 승인 대기 → 머지
|
|
```
|
|
|
|
## 필요 환경변수
|
|
|
|
- `GITEA_TOKEN`: Gitea API 접근 토큰
|
|
- 없으면: "Gitea 토큰이 필요합니다. Settings → Applications에서 생성하세요" 안내
|
|
|
|
## 기존 /create-mr과의 차이
|
|
|
|
- `/mr`: 커밋+푸시 + 릴리즈 노트 포함, 빠른 실행 (일상적 사용)
|
|
- `/create-mr`: MR 생성만, 세부 옵션 지원 (상세 제어)
|