Skills バージョン管理と反復
Skill は要件の変化に応じて進化し続けます。適切なバージョン管理を行うことで、変更時に既存の成果を失わず、エラーが発生した場合も迅速にロールバックできます。
バージョン番号の規約
Skills はセマンティックバージョニング(Semantic Versioning)を採用しており、形式は次のとおりです。MAJOR.MINOR.PATCH。
| バージョン番号のセグメント | いつインクリメントするか | 例 |
|---|---|---|
| MAJOR(メジャーバージョン) | 互換性のない大きな変更(入力形式の変更など) | 1.0.0 → 2.0.0 |
| MINOR(マイナーバージョン) | 新機能を追加するが、下位互換性を維持 | 1.0.0 → 1.1.0 |
| PATCH(パッチバージョン) | バグ修正で、機能に影響しない | 1.0.0 → 1.0.1 |
SKILL.md にバージョンを宣言する
例
---
name: csv-analyzer
version: 1.2.0
description: CSV ファイルを分析し、統計サマリーを出力します。
---
name: csv-analyzer
version: 1.2.0
description: CSV ファイルを分析し、統計サマリーを出力します。
---
Git を使用した Skill のバージョン管理
Git は Skill のバージョン管理に最適なツールであり、変更のたびに明確な履歴を形成できます。
例
# Git リポジトリを初期化
cd my-skill/
git init
git add .
git commit -m "feat: 初期バージョン v1.0.0"
# Skill を変更して新しいバージョンをコミット
git add SKILL.md
git commit -m "fix: ファイルパス処理のスペース問題を修正"
# 安定版にタグを付ける
git tag v1.0.1
git tag v1.1.0 -m "複数ファイルの一括処理機能を追加"
cd my-skill/
git init
git add .
git commit -m "feat: 初期バージョン v1.0.0"
# Skill を変更して新しいバージョンをコミット
git add SKILL.md
git commit -m "fix: ファイルパス処理のスペース問題を修正"
# 安定版にタグを付ける
git tag v1.0.1
git tag v1.1.0 -m "複数ファイルの一括処理機能を追加"
推奨されるコミットメッセージ形式
| プレフィックス | 意味 | 例 |
|---|---|---|
| feat: | 新機能 | feat: Excel 出力サポートを追加 |
| fix: | バグ修正 | fix: 空ファイル時のクラッシュ問題を修正 |
| docs: | ドキュメント更新 | docs: パラメータの説明を追加 |
| refactor: | コードリファクタリング(機能変更なし) | refactor: クリーニングロジックを独立した関数に抽出 |
| perf: | パフォーマンス最適化 | perf: 大容量ファイルの処理速度が 3 倍向上 |
SKILL.md で CHANGELOG を管理する
他の人が使用する Skill については、SKILL.md の末尾に変更履歴を添付すると、ユーザーが各バージョンの変更内容を把握しやすくなります。
## 版本历史 ### v1.2.0(2026-05-18) - 新增:支持 .xlsx 输入格式 - 优化:大文件(>10MB)处理速度提升 40% ### v1.1.0(2026-04-10) - 新增:--col 参数,支持只分析指定列 - 修复:列名包含空格时的解析错误 ### v1.0.0(2026-03-01) - 初始版本:支持 CSV 文件的基础统计分析
バージョン移行:互換性のない変更の対応方法
Skill に互換性のない変更(入力形式の変更や機能の削除など)が発生した場合は、既存ユーザーに明確な移行ガイドを提供する必要があります。
## 迁移指南:从 v1.x 升级到 v2.0 ### 主要变化 v2.0 修改了输出文件的命名规则,由原来的 `output.xlsx` 改为带日期的 `output_YYYYMMDD.xlsx`。 ### 受影响场景 如果你的工作流依赖固定的输出文件名,需要在使用时重命名文件,或使用 `--output` 参数指定文件名。 ### 迁移步骤 1. 更新 Skill 到 v2.0 2. 检查是否有依赖固定文件名的脚本或工作流 3. 如有,添加 `--output output.xlsx` 参数保持旧行为
互換性のない変更は、リリース前に影響範囲を十分に評価する必要があります。利用者が多い場合は、旧パラメータを残して「非推奨」とマークし、ユーザーに移行期間を与えることを検討すべきであり、直接削除するべきではありません。
過去バージョンへのロールバック
例
# すべての履歴コミットを表示
git log --oneline
# すべてのバージョンタグを表示
git tag
# 指定したバージョンタグへロールバック
git checkout v1.1.0
# または指定したコミットへロールバック(コミットハッシュを使用)
git checkout a3f7b2c
# ロールバックしたバージョンを新ブランチとして開発を続ける場合
git checkout -b hotfix/v1.1.1 v1.1.0
git log --oneline
# すべてのバージョンタグを表示
git tag
# 指定したバージョンタグへロールバック
git checkout v1.1.0
# または指定したコミットへロールバック(コミットハッシュを使用)
git checkout a3f7b2c
# ロールバックしたバージョンを新ブランチとして開発を続ける場合
git checkout -b hotfix/v1.1.1 v1.1.0