symfony:api-platform-versioning について
API Platform のコントラクト設計や変更を支援する Symfony 向けスキルです。リソース、DTO、プロバイダー、プロセッサーを明示的に対応付け、操作ごとの検証とセキュリティを確認します。
主な機能
- 01操作単位のコントラクトとペイロード境界の定義
- 02リソース、DTO、プロバイダー、プロセッサーの変更対応
- 03操作ごとの検証とセキュリティ制約の設定
- 04正常系と異常系の機能検証
活用シーン
- 01API Platform コントラクトの設計や変更
- 02シリアライズ、検証、セキュリティの整合
- 03API ドキュメントと実際のシリアライズの照合
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/symfony:api-platform-versioningを入力して読み込まれたか確認します。
同梱ファイルreference.md
詳細
Api Platform のバージョニング（Symfony）
使用する場面
- API Platform のコントラクトやオペレーションを設計、または進化させる場合。
- シリアライゼーション、バリデーション、セキュリティの動作を整合させる場合。
デフォルトのワークフロー
- オペレーションレベルのコントラクトとペイロードの境界を定義します。
- 明示的なマッピングを用いて、リソース／DTO／プロバイダー／プロセッサーの変更を実装します。
- オペレーション固有のバリデーション制約とセキュリティ制約を適用します。
- 正常系と異常系の両方で、機能の動作を検証します。
ガードレール
- API コントラクトを明示的かつバージョンを考慮したものにします。
- 内部エンティティのフィールドを暗黙的に公開しないようにします。
- ドキュメントと実際のシリアライゼーションにずれが生じないようにします。
段階的な情報開示
- 実行方針とリスク管理には、このファイルを使用します。
- 実装の詳細が必要な場合は、リファレンスを開きます。
出力コントラクト
- 変更した API アーティファクト（リソース／DTO／プロバイダー／プロセッサー）。
- コントラクトとセキュリティに関する判断およびその根拠。
- 機能検証の結果。
リファレンス
reference.mddocs/complexity-tiers.md
コメント
Markdown 対応