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. 01设计或演进 API 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 Filters（Symfony）

适用场景

  • 设计或演进 API Platform 契约和操作。
  • 统一序列化、验证和安全行为。

默认工作流

  1. 定义操作级契约和载荷边界。
  2. 实现资源/DTO/提供程序/处理器变更，并明确映射关系。
  3. 应用特定于操作的验证和安全约束。
  4. 在正常和异常路径中验证功能行为。

防护措施

  • 明确 API 契约，并考虑版本差异。
  • 避免隐式暴露内部实体字段。
  • 防止文档与实际序列化结果不一致。

渐进式披露

  • 使用此文件了解执行原则和风险控制。
  • 需要深入了解实现细节时，打开参考资料。

输出约定

  • 已更改的 API 产物（资源/DTO/提供程序/处理器）。
  • 契约和安全决策及其理由。
  • 功能验证结果。

参考资料

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

评论

支持 Markdown