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