mcpField
S
symfony:api-platform-state-providers

symfony:api-platform-state-providers

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

关于 symfony:api-platform-state-providers

面向 Symfony 开发的技能,用于设计和演进 API Platform 操作与契约。它指导资源、DTO、provider 和 processor 的变更,并协调序列化、验证、安全性与文档。

主要功能

  1. 01定义操作契约
  2. 02映射资源与 DTO
  3. 03设置验证和安全规则
  4. 04检查正常与异常路径
  5. 05协调序列化与文档

适用场景

  1. 01设计 API Platform 操作
  2. 02变更 API 载荷契约
  3. 03验证 API 安全性与规则

安装

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

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

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

附带文件reference.md

详细介绍

API Platform 状态提供器(Symfony)

适用场景

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

默认工作流

  1. 定义操作级契约和载荷边界。
  2. 实施资源/DTO/提供器/处理器更改,并明确映射关系。
  3. 应用特定于操作的验证和安全约束。
  4. 验证正向和负向路径的功能行为。

防护措施

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

渐进式披露

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

输出约定

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

参考资料

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

评论

支持 Markdown