import { Alert } from '../components/common/Alert'; import { CodeBlock } from '../components/common/CodeBlock'; import { StepGuide } from '../components/common/StepGuide'; const SKILLS = [ { name: '/push', desc: '변경 확인 → 커밋 메시지 자동 제안 → 푸시', perm: 'push' }, { name: '/mr', desc: '커밋 + 푸시 + MR 생성 + 릴리즈 노트 갱신 + 봇 승인/머지 선택', perm: 'push' }, { name: '/release', desc: '릴리즈 노트 정리 + develop→main MR + 봇 승인/머지', perm: 'admin' }, { name: '/version', desc: 'VERSION-HISTORY.md (SemVer) 생성', perm: 'admin' }, { name: '/create-mr', desc: 'MR만 생성 (세부 옵션 지원)', perm: 'push' }, { name: '/fix-issue', desc: 'Gitea 이슈 분석 + 수정 브랜치 생성', perm: 'push' }, { name: '/init-project', desc: '팀 표준 워크플로우로 프로젝트 초기화', perm: '-' }, { name: '/sync-team-workflow', desc: '워크플로우 버전 동기화', perm: '-' }, ]; export default function ClaudeCodeSkills() { return (

Claude Code 활용

Claude Code 스킬을 활용하여 커밋, MR 생성, 릴리즈까지 개발 워크플로우를 자동화할 수 있습니다.

{/* 스킬 일람 */}

스킬 일람

{SKILLS.map((s) => ( ))}
스킬 설명 필요 권한
{s.name} {s.desc} {s.perm === 'admin' ? ( admin ) : s.perm === 'push' ? ( push ) : ( - )}
push 권한은 팀원에게,{' '} admin 권한은 리포지토리 관리자에게 부여됩니다. Gitea 리포 설정에서 확인할 수 있습니다. {/* 개발 프로세스 전체 흐름 */}

개발 프로세스 — 전체 흐름

기능 개발부터 릴리즈까지, Claude Code 스킬을 활용한 전체 개발 흐름입니다.

{/* 시각적 플로우 */}
계획 수립 브랜치 분리 개발 /push /mr /release

복잡한 기능은 구현 전에 계획을 먼저 세웁니다. Claude Code가 코드베이스를 분석하고 구현 방향을 설계합니다.

3개 이상 파일 수정이 필요하거나, 아키텍처에 영향을 주는 변경은 자동으로 플랜 모드로 전환됩니다.

), }, { title: '2. 브랜치 분리 — feature 브랜치 생성', content: ( <>

develop에서 feature 브랜치를 생성하여 독립적으로 개발합니다.

이슈 기반 개발 시 /fix-issue 42를 사용하면 이슈 분석 + 브랜치 생성을 자동으로 처리합니다.

), }, { title: '3. 개발 → /push', content: ( <>

코드 수정 후 /push로 커밋+푸시합니다.

여러 커밋을 쌓지 말고, 하나의 기능 단위로 커밋하세요. /push는 모든 변경을 단일 커밋으로 정리합니다. ), }, { title: '4. MR 생성 — /mr', content: ( <>

기능 완성 후 develop으로 MR(Merge Request)을 생성합니다.

), }, ]} /> {/* 권한별 시나리오 */}

권한별 시나리오

push 권한 개발자

사용 가능: /push, /mr, /create-mr, /fix-issue

1. /push — 변경 커밋+푸시
2. /mr — develop으로 MR 생성
3. "리뷰 대기" 선택 → 관리자에게 리뷰 요청
관리자가 Gitea에서 리뷰 + 승인 → 머지
/release/version은 admin 권한이 필요합니다. 관리자에게 요청하세요.

admin 권한 관리자

추가 사용: /release, /version

1. /push/mr → "봇 승인+머지" 선택
2. feature 머지 완료 후, develop에서:
3. /release — develop→main 릴리즈 MR
↳ 릴리즈 노트 날짜 전환 + 이전 넘버링 압축
↳ claude-bot 자동 승인 → 머지 → CI/CD 배포
4. /version — VERSION-HISTORY.md 생성 (SemVer)
권한은 Gitea 리포지토리 단위로 관리됩니다. gc 조직 →{' '} developers 팀 소속이면 push 권한이 자동 부여됩니다. admin 권한은 프로젝트 관리자가 리포 설정에서 직접 부여합니다. {/* 커스텀 에이전트 */}

커스텀 에이전트

팀 워크플로우에는 특화된 서브에이전트 3종이 포함되어 있습니다. .claude/agents/ 디렉토리에 배치되며,{' '} /init-project로 자동 설정됩니다.

explorer

코드베이스 탐색/분석 에이전트

  • 읽기 전용 (코드 수정 불가)
  • 높은 자율성
  • 모델: Sonnet

implementer

모듈 단위 구현 에이전트

  • 계약 기반 구현
  • 중간 자율성
  • 모델: Sonnet

reviewer

코드 리뷰/품질 검증 에이전트

  • 체크리스트 기반 검증
  • 높은 자율성
  • 모델: Sonnet
{/* 시작하기 */}

시작하기

Claude Code 스킬을 사용하려면 프로젝트에서 /init-project를 한 번 실행하면 됩니다.

1 Claude Code 설치: npm install -g @anthropic-ai/claude-code
2 프로젝트에서 claude 실행 → /init-project
3 GITEA_TOKEN 설정 안내에 따라 토큰 입력 (→ 초기 환경 설정 가이드 참고)

CLAUDE_BOT_TOKEN은{' '} settings.json에 팀 공통으로 포함되어 있어 별도 설정이 필요 없습니다. 팀 워크플로우(rules, skills, agents)는 /push 실행 시 서버 해시 비교를 통해 자동 동기화됩니다.

); }