基于 Claude Code 的 SOFABoot + DDD 后端开发技能与编码规范仓库,为 AI 编码助手提供项目脚手架生成、编码规范检查与自动修复能力。
定义于 skills/sofaboot-cli-launch/SKILL.md,通过 CLI 构建并启动 SOFABoot 应用。
- 自动从
.idea/workspace.xml读取 Maven 配置(Maven Home、settings.xml、本地仓库路径) - 以内网模式启动(关闭服务注册、本地端口
8889、关闭 JVM 验证) - 支持前台/后台启动
- 提供停止服务与验证启动的命令
所有规范文档位于 docs/ 目录,agent.md 为 AI 触发校验的总入口。
| 文档 | 主要内容 |
|---|---|
| 1.分层架构(DDD)规范 | DDD 分层架构与调用链路、包命名规范、各层编码模板(Facade/Service/Repository/Mapper/DO/DTO)、SOFAStack RPC 双协议绑定 |
| 2.命名规范 | 项目/类/接口/方法/变量/配置文件/API 命名规则、多实现类命名、分层数据对象命名、禁止拼音与无意义命名 |
| 3.编码规范 | Java 8 兼容性禁用 API 列表、空值处理与防御式编程、异常处理、日志规范、数据库操作、并发与线程安全、SOFA RPC 规范、MyBatis-Plus 规范、AI 编码协作准则 |
| 4.日志规范 | SLF4J + Log4j2 强制使用、禁止控制台输出、日志级别规范、Logger 声明规范、占位符与异常日志格式 |
| 5.外部接口引用规范 | 外域依赖引入位置限制(仅 integration/message 子模块)、@SofaReference 注入规范、返参校验与处理、常见违规场景 |