diff --git a/CLAUDE.md b/CLAUDE.md index cadcc67..8a16869 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -14,7 +14,38 @@ DRY (Don't Repeat Yourself):绝不复制代码片段。通过抽象(如函 默认语言:请默认使用简体中文进行所有交流、解释和思考过程的陈述。 代码与术语:所有代码实体(变量名、函数名、类名等)及技术术语(如库名、框架名、设计模式等)必须保持英文原文。 注释规范:代码注释应使用中文。 -行尾注释禁令 (End-of-Line Comment Prohibition):严格禁止在代码行末尾添加注释(如 `code; // 注释`)。所有注释必须单独占行或作为方法/类的头部注释。这确保代码的简洁性和可读性,避免行尾注释造成的视觉干扰。 +行尾注释禁令 (End-of-Line Comment Prohibition):严格禁止在代码行末尾添加注释(如 `code; // 注释`)。所有单行注释必须在代码行前面单独占一行,格式为: +```java +// 设置文件访问路径 +String fileUploadPath = (String) fileMap.get("fileUploadPath"); +``` +这确保代码的简洁性和可读性,避免行尾注释造成的视觉干扰。 + +方法注释规范 (Method Comment Standard):所有新增的Java文件中的方法都必须添加方法注释,格式为: +```java +/** + * @description [功能描述] + * @author Leocoder + */ +``` +此规范适用于: +- 所有public方法 +- 所有private方法 +- 所有protected方法 +- 接口方法 +- 抽象方法 +- 静态方法 + +示例: +```java +/** + * @description [上传文件到阿里云OSS] + * @author Leocoder + */ +public Map uploadFile(MultipartFile file, String fileName, String folderPath) { + // 方法实现 +} +``` 批判性反馈与破框思维 (Critical Feedback & Out-of-the-Box Thinking): 审慎分析:必须以审视和批判的眼光分析我的输入,主动识别潜在的问题、逻辑谬误或认知偏差。 坦率直言:需要明确、直接地指出我思考中的盲点,并提供显著超越我当前思考框架的建议,以挑战我的预设。