versioning-guide
starsforks
How to install versioning-guide?
cathy-kim/skill-semver/versioning-guide
$npx -y skills add cathy-kim/skill-semver --skill versioning-guide> 스킬 버전 관리를 위한 가이드 및 자동화 지원
SKILL.md
| 1 | # Skill Versioning Guide |
| 2 | |
| 3 | > 스킬 버전 관리를 위한 가이드 및 자동화 지원 |
| 4 | |
| 5 | **Version**: 1.0.0 |
| 6 | **Last Updated**: 2026-01-30 |
| 7 | |
| 8 | --- |
| 9 | |
| 10 | ## Purpose |
| 11 | |
| 12 | 이 스킬은 Claude Code Skills의 버전 관리 방법을 안내하고 자동화를 지원합니다. |
| 13 | |
| 14 | --- |
| 15 | |
| 16 | ## 버전 관리 원칙 |
| 17 | |
| 18 | ### Semantic Versioning |
| 19 | |
| 20 | ``` |
| 21 | MAJOR.MINOR.PATCH |
| 22 | |
| 23 | 예: 3.1.0 |
| 24 | - MAJOR: 호환성 깨지는 대규모 변경 (Breaking Changes) |
| 25 | - MINOR: 새로운 기능 추가 (Features) |
| 26 | - PATCH: 버그 수정, 문서 개선 (Fixes) |
| 27 | ``` |
| 28 | |
| 29 | ### 버전 증가 기준 |
| 30 | |
| 31 | | 변경 유형 | 버전 증가 | 예시 | |
| 32 | |----------|----------|------| |
| 33 | | 핵심 로직 변경 | MAJOR | Workflow 구조 변경 | |
| 34 | | Phase 추가/제거 | MAJOR | Phase 4.5 추가 | |
| 35 | | 새 기능 추가 | MINOR | Context Injection 도입 | |
| 36 | | Agent/Hook 추가 | MINOR | 새 Agent 정의 추가 | |
| 37 | | 버그 수정 | PATCH | 오타 수정, 설명 보완 | |
| 38 | | 문서 개선 | PATCH | 예시 추가, 가독성 개선 | |
| 39 | |
| 40 | --- |
| 41 | |
| 42 | ## Skill 폴더 구조 |
| 43 | |
| 44 | 각 Skill은 다음 구조를 따릅니다: |
| 45 | |
| 46 | ``` |
| 47 | .claude/skills/[skill-name]/ |
| 48 | ├── SKILL.md # 현재 버전 (최신) |
| 49 | ├── CHANGELOG.md # 변경 히스토리 |
| 50 | ├── releases/ # 버전별 스냅샷 |
| 51 | │ ├── v1.0.0_2025-12-01_SKILL.md |
| 52 | │ ├── v2.0.0_2025-12-15_SKILL.md |
| 53 | │ └── v3.1.0_2026-01-21_SKILL.md |
| 54 | ├── references/ # 참조 문서 (선택) |
| 55 | ├── agents/ # Agent 정의 (선택) |
| 56 | └── templates/ # 템플릿 (선택) |
| 57 | ``` |
| 58 | |
| 59 | --- |
| 60 | |
| 61 | ## SKILL.md 버전 헤더 형식 |
| 62 | |
| 63 | SKILL.md 상단에 다음 형식 필수: |
| 64 | |
| 65 | ```markdown |
| 66 | # [Skill Name] |
| 67 | |
| 68 | > [Skill 설명] |
| 69 | |
| 70 | **Version**: 3.2.0 |
| 71 | **Last Updated**: 2026-01-22 |
| 72 | ``` |
| 73 | |
| 74 | --- |
| 75 | |
| 76 | ## CHANGELOG.md 형식 |
| 77 | |
| 78 | ```markdown |
| 79 | # Changelog - [Skill Name] |
| 80 | |
| 81 | All notable changes to this skill will be documented in this file. |
| 82 | |
| 83 | ## [3.1.0] - 2026-01-21 |
| 84 | |
| 85 | ### Added |
| 86 | - Context Injection System 추가 |
| 87 | |
| 88 | ### Changed |
| 89 | - Quality Score 배점 조정 |
| 90 | |
| 91 | ### Fixed |
| 92 | - Goal Retention 문제 해결 |
| 93 | ``` |
| 94 | |
| 95 | ### 변경 유형 분류 |
| 96 | |
| 97 | - **Added**: 새로운 기능 추가 |
| 98 | - **Changed**: 기존 기능 변경 |
| 99 | - **Deprecated**: 곧 제거될 기능 |
| 100 | - **Removed**: 제거된 기능 |
| 101 | - **Fixed**: 버그 수정 |
| 102 | - **Security**: 보안 관련 변경 |
| 103 | |
| 104 | --- |
| 105 | |
| 106 | ## 자동화 (PostToolUse Hook) |
| 107 | |
| 108 | 이 플러그인은 SKILL.md 파일 수정 시 자동으로 백업을 생성합니다: |
| 109 | |
| 110 | 1. Write/Edit 도구로 SKILL.md 수정 감지 |
| 111 | 2. 버전 헤더에서 버전 번호 추출 |
| 112 | 3. `releases/v{VERSION}_{DATE}_SKILL.md` 백업 생성 |
| 113 | 4. 동일 버전 백업이 있으면 스킵 |
| 114 | |
| 115 | --- |
| 116 | |
| 117 | ## 수동 버전 릴리스 절차 |
| 118 | |
| 119 | ```bash |
| 120 | # 1. SKILL.md 상단 버전 업데이트 |
| 121 | # **Version**: 3.2.0 |
| 122 | |
| 123 | # 2. CHANGELOG.md에 변경 사항 기록 |
| 124 | ## [3.2.0] - 2026-01-22 |
| 125 | ### Added |
| 126 | - 새 기능 설명 |
| 127 | |
| 128 | # 3. Git 커밋 |
| 129 | git add SKILL.md CHANGELOG.md releases/ |
| 130 | git commit -m "feat([skill-name]): Release v3.2.0 - 새 기능 설명" |
| 131 | ``` |
| 132 | |
| 133 | --- |
| 134 | |
| 135 | ## 마이그레이션 |
| 136 | |
| 137 | 기존 Skills에 버전 관리를 적용하려면: |
| 138 | |
| 139 | ```bash |
| 140 | npx tsx scripts/migrate-skill-versioning.ts |
| 141 | ``` |
| 142 | |
| 143 | 이 스크립트는: |
| 144 | - releases/ 폴더 생성 |
| 145 | - SKILL.md에 버전 헤더 추가 |
| 146 | - Git 히스토리 기반 CHANGELOG.md 생성 |
| 147 | - 기존 백업 파일 마이그레이션 |
People who liked this also viewed
6 picksType
- find-skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skSkillsJul 2026
- grill-meA relentless interview to sharpen a plan or design.SkillsJul 2026
- vercel-react-best-practicesVercel's official collection of agent skillsSkillsJul 2026
- improve-codebase-architectureScan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.SkillsJul 2026
- setup-matt-pocock-skillsConfigure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.SkillsJul 2026
- triageMove issues and external PRs through a state machine of triage roles — categorise, verify, grill if needed, and write agent-ready briefs.SkillsJul 2026
