mcpField
S
symfony:api-platform-versioning

symfony:api-platform-versioning

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

关于 symfony:api-platform-versioning

面向 Symfony 项目中 API Platform 合约设计与演进的技能，覆盖资源、DTO、提供器和处理器的明确映射。它还指导操作级验证与安全设置，并核对文档和序列化行为。

主要功能

  1. 01定义操作级合约与载荷边界
  2. 02映射资源、DTO、提供器和处理器变更
  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-versioning

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

附带文件reference.md

详细介绍

Api Platform 版本管理（Symfony）

适用场景

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

默认工作流

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

防护措施

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

渐进式披露

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

输出约定

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

参考资料

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

评论

支持 Markdown