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