mcpField
S
symfony:api-platform-serialization

symfony:api-platform-serialization

github.com/dev-toolings开发227491 次安装4 周前更新
代码仓库

关于 symfony:api-platform-serialization

面向 Symfony 开发者的技能，用于设计或演进 API Platform 契约与操作。它指导显式映射资源和载荷、设置操作级验证与安全约束，并检查实现是否符合文档。

主要功能

  1. 01定义操作级 API 契约
  2. 02映射资源、DTO、provider 和 processor
  3. 03设置验证与安全约束
  4. 04检查成功与失败路径

适用场景

  1. 01设计 API Platform 操作
  2. 02协调序列化与验证规则
  3. 03避免 API 文档与实现不一致

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/symfony:api-platform-serialization确认已加载。

附带文件reference.md

详细介绍

Api Platform 序列化（Symfony）

适用场景

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

默认工作流

  1. 定义操作级契约和载荷边界。
  2. 通过显式映射实现资源/DTO/provider/processor 的变更。
  3. 应用特定于操作的验证和安全约束。
  4. 在正常和异常路径中验证功能行为。

防护措施

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

渐进式披露

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

输出约定

  • 已更改的 API 产物（resource/DTO/provider/processor）。
  • 契约和安全决策及其理由。
  • 功能验证结果。

参考资料

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

评论

支持 Markdown