semantic-versioning
セマンティックバージョニング(semver)に基づく依存関係変更の影響予測と対応戦略を専門とするスキル。依存パッケージのバージョンアップ時の破壊的変更検出、影響分析、移行戦略立案を支援する。Anchors:• Semantic Versioning 2.0.0 Specification / 適用: バージョン番号の解釈 / 目的: 変更の性質を正確に判断• The Pragmatic Programmer / 適用: リスク軽減と段階的移行 / 目的: 安全なアップグレード• Keep a Changelog / 適用: 変更履歴の解析 / 目的: 破壊的変更の特定Trigger:Use when managing package dependency updates, analyzing version compatibility, detecting breaking changes, planning migration strategies, or assessing upgrade risks.semver, dependency, version, breaking change, migration, upgrade, compatibility, package update
When & Why to Use This Skill
This Claude skill specializes in predicting the impact of dependency changes based on Semantic Versioning (semver) 2.0.0. It empowers developers to detect breaking changes, analyze upgrade risks, and formulate comprehensive migration strategies, ensuring safe and predictable package updates within any software project.
Use Cases
- Automated Breaking Change Detection: Analyze package updates to identify potential breaking changes by comparing current versions against target versions and scanning CHANGELOGs.
- Dependency Risk Assessment: Evaluate the safety of upgrading specific libraries by interpreting semver ranges and assessing the nature of changes (major, minor, or patch).
- Migration Strategy Planning: Generate step-by-step plans for complex dependency upgrades, including necessary code adjustments and testing protocols to maintain system stability.
- Version Compatibility Auditing: Verify that proposed dependency updates align with existing project constraints and prevent 'dependency hell' through proactive impact analysis.
| name | semantic-versioning |
|---|---|
| description | | |
| • Semantic Versioning 2.0.0 Specification / 適用 | バージョン番号の解釈 / 目的: 変更の性質を正確に判断 |
| • The Pragmatic Programmer / 適用 | リスク軽減と段階的移行 / 目的: 安全なアップグレード |
| • Keep a Changelog / 適用 | 変更履歴の解析 / 目的: 破壊的変更の特定 |
Semantic Versioning
概要
セマンティックバージョニング(semver)に基づく依存関係変更の影響予測と対応戦略を専門とするスキル。バージョンアップ時の破壊的変更検出、影響分析、移行戦略立案をカバーする。
ワークフロー
analyze-impact → plan-migration → execute-upgrade → validate-results
Phase 1: 影響分析
目的: バージョン変更の影響範囲を特定する
Task: agents/analyze-impact.md を参照
アクション:
- 現在のバージョンと更新対象バージョンを確認
- CHANGELOGやリリースノートを分析
- 破壊的変更を特定
Phase 2: 移行計画
目的: 安全な移行戦略を策定する
Task: agents/plan-migration.md を参照
アクション:
- 破壊的変更への対応方法を決定
- 段階的移行計画を作成
- テスト戦略を策定
Phase 3: 実行と検証
目的: 移行を実行し、成功を検証する
アクション:
- 依存関係を更新
- テストスイートを実行
scripts/log_usage.mjsで記録
Task仕様ナビ
| Task | 責務 | 入力 | 出力 |
|---|---|---|---|
| analyze-impact | 影響分析 | バージョン情報 | 破壊的変更リスト |
| plan-migration | 移行計画 | 破壊的変更リスト | 移行計画書 |
詳細仕様: 各Taskの詳細は agents/ ディレクトリを参照
ベストプラクティス
すべきこと
| 推奨事項 | 理由 |
|---|---|
| CHANGELOGを必ず確認する | 破壊的変更の事前把握 |
| 段階的にアップグレードする | 問題の特定が容易 |
| テストカバレッジを確保する | 回帰の早期発見 |
| ロックファイルをコミットする | 再現可能なビルドの保証 |
| 0.x.xバージョンは慎重に扱う | 破壊的変更がいつでも起こりうる |
避けるべきこと
| 禁止事項 | 問題点 |
|---|---|
| メジャーバージョンを無確認で更新 | 破壊的変更による障害 |
| 複数依存を同時にアップグレード | 問題の特定が困難 |
| テストなしでのアップグレード | 回帰バグの見逃し |
| 自動マージを有効にする | 破壊的変更の見逃し |
リソース参照
references/(詳細知識)
| リソース | パス | 読込条件 |
|---|---|---|
| Semver仕様 | references/semver-specification.md | バージョン解釈時 |
| 破壊的変更検出 | references/breaking-change-detection.md | 影響分析時 |
| 移行戦略 | references/migration-strategies.md | 移行計画時 |
| バージョン範囲 | references/version-range-patterns.md | 範囲指定時 |
scripts/(決定論的処理)
| スクリプト | 機能 |
|---|---|
scripts/log_usage.mjs |
使用記録と自動評価 |
scripts/analyze-version-impact.mjs |
バージョン影響分析 |
assets/(テンプレート)
| アセット | 用途 |
|---|---|
assets/upgrade-assessment-template.md |
アップグレード評価テンプレート |
変更履歴
| Version | Date | Changes |
|---|---|---|
| 2.0.0 | 2026-01-02 | 18-skills仕様完全準拠、agents/を責務ベースに再構成 |
| 1.1.0 | 2025-12-31 | 18-skills.md仕様に基づきリファクタリング |
| 1.0.0 | 2025-12-24 | 初版 |