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