Java 后端编码规范指南

解决什么问题

Java 后端开发里，需求理解、技术方案、编码风格与测试验收常分散在不同环节：有人直接改代码，有人补测试时才发现边界缺失，文档和实现口径也不一致。java-coding-guide 把这些约束变成可执行的流程：先澄清范围、边界、非功能要求，再记录需求变更，更新技术方案，然后按 Java 后端编码规范 实现，最后完成编译、静态检查和单元测试。

技能如何工作

该技能围绕两个资源文件展开：coding-standards.md 用于约束后端代码编写，unit-testing-standards.md 用于约束测试编写。它要求按顺序执行：

• 需求分析：明确范围、边界、性能、安全、兼容性与数据一致性，显式写出默认假设。
• 文档沉淀：将已确认变更写入需求变更文档，并在 docs/design/ 或仓库既有路径下新建/增量更新技术方案。
• 规范编码：遵循分层调用、DTO、Mapper XML、Spring Boot、事务与注释等规则，优先复用现有组件。
• 质量验证：执行 mvn -q -DskipTests compile 等项目约定编译命令，修复错误后按单测规范补充核心逻辑、边界与异常路径测试，并反复运行至通过。

适用边界

它更适合 Java/Spring Boot 后端仓库中需要统一工程流程的场景，尤其适合希望让 Agent 在实现前先对齐需求和方案的团队。该技能不会替代项目自身架构决策、领域规则或团队私有规范；文档路径、构建命令与静态检查策略仍应以仓库实际约定为准。