mcpField
S
symfony:api-platform-filters

symfony:api-platform-filters

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

symfony:api-platform-filters について

Symfony 向けに API Platform の契約や操作の設計・変更を支援するスキルです。リソースと DTO の明示的なマッピング、操作ごとの検証とセキュリティ設定、動作確認を案内します。

主な機能

  1. 01操作契約とペイロード境界の定義
  2. 02リソース、DTO、プロバイダー、プロセッサーの明示的なマッピング
  3. 03操作ごとの検証とセキュリティ設定
  4. 04正常系と異常系の確認

活用シーン

  1. 01API Platform の操作の設計・変更
  2. 02シリアライゼーションと API ドキュメントの整合

インストール

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

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

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

同梱ファイルreference.md

詳細

Api Platform フィルター（Symfony）

使用する場面

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

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

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

ガードレール

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

段階的な情報開示

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

出力契約

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

参照資料

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

コメント

Markdown 対応