Miaohong Java 后端

问题

在 miaohong-cloud-base 这类多模块 Java 后端仓库里，agent 容易把生成产物、本地配置、Nacos 配置和模块边界混在一起，导致改动范围过大、误用 @PathVariable、找错 *Mapper.xml 位置，或在跨服务调用中引入循环依赖。这个技能把仓库约定沉淀成按需加载的参考文件，减少每次任务前重新探索仓库结构的成本。

工作方式

它以 CLAUDE.md 为最高优先级规范，并按任务加载不同引用：

• 仓库导航：读取 references/module-map.md，判断 miaohong-common、miaohong-modules-api 与具体服务模块的边界。
• 构建验证：读取 references/commands.md，优先使用 mvn -pl <module> -am 做窄范围构建。
• 代码风格：在控制器、Feign provider、Mapper XML、异常处理时分别加载对应 reference，约束路由、DTO、Javadoc 和错误传播方式。
• 配置排障：区分 bootstrap.yml、application.yml 与 Nacos 命名空间，并检查网关、启动、mapper 常见问题。

技能还强调只改 src/main 与 src/test，忽略 target/；当外部合同变化时，同时检查 provider 模块和 API 模块。

适用边界

适合 Java 17、Maven、Spring Cloud、Nacos 的后端工程维护。它不是通用 Java 技能，也不替代业务代码审查；若项目结构与 CLAUDE.md 冲突，应以 CLAUDE.md 为准。