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

⭐3stars🔀0forks📁View on GitHub🕐Updated Jan 10, 2026

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.
namesemantic-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 を参照

アクション:

  1. 現在のバージョンと更新対象バージョンを確認
  2. CHANGELOGやリリースノートを分析
  3. 破壊的変更を特定

Phase 2: 移行計画

目的: 安全な移行戦略を策定する

Task: agents/plan-migration.md を参照

アクション:

  1. 破壊的変更への対応方法を決定
  2. 段階的移行計画を作成
  3. テスト戦略を策定

Phase 3: 実行と検証

目的: 移行を実行し、成功を検証する

アクション:

  1. 依存関係を更新
  2. テストスイートを実行
  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 初版