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