Docker7530
32 lines
1.3 KiB
Markdown
32 lines
1.3 KiB
Markdown
# 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.3`
|
||
- 后端框架：Spring Ai `1.1.2`
|
||
|
||
## 开发规范
|
||
|
||
如果涉及改动对外提供的 RESTful API 需对 MCP 动态工具管理 API 文档进行及时更新。
|
||
|
||
开发 MCP 相关功能需要遵守 MCP 协议说明。
|
||
|
||
## 日志和注释
|
||
|
||
- 日志和注释使用中文
|
||
- 关键位置须有日志，日志级别仅需要 `info` 和 `error` 两个级别
|
||
- public 方法必须提供注释说明，关键位置也可以适量增加注释说明
|
||
|
||
## 测试规范（强约束）
|
||
|
||
- 新增功能、修复问题、修改业务行为：必须新增/更新对应的测试用例（优先单元测试），覆盖核心规则与边界条件
|
||
- 修复 Bug：必须提供回归测试（修复前失败、修复后通过）
|
||
- 纯代码格式/注释调整：可以不新增测试，但必须确保现有测试全部通过
|
||
- 必要时才写集成测试（如持久化/序列化/校验）：控制数量，避免把所有测试都写成 `@SpringBootTest`
|
||
- 提交前必须在仓库根目录运行 `mvn test` 并确保全部通过；测试未通过禁止提交
|