mcpField
5
512-frameworks-micronaut-data

512-frameworks-micronaut-data

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

关于 512-frameworks-micronaut-data

用于将 Micronaut Data 模式应用于关系型持久化和 SQL 的编码技能,指导仓储、实体、事务、分页、投影、锁定及集成测试,并要求修改前编译。

主要功能

  1. 01实体与列映射
  2. 02仓储查询和命名参数
  3. 03事务、分页与投影
  4. 04乐观锁定与集成测试
  5. 05修改前编译并进行完整验证

适用场景

  1. 01审查 Micronaut Data 实体和仓储
  2. 02添加事务、分页或投影
  3. 03改进乐观锁定或持久化测试

安装

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

$npx skills add https://github.com/jabrena/plinth --skill 512-frameworks-micronaut-data

安装后在 Claude Code 中输入/512-frameworks-micronaut-data确认已加载。

附带文件references/512-frameworks-micronaut-data.md

详细介绍

Micronaut Data 指南

为关系型仓储和安全 SQL 应用 Micronaut Data 模式。

此技能涵盖哪些内容?

  • 使用 @MappedEntity、@Id、@GeneratedValue、@MappedProperty 映射列
  • 扩展 CrudRepository / PageableRepository 的 @Repository 接口
  • 派生查询方法和使用命名参数的 @Query
  • 在 @Singleton 服务上使用 @Transactional(适当时设为 readOnly)
  • 为列表端点使用 Page 和 Pageable
  • 面向读取密集型查询的 DTO / 接口投影
  • 使用 @Version 实现乐观锁
  • 集成测试:@MicronautTest + TestPropertyProvider + Testcontainers

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

约束

更改持久化相关内容前先编译;之后验证完整构建。

  • 强制要求:应用任何更改前,运行 ./mvnw compile 或 mvn compile
  • 安全要求:如果编译失败,立即停止
  • 验证要求:应用改进后,运行 ./mvnw clean verify 或 mvn clean verify
  • 应用前:阅读参考资料,了解详细规则和示例
  • 边缘情况:如果用户目标含糊不清,在编辑文件或运行项目范围的命令前停止并提出澄清问题
  • 边缘情况:如果缺少必要的上下文、文件、凭据或工具,明确说明阻碍,并询问用户是要继续设置还是采用备用指导
  • 边缘情况:如果请求的更改与项目约束或安全边界冲突,解释冲突,并询问用户希望采用哪种权衡方案

何时使用此技能

  • 审查或实现 Micronaut Data 仓储和实体
  • 在 Micronaut 持久化层添加事务、分页或投影
  • 建模 Micronaut Data 实体和仓储
  • 审查 Micronaut Data 事务和分页查询
  • 改进 Micronaut Data 投影或乐观锁

工作流

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

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

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

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

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

遵循参考模式和项目约定,实施或重构配置 / 代码。

  1. 运行验证并报告结果

执行适当的构建 / 测试,并总结更改内容、验证情况和后续操作。

参考资料

详细指南、示例和约束请参阅 references/512-frameworks-micronaut-data.md。

评论

支持 Markdown