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 스킬을 활용한 일반적인 개발 흐름입니다.

작업 후 변경 사항을 확인하고 커밋+푸시합니다.

), }, { title: 'MR 생성 — /mr', content: ( <>

feature 브랜치에서 develop으로 MR을 생성합니다.

/mr은{' '} /push + MR + 릴리즈 노트를 한 번에 처리합니다. MR 생성 후 리뷰 대기 또는 claude-bot 자동 승인+머지를 선택할 수 있습니다.

), }, { title: '릴리즈 — /release (관리자)', content: ( <>

develop → main 릴리즈 MR을 생성하고, 봇이 자동 승인합니다.

/release는 리포 admin 권한이 필요합니다. ), }, ]} /> {/* 커스텀 에이전트 */}

커스텀 에이전트

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

explorer

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

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

implementer

모듈 단위 구현 에이전트

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

reviewer

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

  • 체크리스트 기반 검증
  • 높은 자율성
  • 모델: Sonnet
{/* 사전 준비 */}

사전 준비

스킬을 사용하려면 다음이 필요합니다.

  • GITEA_TOKEN 환경변수 설정 — 초기 환경 설정 가이드의 "Gitea API 토큰 설정" 참고
  • Claude Code 설치npm install -g @anthropic-ai/claude-code
  • 프로젝트 초기화/init-project 실행으로 팀 설정 자동 적용
GITEA_TOKEN은{' '} settings.json의{' '} env 필드에서도 설정할 수 있습니다. 환경변수와 settings.json 모두 설정된 경우 환경변수가 우선합니다.
); }