关于 symfony:api-platform-state-providers
面向 Symfony 开发的技能,用于设计和演进 API Platform 操作与契约。它指导资源、DTO、provider 和 processor 的变更,并协调序列化、验证、安全性与文档。
主要功能
- 01定义操作契约
- 02映射资源与 DTO
- 03设置验证和安全规则
- 04检查正常与异常路径
- 05协调序列化与文档
适用场景
- 01设计 API Platform 操作
- 02变更 API 载荷契约
- 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 契约和操作。
- 协调序列化、验证和安全行为。
默认工作流
- 定义操作级契约和载荷边界。
- 实施资源/DTO/提供器/处理器更改,并明确映射关系。
- 应用特定于操作的验证和安全约束。
- 验证正向和负向路径的功能行为。
防护措施
- 保持 API 契约明确,并考虑版本差异。
- 避免隐式暴露内部实体字段。
- 防止文档与实际序列化行为不一致。
渐进式披露
- 使用此文件了解执行方式和风险控制。
- 需要深入了解实现细节时,打开参考资料。
输出约定
- 已更改的 API 产物(资源/DTO/提供器/处理器)。
- 契约和安全决策及其理由。
- 功能验证结果。
参考资料
reference.mddocs/complexity-tiers.md
评论
支持 Markdown