gc-guide/SKILL.md at ae4d8751fd30a562b991cc9942944d2d6beac55d

htlee 72a7655aa5 feat: 워크플로우 v1.5.0 기준 가이드 콘텐츠 최신화

- Claude Code 활용 가이드 신규 추가 (스킬 8종 + 에이전트 3종)
- 릴리즈 관리 가이드 신규 추가 (2계층 릴리즈 노트)
- 초기 환경 설정에 GITEA_TOKEN 설정 섹션 추가
- Git 워크플로우에 /push, /mr 스킬 추천 보강
- 프로젝트 시작하기 템플릿 파일 구조 v1.5.0 업데이트
- chat 봇 연동/디자인 시스템 섹션 임시 주석처리
- 팀 워크플로우 v1.5.0 동기화 (스킬, 에이전트, 규칙)

2026-03-01 17:59:33 +09:00

3.9 KiB

Raw Blame 히스토리

name	description	user-invokable	argument-hint
version	RELEASE-NOTES.md 기반으로 버저닝 릴리즈 노트(VERSION-HISTORY.md)를 생성합니다	true	[version: 1.0.0] (생략 시 자동 결정)

docs/RELEASE-NOTES.md의 내부 릴리즈 노트를 기반으로 사용자 관점의 docs/VERSION-HISTORY.md를 생성/갱신합니다. 버전: $ARGUMENTS (생략 시 변경 타입에 따라 자동 결정)

수행 단계

0. 권한 확인

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}")
IS_ADMIN=$(echo "$PERMISSIONS" | python3 -c "import sys,json; print(json.load(sys.stdin)['permissions']['admin'])")

IS_ADMIN이 False이면: "버전 릴리즈는 프로젝트 관리자만 실행할 수 있습니다." 안내 후 종료
GITEA_TOKEN 미설정: 설정 안내 후 종료

1. RELEASE-NOTES.md 분석

docs/RELEASE-NOTES.md가 없으면 종료: "RELEASE-NOTES.md가 없습니다. 먼저 /mr로 릴리즈 노트를 생성하세요."

cat docs/RELEASE-NOTES.md

2. 수집 범위 결정

docs/VERSION-HISTORY.md가 있으면: 마지막 버전의 날짜를 확인
해당 날짜 이후의 RELEASE-NOTES.md 항목을 수집
VERSION-HISTORY.md가 없으면: 전체 RELEASE-NOTES.md 항목 수집

3. 버전 결정

인자가 있으면 ($ARGUMENTS): 해당 버전 사용

인자가 없으면 자동 결정:

feat 포함 → minor 버전 올림 (x.Y.0)
fix만 → patch 버전 올림 (x.y.Z)
breaking change 포함 → major 버전 올림 (X.0.0)
이전 버전이 없으면 1.0.0부터 시작

4. 사용자 관점으로 재작성

수집된 항목을 다음 섹션으로 재구성:

섹션	포함 기준
주요 변경	사용자가 눈에 띄게 느낄 수 있는 기능 (feat 중 UI/UX 영향 큰 것)
개선	성능/편의성 향상 (refactor, perf, 사소한 feat)
버그 수정	사용자 영향 있는 문제 해결
보안	보안 관련 수정 (해당 시)

변환 규칙:

기술 용어 → 사용자 언어로 재작성
관련 항목 그룹핑 (여러 커밋이 하나의 기능이면 합침)
docs, test, chore, ci 등 사용자에게 보이지 않는 변경은 제외
각 항목은 사용자가 "이게 뭐가 바뀐 거지?" 이해할 수 있는 수준으로

5. 초안 표시 + 첨삭 확인

초안을 표시하고 AskUserQuestion으로 확인:

질문: "VERSION-HISTORY.md 초안입니다. 수정할 내용이 있으면 알려주세요."
옵션 1: 이대로 진행 (추천)
옵션 2: 수정 (Other 입력)

6. VERSION-HISTORY.md 갱신

파일이 없으면 새로 생성:

# Version History

이 프로젝트는 [Semantic Versioning](https://semver.org/lang/ko/)을 따릅니다.

새 버전을 기존 내용 위에 추가:

## [1.2.0] - 2026-03-01

### 주요 변경
- **해역별 조업 현황 대시보드 추가**: 지도에서 해역을 선택하면 실시간 조업 통계를 확인할 수 있습니다

### 개선
- 지도 레이어 전환 속도 향상

### 버그 수정
- 야간 배치 실행 시 타임아웃 발생하던 문제 수정

> 내부 릴리즈: 2026-02-28 ~ 2026-03-01 (3건)

마지막 줄에 참조한 내부 릴리즈 날짜 범위와 건수를 표시.

7. 커밋

git add docs/VERSION-HISTORY.md
git commit -m "docs: v$VERSION 릴리즈 노트 작성"
git push

8. 결과 출력

✅ 버전 릴리즈 노트 작성 완료
  버전: 1.2.0
  파일: docs/VERSION-HISTORY.md
  기반: RELEASE-NOTES.md (2026-02-28 ~ 2026-03-01, 3건)

필요 환경변수

GITEA_TOKEN: Gitea API 접근 토큰 (필수)

3.9 KiB Raw Blame 히스토리