关于 512-frameworks-micronaut-data
用于将 Micronaut Data 模式应用于关系型持久化和 SQL 的编码技能,指导仓储、实体、事务、分页、投影、锁定及集成测试,并要求修改前编译。
主要功能
- 01实体与列映射
- 02仓储查询和命名参数
- 03事务、分页与投影
- 04乐观锁定与集成测试
- 05修改前编译并进行完整验证
适用场景
- 01审查 Micronaut Data 实体和仓储
- 02添加事务、分页或投影
- 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 投影或乐观锁
工作流
- 阅读参考资料并评估项目上下文
阅读 references/512-frameworks-micronaut-data.md,并检查当前项目设置,然后再提出更改建议。
- 明确范围并确定目标改进
确定请求的结果、约束,以及要应用的最小安全更改集。
- 应用符合框架规范的更改
遵循参考模式和项目约定,实施或重构配置 / 代码。
- 运行验证并报告结果
执行适当的构建 / 测试,并总结更改内容、验证情况和后续操作。
参考资料
详细指南、示例和约束请参阅 references/512-frameworks-micronaut-data.md。
评论
支持 Markdown