妙鸿 Java 后端仓库指南
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_928f7032/111-new。
技能介绍
解决什么问题
在 miaohong-cloud-base 这类多模块 Java 17 / Maven 仓库中,常见困难不是写不出接口,而是不知道改动应落在哪个模块、哪些 Mapper.xml 需要联动、Nacos 配置在哪里生效。若每次重新翻目录,容易误改 target/、把共享契约放进具体服务、或在 service 之间形成循环依赖。
技能如何工作
该技能把仓库经验整理为按需加载的参考文档:先用根目录 CLAUDE.md 对齐编码标准,再根据任务加载 references/module-map.md、references/commands.md、references/conventions.md 等。对 Controller、Feign provider、Mapper XML、异常传播分别给出对应风格文档,并提示优先使用 -pl、-am 做目标构建。它还约束请求形态:POST 使用 @RequestBody DTO,GET 限制单参数查询,不使用 @PutMapping、@DeleteMapping、@PathVariable 和 Map 请求/响应。
适用边界
技能面向 miaohong-cloud-base 的后端开发与排查,依赖 CLAUDE.md 作为最高规则。若仓库配置、模块名或 Nacos 导入方式变更,应以当前源码和 CLAUDE.md 为准;它不替代人工审查共享契约影响面,也不适用于与该仓库无关的通用 Java 项目。
使用场景
- 在新增用户接口前,定位 controller、API DTO 与 Feign provider 所在模块。
- 排查 Nacos 或网关启动失败时,按 troubleshooting 检查导入配置与服务入口。
- 修改共享契约前,同时检查 provider 模块与 API 模块,避免只改一侧。
- 新增 mapper 方法时,同步修改对应 Java 包路径下的 Mapper.xml。
适合人员
- 负责 miaohong-cloud-base 接口、Feign 契约与共享 DTO 联动的 Java 后端工程师
- 需要排查 Nacos、网关、启动失败或 mapper 路由问题的微服务开发者
- 接手 miaohong-cloud-base 仓库、希望少踩模块边界坑的新成员
- 要维护 Controller、异常传播与 MyBatis XML 规范的后端工程师