mcpField
S
symfony:api-platform-resources

symfony:api-platform-resources

github.com/dev-toolings開発227511 回インストール4 週間前に更新
リポジトリ

symfony:api-platform-resources について

Symfony の API Platform リソースと操作の設計・拡張を支援するスキルです。リソース、DTO、プロバイダー、プロセッサーの明示的なマッピングを促し、契約・検証・セキュリティの整合を保ちます。

主な機能

  1. 01操作単位の契約定義
  2. 02リソース、DTO、プロバイダー、プロセッサーのマッピング
  3. 03検証とセキュリティ制約の適用
  4. 04成功・失敗経路のテスト
  5. 05ドキュメントとシリアライズの照合

活用シーン

  1. 01API Platform 操作の拡張
  2. 02シリアライズと検証動作の調整
  3. 03API セキュリティ動作の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/dev-toolings/superpowers-symfony --skill symfony:api-platform-resources

インストール後、Claude Code で/symfony:api-platform-resourcesを入力して読み込まれたか確認します。

同梱ファイルreference.md

詳細

Api Platform リソース（Symfony）

使用する場面

  • API Platform のコントラクトやオペレーションを設計または進化させる場合。
  • シリアライゼーション、バリデーション、セキュリティの動作を整合させる場合。

デフォルトのワークフロー

  1. オペレーションレベルのコントラクトとペイロードの境界を定義します。
  2. 明示的なマッピングを使用して、リソース／DTO／プロバイダー／プロセッサーの変更を実装します。
  3. オペレーション固有のバリデーション制約とセキュリティ制約を適用します。
  4. 正常系と異常系の両方で、機能の動作を検証します。

ガードレール

  • API コントラクトを明示し、バージョンを考慮します。
  • 内部エンティティのフィールドが暗黙的に公開されないようにします。
  • ドキュメントと実際のシリアライゼーションに食い違いが生じないようにします。

段階的な情報開示

  • このファイルは、実行方針とリスク管理に使用します。
  • 実装の詳細が必要な場合は、リファレンスを開きます。

出力要件

  • 変更した API アーティファクト（リソース／DTO／プロバイダー／プロセッサー）。
  • コントラクトとセキュリティに関する判断、およびその根拠。
  • 機能検証の結果。

リファレンス

  • reference.md
  • docs/complexity-tiers.md

コメント

Markdown 対応