1778682052

work/移动杭研/AI 项目/CLAUDE.md

@@ -0,0 +1,31 @@
+# CLAUDE.md  
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.  
+
+本文件用于指导 Claude Code（claude.ai/code）在此仓库中开展工作。  
+
+## 技术栈  
+
+- Java：`21`（`<java.version>`）  
+- 后端框架：Spring Boot `4.0.5`  
+- 后端框架：Spring Ai `1.1.4`  
+
+## 开发规范  
+
+如果涉及改动对外提供的 RESTful API 需对 `docs/API-概览.md` 及对应模块文档进行及时更新。  
+
+开发 MCP 相关功能需要遵守 `docs/MCP-协议说明.md`。  
+
+## 日志和注释  
+
+- 日志和注释使用中文  
+- 关键位置须有日志，日志级别仅需要 `info` 和 `error` 两个级别  
+- public 方法必须提供注释说明，关键位置也可以适量增加注释说明  
+
+## 测试规范（强约束）  
+
+- 新增功能、修复问题、修改业务行为：必须新增/更新对应的测试用例（优先单元测试），覆盖核心规则与边界条件  
+- 修复 Bug：必须提供回归测试（修复前失败、修复后通过）  
+- 纯代码格式/注释调整：可以不新增测试，但必须确保现有测试全部通过  
+- 必要时才写集成测试（如持久化/序列化/校验）：控制数量，避免把所有测试都写成 `@SpringBootTest`  
+- 提交前必须在仓库根目录运行 `mvn test` 并确保全部通过；测试未通过禁止提交