스킬 마스터: 코드베이스 패턴 발견 및 SKILL 파일 생성

--- name: skill-master description: 코드베이스 패턴을 발견하고 .claude/skills/용 SKILL 파일을 자동 생성합니다. 프로젝트에서 누락된 스킬 분석, 코드베이스 패턴 기반 새 스킬 생성, 또는 프로젝트 구조와 스킬 동기화 시 사용하세요. version: 1.0.0 --- # Skill Master ## 개요 코드베이스를 분석하여 패턴을 발견하고 .claude/skills/ 디렉토리에 SKILL 파일을 생성/업데이트합니다. 스택별 패턴 감지 기능으로 다중 플랫폼 프로젝트를 지원합니다. **기능:** - 아키텍처 패턴(ViewModel, Repository, Room 등)을 위한 코드베이스 스캔 - 감지된 패턴과 기존 스킬 비교 - 실제 코드 예제가 포함된 SKILL 파일 자동 생성 - 버전 추적 및 스마트 업데이트 ## AI가 이 스킬을 발견하고 사용하는 방법 이 스킬은 사용자가 다음과 같은 요청을 할 때 트리거됩니다: - 프로젝트에서 누락된 스킬 분석 요청 - 코드베이스 패턴에서 스킬 생성 요청 - 기존 스킬 동기화 또는 업데이트 요청 - "스킬 발견", "스킬 생성", 또는 "스킬 동기화" 언급 **감지 신호:** - .claude/skills/ 디렉토리 존재 - 알려진 패턴과 일치하는 프로젝트 구조 - 플랫폼을 나타내는 빌드/설정 파일(참조 자료 확인) ## 모드 ### 발견 모드 코드베이스를 분석하고 누락된 스킬을 보고합니다. **단계:** 1. 빌드/설정 파일을 통해 플랫폼 감지(참조 자료 확인) 2. 소스 루트에서 패턴 표시자 스캔 3. 감지된 패턴을 기존 .claude/skills/와 비교 4. 차이 분석 보고서 출력 **출력 형식:** ``` 감지된 패턴: {개수} | 패턴 | 파일 수 | 예제 위치 | |---------|-------------|------------------| | {이름} | {개수} | {경로} | 기존 스킬: {개수} 누락된 스킬: {개수} - {스킬 이름}: {패턴}, {파일 개수}개 파일 발견 ``` ### 생성 모드 감지된 패턴에서 SKILL 파일을 생성합니다. **단계:** 1. 발견을 실행하여 누락된 스킬 식별 2. 각 누락된 스킬에 대해: - 대표 소스 파일 2-3개 찾기 - 추출: import, 어노테이션, 클래스 구조, 규칙 - .ruler/*.md 파일이 있으면 규칙 추출 3. 템플릿 구조를 사용하여 SKILL.md 생성 4. 버전 및 소스 마커 추가 **생성된 SKILL 구조:** ```yaml --- name: {패턴 이름} description: {트리거 키워드가 포함된 생성된 설명} version: 1.0.0 --- # {제목} ## 개요 {패턴 분석에서 얻은 간략한 설명} ## 파일 구조 {코드베이스에서 추출} ## 구현 패턴 {실제 코드 예제 - 익명화됨} ## 규칙 ### Do {.ruler/*.md 및 코드베이스 규칙에서} ### Don't {발견된 안티 패턴} ## 파일 위치 {코드베이스의 실제 경로} ``` ## 생성 전략 대상 SKILL 파일이 존재하지 않는 경우: 1. 템플릿을 사용하여 새 파일 생성 2. frontmatter에 version: 1.0.0 설정 3. 모든 필수 섹션 포함 4. 파일 끝에 소스 마커 추가(마커 형식 참조) ## 업데이트 전략 **마커 확인:** 파일 끝에서 `<!-- Generated by skill-master command` 찾기. **마커가 있는 경우(후속 실행):** - 스마트 병합: 사용자 정의 콘텐츠 보존, 누락된 섹션 추가 - 버전 증가: major(주요 변경) / minor(기능) / patch(수정) - 마커의 소스 목록 업데이트 **마커가 없는 경우(기존 파일 첫 실행):** - 백업: SKILL.md → SKILL.md.bak - 백업을 소스로 사용, 관련 콘텐츠 추출 - 마커가 있는 새 파일 생성 - version: 1.0.0 설정 ## 마커 형식 생성된 SKILL.md 끝에 배치: ```html <!-- Generated by skill-master command Version: {버전} Sources: - path/to/source1.kt - path/to/source2.md - .ruler/rule-file.md Last updated: {YYYY-MM-DD} --> ``` ## 플랫폼 참조 자료 플랫폼 감지 시 관련 참조 자료 읽기: | 플랫폼 | 감지 파일 | 참조 자료 | |----------|-----------------|-----------| | Android/Gradle | build.gradle, settings.gradle | references/android.md | | iOS/Xcode | *.xcodeproj, Package.swift | references/ios.md | | React (웹) | package.json + react | references/react-web.md | | React Native | package.json + react-native | references/react-native.md | | Flutter/Dart | pubspec.yaml | references/flutter.md | | Node.js | package.json | references/node.md | | Python | pyproject.toml, requirements.txt | references/python.md | | Java/JVM | pom.xml, build.gradle | references/java.md | | .NET/C# | *.csproj, *.sln | references/dotnet.md | | Go | go.mod | references/go.md | | Rust | Cargo.toml | references/rust.md | | PHP | composer.json | references/php.md | | Ruby | Gemfile | references/ruby.md | | Elixir | mix.exs | references/elixir.md | | C/C++ | CMakeLists.txt, Makefile | references/cpp.md | | 알 수 없음 | - | references/generic.md | 여러 플랫폼이 감지되면 여러 참조 자료를 읽습니다. ## 규칙 ### Do - 코드베이스에서 검증된 패턴만 추출 - 실제 코드 예제 사용(비즈니스 로직 익명화) - 설명에 트리거 키워드 포함 - SKILL.md를 500줄 미만으로 유지 - 상세 콘텐츠는 외부 파일 참조 - 업데이트 중 사용자 정의 섹션 보존 - 첫 수정 전에 항상 백업 ### Don't - 시크릿, 토큰 또는 자격 증명 포함 - 비즈니스별 로직 세부 정보 포함 - 실제 콘텐츠 없는 플레이스홀더 생성 - 백업 없이 사용자 정의 덮어쓰기 - 깊은 참조 체인 생성(최대 1레벨) - .claude/skills/ 외부에 쓰기 ## 콘텐츠 추출 규칙 **코드베이스에서:** - 추출: 클래스 구조, 어노테이션, import 패턴, 파일 위치, 명명 규칙 - 절대 금지: 하드코딩된 값, 시크릿, API 키, PII ** .ruler/*.md에서(있는 경우):** - 추출: Do/Don't 규칙, 아키텍처 제약, 의존성 규칙 ## 출력 보고서 생성 후 출력: ``` SKILL 생성 보고서 생성된 스킬: {개수} {스킬 이름} [생성됨 | 업데이트됨 | 백업+생성됨] ├── 분석됨: {파일 개수}개 소스 파일 ├── 소스: {소스 파일 목록} ├── 규칙 출처: {.ruler 파일이 있는 경우} └── 출력: .claude/skills/{스킬 이름}/SKILL.md ({줄 수}줄) 검증: ✓ YAML frontmatter 유효 ✓ 설명에 트리거 키워드 포함 ✓ 콘텐츠 500줄 미만 ✓ 필수 섹션 포함 ``` ## 안전 제약 - .claude/skills/ 외부에 절대 쓰지 않기 - 백업 없이 콘텐츠를 절대 삭제하지 않기 - 첫 수정 전에 항상 백업 - 사용자 정의 보존 - 결정적: 동일 입력 → 동일 출력