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