api-api-versioning
Planning API変更とバージョニングアプローチの決定 このスキルでは、APIの今後の変更を計画し、適切なバージョニング戦略を策定できます。既存のAPIエンドポイントの変更が必要な場合、後方互換性の維持やバージョン管理の方針を事前に検討します。新機能の追加やエンドポイントの廃止、仕様変更などを予定する際に、顧客への影響を最小限に抑えるバージョニング手法（セマンティックバージョニング、URL ベースのバージョニングなど）を選択・実装できます。これにより、API利用者の混乱を防ぎながら、スムーズなシステム移行を実現します。
description の原文を見る
Planning API changes and deciding on versioning approach
SKILL.md 本文
APIバージョニング
スコープ: APIバージョニング戦略、破壊的変更、廃止ワークフロー、マイグレーションパターン 行数: ~200 最終更新: 2025-10-18
このスキルを使用する場面
以下の場合にこのスキルを活用します:
- APIの変更を計画しバージョニング方針を決定する
- 本番環境で複数のAPIバージョンを管理する
- 古いAPIバージョンを廃止する
- クライアントを新しいAPIバージョンにマイグレーションする
- 後方互換性戦略を設計する
- 破壊的変更を安全に実装する
- レガシーAPIのサンセット(廃止)ポリシーを確立する
コアコンセプト
APIバージョニングとは
課題: APIは時間とともに進化します。変更は既存クライアントを壊す可能性があります。
ソリューション: 複数のAPIバージョンを同時に保守し、クライアントの段階的なマイグレーションを可能にします。
利点:
- 既存クライアントの後方互換性
- 破壊的変更の安全なデプロイメント
- クライアントの段階的なマイグレーション
- APIとクライアント間の明確なコントラクト
コスト:
- メンテナンス負担(複数のコードベース)
- テストの複雑性
- ドキュメント化のオーバーヘッド
バージ
...
詳細情報
- 作者
- tools-only
- リポジトリ
- tools-only/X-Skills
- ライセンス
- unknown
- 最終更新
- 2026/5/12
Source: https://github.com/tools-only/X-Skills / ライセンス: unknown
関連スキル
doubt-driven-development
重要な判断はすべて、本番環境への展開前に新しい視点から対抗的レビューを実施します。速度より正確性が重要な場合、不慣れなコードを扱う場合、本番環境・セキュリティに関わるロジック・取り消し不可の操作など影響度が高い場合、または後でバグを修正するよりも今検証する方が効率的な場合に活用してください。
apprun-skills
TypeScriptを使用したAppRunアプリケーションのMVU設計に関する総合的なガイダンスが得られます。コンポーネントパターン、イベントハンドリング、状態管理（非同期ジェネレータを含む）、パラメータと保護機能を備えたルーティング・ナビゲーション、vistestを使用したテストに対応しています。AppRunコンポーネントの設計・レビュー、ルートの配線、状態フローの管理、AppRunテストの作成時に活用してください。
desloppify
コードベースのヘルスチェックと技術負債の追跡ツールです。コード品質、技術負債、デッドコード、大規模ファイル、ゴッドクラス、重複関数、コードスメル、命名規則の問題、インポートサイクル、結合度の問題についてユーザーが質問した場合に使用してください。また、ヘルススコアの確認、次の改善項目の提案、クリーンアップ計画の作成をリクエストされた際にも対応します。29言語に対応しています。
debugging-and-error-recovery
テストが失敗したり、ビルドが壊れたり、動作が期待と異なったり、予期しないエラーが発生したりした場合に、体系的な根本原因デバッグをガイドします。推測ではなく、根本原因を見つけて修正するための体系的なアプローチが必要な場合に使用してください。
test-driven-development
テスト駆動開発により実装を進めます。ロジックの実装、バグの修正、動作の変更など、あらゆる場面で活用できます。コードが正常に動作することを証明する必要がある場合、バグ報告を受けた場合、既存機能を修正する予定がある場合に使用してください。
incremental-implementation
変更を段階的に実施します。複数のファイルに影響する機能や変更を実装する場合に使用してください。大量のコードを一度に書こうとしている場合や、タスクが一度では完結できないほど大きい場合に活用します。