메뉴
KOIN 프로젝트의 코드 변경사항을 git 커밋하고 GitHub Pull Request를 생성하는 스킬. 브랜치 생성, 커밋, gh CLI를 통한 PR 작성을 담당한다. PR 생성, GitHub PR 작성, 브랜치 커밋, 풀 리퀘스트를 요청할 때 반드시 이 스킬을 사용할 것. 코드 작성이나 수정에는 사용하지 않는다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
SonarCloud 이슈를 KOIN 프로젝트 컨벤션에 맞게 수정하는 스킬. TypeScript 타입 오류, React 패턴 개선, 보안 이슈 수정 방법을 제공한다. SonarCloud 이슈 수정, 코드 품질 개선, 정적 분석 이슈 해결을 요청할 때 반드시 이 스킬을 사용할 것. 새 기능 구현에는 사용하지 않는다.
KOIN 프로젝트의 기능 구현 계획을 실제 코드로 작성하는 스킬. TypeScript, React, SCSS, React Query, Zustand 패턴을 정확히 따르며 코드를 생성한다. 기능 구현, 코드 작성, API 연동, 컴포넌트 생성을 요청할 때 반드시 이 스킬을 사용할 것. 단순 버그 수정에는 사용하지 않는다.
KOIN 프로젝트에 새 기능을 추가하기 위한 구현 계획을 수립하는 스킬. 기능 요구사항 분석, API 설계, 컴포넌트 구조 결정, 파일 목록 생성을 담당한다. 새 기능 구현 계획, 기능 설계, 구현 범위 파악을 요청할 때 반드시 이 스킬을 사용할 것. 이미 계획이 있는 구현 작업에는 사용하지 않는다.
KOIN 프로젝트의 두 가지 AI 파이프라인을 조율하는 오케스트레이터 스킬. (1) SonarCloud 코드 품질 분석 → 이슈 수정 → PR 생성 파이프라인, (2) 기능 요구사항 분석 → 코드 구현 → 검증 → PR 생성 파이프라인을 자동으로 실행한다. "SonarCloud 분석해줘", "SonarCloud 이슈 수정해줘", "코드 품질 개선해줘", "기능 구현해줘", "새 기능 추가해줘", "PR 만들어줘", "파이프라인 실행", "다시 실행", "재실행", "이전 결과 개선", "업데이트" 등의 요청 시 반드시 이 스킬을 사용할 것.
KOIN 프로젝트 코드 변경사항의 품질을 검증하는 스킬. TypeScript 타입 정합성, KOIN 컨벤션 준수, SSR 안전성, 에러 핸들링 패턴을 경계면 교차 비교로 검증한다. 코드 검증, QA, 품질 확인, 리뷰, 수정 검토를 요청할 때 반드시 이 스킬을 사용할 것. 초기 코드 작성에는 사용하지 않는다.
SonarCloud에서 KOIN 프로젝트 코드 이슈를 조회하고 분류하는 스킬. SonarCloud API 호출, 이슈 파싱, 수정 배치 생성을 수행한다. SonarCloud 분석, 이슈 조회, 코드 품질 확인, 정적 분석 결과 파싱 등을 요청할 때 반드시 이 스킬을 사용할 것. 단순 lint 실행이나 ESLint 관련 작업에는 사용하지 않는다.
| name | github-pr-creation |
| description | KOIN 프로젝트의 코드 변경사항을 git 커밋하고 GitHub Pull Request를 생성하는 스킬. 브랜치 생성, 커밋, gh CLI를 통한 PR 작성을 담당한다. PR 생성, GitHub PR 작성, 브랜치 커밋, 풀 리퀘스트를 요청할 때 반드시 이 스킬을 사용할 것. 코드 작성이나 수정에는 사용하지 않는다. |
# 현재 브랜치 확인
git branch --show-current
# git 상태 확인
git status
# gh CLI 인증 확인
gh auth status
# develop에서 분기
git checkout develop
git pull origin develop
# 브랜치 생성
git checkout -b feature/[기능명-kebab-case]
# 또는
git checkout -b fix/sonarcloud-quality-$(date +%Y%m%d)
컨벤셔널 커밋 형식:
feat: [기능명] 추가
fix: [이슈] 수정
refactor: [대상] 리팩토링
style: 코드 스타일 수정 (SonarCloud 이슈 해결)
chore: 기타 변경사항
# 특정 파일만 스테이징 (git add -A 금지)
git add src/components/Feature/index.tsx
git add src/api/feature/
# 커밋
git commit -m "feat: 기능명 추가
- APIDetail.ts: GetFeatureList, PostFeature 클래스 추가
- queries.ts: useFeatureListQuery 훅 추가
- Feature/index.tsx: 목록 컴포넌트 구현"
# PR 생성
gh pr create \
--base develop \
--title "[기능] 기능명 추가" \
--body "$(cat <<'EOF'
## 개요
[기능 설명 1~2줄]
## 변경 사항
### 신규 파일
- `src/api/feature/APIDetail.ts` — API 클래스 정의
- `src/components/Feature/index.tsx` — 목록 컴포넌트
### 수정 파일
- `src/pages/feature/index.tsx` — 컴포넌트 연결
## 테스트 방법
1. `yarn start` 실행
2. `/feature` 페이지 접근
3. 목록 조회 확인
## 체크리스트
- [x] yarn lint 통과
- [x] SSR 안전성 확인
- [x] 에러 핸들링 패턴 적용 (isKoinError)
- [x] 분석 로깅 포함
🤖 Generated with [Claude Code](https://claude.ai/claude-code)
EOF
)"
# PR URL 확인
gh pr view --web
# PR 번호 확인
gh pr list --state open | head -5
.env, .env.local, 시크릿 파일 절대 커밋 금지yarn.lock 변경 없이 lock 파일만 건드리지 않음src/generated/ 파일은 변경하지 않음 (자동 생성 파일)_workspace/ 디렉토리는 PR에 포함하지 않음 (.gitignore에 추가)PR 머지 후:
git checkout develop
git branch -d feature/[기능명]