mcpField
S
symfony:api-platform-dto-resources

symfony:api-platform-dto-resources

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

symfony:api-platform-dto-resources について

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-dto-resources

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

同梱ファイルreference.md

詳細

API Platform DTO リソース（Symfony）

使用する場面

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

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

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

ガードレール

  • API コントラクトを明示し、バージョンを意識したものにします。
  • 内部エンティティのフィールドを暗黙的に公開しないようにします。
  • ドキュメントと実際のシリアライズの不整合を防ぎます。

段階的な情報開示

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

出力コントラクト

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

リファレンス

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

コメント

Markdown 対応