mcpField
4
403-frameworks-quarkus-validation

403-frameworks-quarkus-validation

github.com/jabrena开发456279 次安装1 天前更新
代码仓库

关于 403-frameworks-quarkus-validation

用于在 REST 边界应用和审查 Quarkus 验证实践的 Skill,涵盖代码检查与改进,并要求修改前编译、完成后全面验证。

主要功能

  1. 01DTO 与命令模型约束
  2. 02Jakarta REST 边界验证
  3. 03验证组与自定义约束
  4. 04面向客户端的错误映射
  5. 05修改前编译及修改后验证

适用场景

  1. 01为 Quarkus REST API 添加请求验证
  2. 02创建自定义约束或验证配置
  3. 03审查端点验证与错误映射

安装

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

$npx skills add https://github.com/jabrena/plinth --skill 403-frameworks-quarkus-validation

安装后在 Claude Code 中输入/403-frameworks-quarkus-validation确认已加载。

附带文件references/403-frameworks-quarkus-validation.md

详细介绍

Quarkus 验证指南

在 REST 边界应用 Quarkus 验证最佳实践。

此技能涵盖哪些内容?

  • DTO 和命令模型上的 Bean Validation 注解
  • Jakarta REST 资源中的 @Valid 和边界验证
  • 验证组和自定义约束
  • 将验证错误映射为对客户端安全的响应
  • 在各个端点一致地处理无效输入

范围: 根据参考规则和正反示例应用建议。

约束

应用验证更改前,请确保项目可以编译。改进后,请运行完整验证。

  • MANDATORY:在应用任何更改前,运行 ./mvnw compile 或 mvn compile
  • SAFETY:如果编译失败,请立即停止
  • VERIFY:应用改进后,运行 ./mvnw clean verify 或 mvn clean verify
  • BEFORE APPLYING:阅读参考资料,了解详细规则和示例

何时使用此技能

  • 在 Quarkus 中添加验证支持
  • 检查 Quarkus 验证规则
  • 改进 Quarkus REST API 中的请求验证
  • 在 Quarkus 中添加自定义验证约束
  • 验证 Quarkus @ConfigMapping 属性
  • 使用 ExceptionMapper 改进 Quarkus 中的验证错误映射

工作流

  1. 阅读参考资料并评估项目上下文

阅读 references/403-frameworks-quarkus-validation.md,并检查当前项目设置,然后再提出更改建议。

  1. 明确范围并决定目标改进

确定所需结果、约束,以及要应用的最小安全更改集。

  1. 应用符合框架规范的更改

遵循参考模式和项目约定,实现或重构与验证相关的配置和代码。

  1. 运行验证并报告结果

执行适当的构建和测试,并总结更改内容、验证结果以及任何后续操作。

参考资料

详细指导、示例和约束请参阅 references/403-frameworks-quarkus-validation.md。

评论

支持 Markdown