03-skills - Claude Code 스킬 정의

프로젝트에서 /명령어로 직접 실행할 수 있는 Claude Code 스킬 모음입니다. 총 29개 스킬, 7개 카테고리로 분류됩니다.

물리 구조 유지: Claude Code는 skills/*/SKILL.md 한 단계만 스캔하므로 폴더 중첩 불가. 이 README는 가상 카테고리 인덱스 역할을 합니다.

카테고리 인덱스

#	카테고리	스킬 수	핵심 역할
CAT-1	세션 생명주기	3	세션 시작/종료, 중단 재개, 정리
CAT-2	프로젝트 부트스트랩	4	프로젝트 초기화, 오케스트레이션, 웹 구조, 배포 패키지
CAT-3	코드 라이브러리	5	코드 추출/적용, 크롤러, 이미지, 디자인
CAT-4	품질/검증	6	컨벤션, 연결성, E2E, 스파이크, verify
CAT-5	인텔리전스/전략	4	뉴스, 마케팅, 아이디어, 이미지 분석
CAT-6	시스템 메타	5	의존성 맵, 카탈로그, 동기화, 자기반성, MCP
CAT-7	오케스트레이션	2	건강 진단, 멀티에이전트 병렬

CAT-1: 세션 생명주기

프로젝트 세션의 시작, 중단 재개, 종료, 정리를 담당합니다.

스킬	트리거	설명
cs	`/cs`	세션 종료 4단계 프로토콜 (current.md → logs → handover → next-dev-prompt)
kdyplanon	`/kdyplanon`	Plan Mode / Heavy 스킬 중단 작업을 새 터미널에서 이어서 수행
kdyclean	`/kdyclean`	프로젝트 파일/폴더 정리 (빌드 아티팩트, 로그, 임시 파일)

CAT-2: 프로젝트 부트스트랩

신규 프로젝트 생성 및 초기 구조 셋업을 담당합니다.

스킬	트리거	설명
kdysetting	`/kdysetting`	프로젝트 개발 체계 셋팅 (CLAUDE.md, docs 구조)
kdygenesis	`/kdygenesis`	프로젝트 메타 오케스트레이션 (기획→청사진→연쇄실행→확산→동기화)
kdyweb	`/kdyweb`	웹 페이지 구조 관리 (7모드: init/page/verify/audit/migrate/component/evolve)
polnetuploadset	`/polnetuploadset`	폴넷 배포 패키지 자동 생성 (WAR 빌드+운영자 요청서+README+전체 소스코드)

CAT-3: 코드 라이브러리

재사용 코드/디자인 자산의 추출, 적용, 생성을 담당합니다.

스킬	트리거	설명
kdyextract	`/kdyextract`	프로젝트/웹사이트에서 범용 재사용 코드·디자인 자산 추출 및 패키징
kdypick	`/kdypick`	02-reusable-code에서 필요한 코드 선택하여 프로젝트에 적용
crawler-code-generator	`/crawler-code-generator`	UV 환경 웹 크롤링 코드 자동 생성 (Selenium/BS4/Requests)
kdyimagemid	`/kdyimagemid`	Midjourney 이미지 프롬프트 생성 + 최적화 + 자동 배치
ui-ux-pro-max	`/ui-ux-pro-max`	AI UI/UX 디자인 인텔리전스 (67 스타일, 161 팔레트, BM25 검색)

CAT-4: 품질/검증

코드 품질 게이트, 연결성 검증, 테스트, 사전 연구를 담당합니다.

스킬	트리거	설명
kdyconvention	`/kdyconvention`	코드 컨벤션 검증 + 조건부 자기반성 (규칙 스캔 → 자동 수정 → 에이전트 위임)
kdyconecttest	`/kdyconecttest`	웹 프로젝트 연결성 정적 검증 (Import/Export, API매칭, 스키마정합, 환경변수, 데드코드)
kdye2e	`/kdye2e`	E2E 시나리오 도출/실행/개선 (레퍼런스 기반 Playwright)
kdyspike	`/kdyspike`	사전 연구 자동 강제 (난이도 5단계 판별 → 마이크로/풀 스파이크 2트랙 → 검증 게이트)
manage-skills	`/manage-skills`	세션 변경사항 분석 → verify 스킬 드리프트 탐지/수정
verify-implementation	`/verify-implementation`	프로젝트 verify 스킬 통합 실행 + 검증 보고서 생성

CAT-5: 인텔리전스/전략

외부 정보 수집, 시장 분석, 아이디어 발굴을 담당합니다.

스킬	트리거	설명
kdyintel	`/kdyintel`	뉴스·커뮤니티 인텔리전스 + Claude 생태계 감시 (수집→분석→기회 도출)
kdymarket	`/kdymarket`	마케팅 전략 분석 (기회 카드 기반 경쟁분석→채널전략→런치플랜→그로스 전술)
kdyidea	`/kdyidea`	아이디어 발굴 + 프로젝트 기획 (대화→병렬탐색→평가→계획서)
kdyimageanti	`/kdyimageanti`	이미지 분석 및 Antigravity 프롬프트 생성

CAT-6: 시스템 메타

개발 인프라 자체의 유지보수, 동기화, 진화를 담당합니다.

스킬	트리거	설명
inception	`/inception`	5대 시스템 스캔 → _COMPONENT_MAP.md + CLAUDE.md 자동 갱신
kdyupdate	`/kdyupdate`	CLAUDE.md 카탈로그 동기화 (스킬/에이전트 테이블 + 폴더 구조)
kdysync	`/kdysync`	프로젝트↔글로벌 스킬 폴더 양방향 동기화 (03-skills/ ↔ ~/.claude/skills/)
kdyselfreflection	`/kdyselfreflection`	개발 이력 분석 → 스킬/에이전트/규칙/MCP/플러그인/Hooks 진화
kdymcp	`/kdymcp`	MCP 서버 관리 (list/add/remove/validate/health/template/catalog)

CAT-7: 오케스트레이션

여러 스킬을 조합하여 대규모 작업을 자동 실행합니다.

스킬	트리거	설명
kdynext	`/kdynext`	프로젝트 건강 진단 + 스킬 오케스트레이션 (7차원 스캔→DAG→병렬 실행)
kdyswarm	`/kdyswarm`	병렬 멀티에이전트 오케스트레이션 (4계층 가이드라인→N에이전트 DAG 병렬→워크트리 격리→통합)

스킬 간 의존성 흐름

┌─────────────────────────────────────────────────────────────────────┐
│                        CAT-7: 오케스트레이션                         │
│              kdynext ──→ [CAT-1~6 스킬 자동 선택 발동]              │
│              kdyswarm ──→ [N에이전트 병렬 → 통합]                    │
└─────────────────────────────┬───────────────────────────────────────┘
                              │ 호출
┌─────────────────────────────▼───────────────────────────────────────┐
│ CAT-2: 부트스트랩          CAT-4: 품질/검증         CAT-6: 시스템   │
│ kdysetting ──→ kdyweb     kdyconvention ←── 개발 중  inception      │
│ kdygenesis ──→ [전체]     kdyconecttest              kdyupdate       │
│                           kdye2e                     kdysync        │
│                           kdyspike                    kdyselfreflection│
└──────┬──────────────────────┬───────────────────────────────────────┘
       │                      │
       ▼                      ▼
┌──────────────────────────────────────────────────────────────────────┐
│ CAT-3: 코드 라이브러리                CAT-5: 인텔리전스              │
│ kdypick ←→ kdyextract                 kdyintel → kdymarket           │
│ crawler-code-generator                kdyidea → kdygenesis           │
│ kdyimagemid, ui-ux-pro-max            kdyimageanti                   │
└──────────────────────────────────────────────────────────────────────┘
       │
       ▼
┌──────────────────────────────────────────────────────────────────────┐
│ CAT-1: 세션 생명주기                                                │
│ /cs (종료) ── kdyplanon (재개) ── kdyclean (정리)                    │
└──────────────────────────────────────────────────────────────────────┘

프로젝트 단계별 스킬 선택 가이드

1. 초기화

/kdysetting

CLAUDE.md, docs 구조, 개발 규칙을 한 번에 셋팅합니다.

2. 웹 구조 설정

/kdyweb --init

웹 프로젝트의 페이지 구조를 계약 기반으로 초기화합니다.

3. 코드 가져오기

/kdypick

02-reusable-code (TS) 또는 02-reusable-code-python에서 필요한 코드를 선택하여 적용합니다.

4. 사전 연구 (난이도 높은 기능)

/kdyspike

난이도를 판별하고, 마이크로/풀 스파이크 2트랙으로 기술 검증을 수행합니다.

5. 코드 추출

/kdyextract

프로젝트에서 범용 재사용 가능한 코드를 분석, 추출하여 패키징합니다.

6. 품질 검증

/kdyconvention    # 코드 컨벤션 검증
/kdyconecttest    # 웹 연결성 정적 검증
/kdye2e          # E2E 테스트

7. 정리 & 세션 종료

/kdyclean        # 파일 정리
/cs              # 세션 종료

8. 크롤러

상황	선택
URL을 이미 알고 있음	`/crawler-code-generator` (스킬)
URL을 모름, 탐색 필요	`web-crawler-builder` (에이전트)

E2E 테스트 모드

모드	명령
전체 흐름	`/kdye2e`
시나리오만	`/kdye2e --scenario`
실행만	`/kdye2e --run`
수정만	`/kdye2e --fix`
초기 세팅	`/kdye2e --setup`
스모크만	`/kdye2e --smoke`

스킬 ↔ 에이전트 관계

스킬은 /명령어로 직접 실행하는 단일 워크플로우이고, 에이전트는 Task 도구로 위임하는 멀티스텝 파이프라인입니다.

스킬	연관 에이전트	연동 방식
`/kdyextract`	`code-reviewer`	Phase 4-A에서 코드 품질 검증 기준 공유
`/kdyweb`	`doc-updater`	페이지 변경 후 문서 동기화
`/kdyclean`	`code-reviewer`	리뷰 후 불필요 파일 정리
`/crawler-code-generator`	`web-crawler-builder`	URL 유무에 따라 상호 전환
`/kdysetting`	`security-reviewer`	프로젝트 셋팅 후 보안 점검
`/kdysetting`	`tdd-guide`	프로젝트 셋팅 후 TDD 환경 구축
`/kdye2e`	`code-reviewer`	Phase 3 소스 수정 후 코드 품질 검토

상세 연쇄 맵

스킬/에이전트 간 전체 의존성과 프로젝트 생명주기는 아래 문서를 참조하세요:

→ docs/references/_COMPONENT_MAP.md

커뮤니티 참조

외부 레포, Hooks 패턴, 스킬 작성 가이드:

→ 00-community-reference/