AI写代码的“上下文陷阱”：为什么AI总是写错？如何系统性解决？

---description: globs: alwaysApply: true---# AE评测系统开发指南
## 项目结构
- [demo-start](mdc:demo-start): 项目启动模块，**这个模块中没有业务逻辑, 在我没有明确指令是不要修改此模块中的代码**。- [demo-api](mdc:demo-api): HSF API接口定义模块, **对于Demo系统的开发，只关心 [demo](mdc:demo-api/src/main/java/com/aliexpress/demo) package下的内容, 其他package内容忽略**  - [demo/api](mdc:demo-api/src/main/java/com/aliexpress/demo/api): Demo系统的HSF API的interface均在这个package下定义, 命名后缀为Service  - [demo/model](mdc:demo-api/src/main/java/com/aliexpress/demo/model): Demo系统的HSF API的model均保存在这个package, 命名后缀为Request、DTO  - [demo/common](mdc:demo-api/src/main/java/com/aliexpress/demo/common): Demo系统的HSF API的enum均保存在这个package下, 命名后缀为Enum  - [demo/base](mdc:demo-api/src/main/java/com/aliexpress/demo/base): Demo系统的HSF API的model的基类均保存在这个package下- [demo-biz](mdc:demo-biz): 业务逻辑实现模块, **对于Demo系统的开发，只关心 [demo](mdc:demo-api/src/main/java/com/aliexpress/biz/demo) package下的内容, 其他package内容忽略**  - [demo/api](mdc:demo-biz/src/main/java/com/aliexpress/biz/demo/api): Demo系统的HSF API的实现类均在这个package下定义, 命名后缀为ServiceImpl    - [demo/api/converter](mdc:demo-biz/src/main/java/com/aliexpress/biz/demo/api/converter): Demo系统的HSF API的实现类使用的Converter类均保存在这个package下, 命名后缀为Converter    - [demo/api/validate](mdc:demo-biz/src/main/java/com/aliexpress/biz/demo/api/validate): Demo系统的HSF API的实现类使用的校验类均保存在这个package下, 命名后缀为Validate  - [demo/common](mdc:demo-biz/src/main/java/com/aliexpress/biz/demo/common): Demo系统的内部的公共类均保存在这个package下, 命名后缀为Enum、Constant  - [demo/config](mdc:demo-biz/src/main/java/com/aliexpress/biz/demo/config): Demo系统的内部的Diamond、HSF配置类均保存在这个package下, 命名后缀为Config、Configuration  - [demo/consumer](mdc:demo-biz/src/main/java/com/aliexpress/biz/demo/consumer): Demo系统的MetaQ Consumer类均保存在这个package下, 命名后缀为Consumer(消费MetaQ)    - [demo/consumer/listener](mdc:demo-biz/src/main/java/com/aliexpress/biz/demo/consumer/listener): Demo系统的Consumer的消费逻辑实现类均保存在这个package下, 命名后缀为Listener(实现消费逻辑)  - [demo/demouator](mdc:demo-biz/src/main/java/com/aliexpress/biz/demo/demouator): Demo系统的评估器实现类均保存在这个package下, 命名后缀为demouator, **此处的代码相对比较稳定，在我没有明确指令时不要自行修改**  - [demo/executor](mdc:demo-biz/src/main/java/com/aliexpress/biz/demo/executor): Demo系统的通用业务逻辑实现类均保存在这个package下, 命名后缀为Executor  - [demo/invoker](mdc:demo-biz/src/main/java/com/aliexpress/biz/demo/invoker): Demo系统的调用AI应用的通用封装类均保存在这个package下, **此处的代码相对比较稳定，在我没有明确指令时不要自行修改**  - [demo/task](mdc:demo-biz/src/main/java/com/aliexpress/biz/demo/task): Demo系统的任务提交和任务执行的的通用封装类均保存在这个package下, **此处的代码相对比较稳定，在我没有明确指令时不要自行修改**  - [demo/util](mdc:demo-biz/src/main/java/com/aliexpress/biz/demo/util): Demo系统的工具类均保存在这个package下, **此处的代码相对比较稳定，在我没有明确指令时不要自行修改**- [demo-core](mdc:demo-core): 核心功能模块, 包含基础设施和通用组件, **对于Demo系统的开发, 任何时候都不需要关注这个模块中的内容**- [demo-job](mdc:demo-job): 定时任务模块, **对于Demo系统的开发, 任何时候都不需要关注这个模块中的内容**- [demo-workflow](mdc:demo-workflow): 工作流相关模块, **对于Demo系统的开发, 任何时候都不需要关注这个模块中的内容**- [demo-infrastructure](mdc:demo-infrastructure): 基础设施模块, 包含数据访问、外部服务集成等, **对于Demo系统的开发, 主要关心其中操作数据库的相关代码**  - [dao/demo](mdc:demo-infrastructure/src/main/java/com/aliexpress/infrastructure/dao/demo): Demo系统的Mybatis-Plus的Mapper类均保存在这个package下，后缀为Mapper  - [model/demo](mdc:demo-infrastructure/src/main/java/com/aliexpress/infrastructure/model/demo): Demo系统的Mybatis-Plus的实体类均保存在这个package下，其中PO后缀的是与数据库表直接映射的实体类，其中/model文件夹下的类是和业务层交互的实体类  - [model/convert](mdc:demo-infrastructure/src/main/java/com/aliexpress/infrastructure/model/convert): Demo系统的Mybatis-Plus的PO与Model之间的转换类均保存在这个package下，后缀为Converter  - [repository](mdc:demo-infrastructure/src/main/java/com/aliexpress/infrastructure/repository): Demo系统的数据库操作类均保存在这个package下，接口后缀为Repository，实现类后缀为RepositoryImpl，核心的作用是调用Mapper与数据库操作、转换PO与Model- [demo-provider](mdc:demo-provider): 服务提供者模块  - [hsf/provider](mdc:demo-provider/src/main/java/com/aliexpress/provider/hsf/provider): 增加新的HSF服务Provider需要在 [HsfProviderConfig.java](mdc:demo-provider/src/main/java/com/aliexpress/provider/hsf/provider/HsfProviderConfig.java)类中增加配置- [demo-sdk](mdc:demo-sdk): Demo系统SDK工具模块，**此处的代码相对比较稳定，在我没有明确指令时不要自行修改**
## 主要技术栈
- Pandora Boot: 基于Spring Boot的阿里内部框架- HSF: 阿里内部的RPC框架- Diamond: 阿里内部的配置中心- Tair: 阿里内部的缓存服务- MetaQ: 阿里内部的消息服务- MyBatis-Plus: 轻量级的ORM框架

---description: 根据创建表的SQL生成操作数据库层增删改查代码时引用此文件globs: alwaysApply: false---## 操作数据库编码规范#### 操作DB框架1. 开发框架：使用MyBatis-Plus进行编码2. 调用逻辑：上层通过注入的方式调用Repository的实现，在Repository的实现的实现中调用Mapper，调用Mapper后返回的对象是PO，再通过Converter转换成Model后返回为上层调用方。3. 数据类型的选择：时间字段使用java.util.Date类型4. 使用MyBatis-Plus方法注意事项：注意不要调用deprecated的方法5. Repository层的删除方法：统一使用逻辑删除，逻辑删除字段是is_deleted6. Repository层需操作时需要附加对当前环境的处理：调用 [EnvUtil.java](mdc:task-infrastructure/src/main/java/com/aliexpress/qa/task/infrastructure/util/EnvUtil.java)的getEnv().getCode()方法7. Repository层的的分页方法：调用MyBatis-Plus的selectPage方法   #### DAO层PO1. DAO层PO的命名规范为${TableName}PO2. DAO层PO的存放目录[model](mdc:task-infrastructure/src/main/java/com/aliexpress/qa/task/infrastructure/model)
#### DAO层Mapper1. DAO层Mapper命名规范为${TableName}Mapper2. DAO层Mapper的存放目录[dao](mdc:task-infrastructure/src/main/java/com/aliexpress/qa/task/infrastructure/dao)   #### Repository层1. Repository层interface命名规范为${TableName}Repository2. Repository层实现命名规范为${TableName}RepositoryImpl3. Repository层Model命名规范为${TableName}Model4. Repository层interface的存放目录[repository](mdc:task-infrastructure/src/main/java/com/aliexpress/qa/task/infrastructure/repository)5. Repository层实现的存放目录[repositoryimpl](mdc:task-infrastructure/src/main/java/com/aliexpress/qa/task/infrastructure/repository/impl)6. Repository层Model存放目录[model](mdc:task-infrastructure/src/main/java/com/aliexpress/qa/task/infrastructure/model)
#### Converter层1. Converter层命名规范位${TableName}Converter2. Converter层的存放目录[convert](mdc:task-infrastructure/src/main/java/com/aliexpress/qa/task/infrastructure/model/convert)3. Converter代码规范：使用字段进行映射，禁止使用json序列化、BeanUtils.copyProperties等方式
## 参考代码1. DAO层PO参考代码``` javaimport com.baomidou.mybatisplus.annotation.TableName;import lombok.AllArgsConstructor;import lombok.Builder;import lombok.Data;import lombok.NoArgsConstructor;
${必要的引用}
/** * @author chigong.zxn */@Data@Builder@TableName(value = "${tableName}")@AllArgsConstructor@NoArgsConstructorpublicclass ${TableName}PO {    ${注释}    ${只可以使用包装类型，禁止使用基础类型}    ${columnName}}```2. DAO层Mapper参考代码，【注意：不需要增加增删改查方法，MyBatis-Plus已经默认通过继承BaseMapper提供】``` javaimport com.aliexpress.qa.task.infrastructure.model.eval.${TableName}PO;import com.baomidou.mybatisplus.core.mapper.BaseMapper;import org.apache.ibatis.annotations.Mapper;
/** * @author chigong.zxn */@Mapperpublic interface ${TableName}Mapper extends BaseMapper<${TableName}PO> {}```3. Repository层interface参考代码，【注意：生成基础的增删改查方法】``` javaimport com.aliexpress.qa.task.infrastructure.model.eval.${TableName}PO;import com.aliexpress.qa.task.infrastructure.model.eval.${TableName}Model;
/** * @author chigong.zxn */@Mapperpublic interface ${TableName}Repository {    ${注释}    ${增删改查方法}}```4. Repository层实现参考代码，【注意：继承Repository接口实现基础增删改查方法，调用Mapper生成基础的增删改查方法】``` javaimport com.aliexpress.qa.task.infrastructure.model.eval.${TableName}PO;import com.aliexpress.qa.task.infrastructure.model.eval.${TableName}Model;
/** * @author chigong.zxn */@Mapperpublic interface ${TableName}RepositoryImpl implements ${TableName}Repository {    ${注释}    ${实现Repository增删改查方法}}```5. Repository层Model参考代码``` javaimport lombok.AllArgsConstructor;import lombok.Builder;import lombok.Data;import lombok.NoArgsConstructor;
${必要的引用}
/** * @author chigong.zxn */@Data@Builder@AllArgsConstructor@NoArgsConstructorpublicclass ${TableName}Model {    ${注释}    ${只可以使用包装类型，禁止使用基础类型}    ${columnName}}```6. Converter层参考代码，【注意：生成2个静态方法，PO转Model、Model转PO】``` javaimport com.aliexpress.qa.task.infrastructure.model.eval.${TableName}PO;import com.aliexpress.qa.task.infrastructure.model.eval.${TableName}Model;
/** * @author chigong.zxn */publicclass ${TableName}Converter {    ${注释}    ${PO转换为Model}
    ${注释}    ${Model转换为PO}}```

---description: 增加HSF接口时引用此文件globs: alwaysApply: false---## API开发规范### 服务实现* 验证器存放目录：[validate](mdc:task-biz/src/main/java/com/aliexpress/qa/task/biz/eval/api/)* 实现要求：必须实现服务验证器* 服务实现代码参考：``` javaimport com.alibaba.fastjson.JSON;import org.slf4j.Logger;import org.slf4j.LoggerFactory;import org.springframework.stereotype.Service;@Servicepublicclass ${服务名}ServiceImpl implements ${服务名}Service {    privatestaticfinal Logger logger = LoggerFactory.getLogger(${服务名}ServiceImpl.class);    @Autowired    private ${服务校验器}Validate validate;    // 如果需要调用其他bean也可以在此处引入    // 如：    // @Autowired    // private EvalDatasetDetailRepository evalDatasetDetailRepository;    @Override    public ${服务方法出参} ${服务方法名}(${服务方法请求体} request) {        logger.info("${服务名}Service.${服务方法名} request:{}", JSON.toJSONString(request));        ${服务方法出参} response = new ${服务方法出参}();        try {            String validateMsg = validate.${服务方法校验器}Validate(request);            if (StringUtils.isNotBlank(validateMsg)) {                return Response.fail(ErrorCode.PARAM_ERROR.name(), validateMsg);            }            // 在此处实现业务逻辑            ${业务逻辑}        } catch (Exception e) {            logger.error("${服务名}Service.${服务方法名} error", e);            response = Response.fail(ErrorCode.SYSTEM_ERROR.name(), e.getMessage());        }        logger.info("${服务名}Service.${服务方法名} response:{}", response);        return response;    }}```### 服务验证器* 验证器存放目录：[validate](/task-biz/src/main/java/com/aliexpress/qa/task/biz/eval/api/validate/)* 验证器代码参考：验证失败则返回失败原因字符串，验证成功则返回空字符串``` javaimport com.aliexpress.qa.task.biz.eval.util.ValidateUtil;import org.springframework.stereotype.Component;@Componentpublicclass ${服务名}Validate {    // 如果需要调用其他bean也可以在此处引入    // 如：    // @Autowired    // private EvalDatasetDetailRepository evalDatasetDetailRepository;    public String ${服务方法名}Validate(${服务方法请求体} request) {        // 请求体不能为空        if (request == null) {            return"请求参数不能为空";        }        // 基础校验，使用ValidateUtil校验net.sf.oval annotation        String validateMsg = ValidateUtil.validate(request);        if (StringUtils.isNotBlank(validateMsg)) {            return validateMsg;        }        // 写明校验注释        #{文档要求的其他校验逻辑}        // 返回空字符串则校验成功        return StringUtils.EMPTY;    }}```### 分布式锁使用* 服务实现代码参考：``` javaimport com.alibaba.fastjson.JSON;import org.slf4j.Logger;import org.slf4j.LoggerFactory;import org.springframework.stereotype.Service;import com.aliexpress.qa.task.infrastructure.util.lock.DistributedLockUtil;@Servicepublicclass ${服务名}ServiceImpl implements ${服务名}Service {    privatestaticfinal Logger logger = LoggerFactory.getLogger(${服务名}ServiceImpl.class);    @Autowired    private ${服务校验器}Validate validate;    @Autowired    private DistributedLockUtil distributedLockUtil;    // 如果需要调用其他bean也可以在此处引入    // 如：    // @Autowired    // private EvalDatasetDetailRepository evalDatasetDetailRepository;    @Override    public ${服务方法出参} ${服务方法名}(${服务方法请求体} request) {        logger.info("${服务名}Service.${服务方法名} request:{}", JSON.toJSONString(request));        ${服务方法出参} response = new ${服务方法出参}();        try {            String validateMsg = validate.${服务方法校验器}Validate(request);            if (StringUtils.isNotBlank(validateMsg)) {                return Response.fail(ErrorCode.PARAM_ERROR.name(), validateMsg);            }            // 根据业务逻辑要求构建lockKey            String lockKey = ...;            // 分布式锁，避免并发调度            DistributedLock lock = distributedLockUtil.getLock(lockKey);            // 获取分布式锁            try {                lock.tryLock(1000L);            } catch (GetLockErrorException lockException) {                return Response.fail(ErrorCode.LOCK_ERROR.name(), ErrorCode.LOCK_ERROR.getMessage());            }            try {                // 在此处实现业务逻辑                ${业务逻辑}             } finally {                lock.unlock();            }        } catch (Exception e) {            logger.error("${服务名}Service.${服务方法名} error", e);            response = Response.fail(ErrorCode.SYSTEM_ERROR.name(), e.getMessage());        }        logger.info("${服务名}Service.${服务方法名} response:{}", response);        return response;    }}```

---description: globs: alwaysApply: false---# 单元测试指南
## 测试框架- JUnit Jupiter 5.9.2- Mockito 4.11.0- JUnit Platform 1.9.2
## 严格执行- 禁止改变被测试方法的任何行为- private方法测试: 使用反射的方式测试private方法, 禁止改变被测试方法的private  ```java  @BeforeEach  voidsetUp() throws NoSuchMethodException {      // 获取私有方法      Method privateMethod = TargetClass.class.getDeclaredMethod("privateMethodName",           ParameterType1.class, ParameterType2.class);      privateMethod.setAccessible(true);  }
  @Test  voidprivateMethodName_Should_ExpectedBehavior_When_StateUnderTest() throws Exception {      // given      // when      Object result = privateMethod.invoke(targetObject, arg1, arg2);      // then      // assertions  }  ```- 静态方法Mock: 使用MockedStatic方式- staticfinal字段处理: 避免直接测试或mock staticfinal字段（如日志记录器），专注于测试核心业务逻辑和返回值- Mybatis-Plus初始化实体类元数据: mock Mybatis-Plus的```LambdaUpdateWrapper、LambdaQueryWrapper```时，在```@BeforeEach```中使用```TableInfoHelper.initTableInfo(new MapperBuilderAssistant(new MybatisConfiguration(), ""),${实体类名}PO.class);```初始化实体类元数据
## 测试命名规范- 使用 `@Test` 注解标记测试方法- 测试方法名应该清晰表达测试目的，并且测试方法名必须包含被测试的方法名- 格式：`${被测试方法名}_Should_ExpectedBehavior_When_StateUnderTest`- 示例：`buildQuery_Should_ReturnQueryWithEntrustBizId_When_UserHasEntrustPermission`
## 测试最佳实践### Mock策略- 优先测试核心业务逻辑，避免过度依赖基础设施组件的验证- 对于不可变的静态组件（如staticfinal字段），采用行为验证而非状态验证- 当无法直接mock某个组件时，考虑通过测试输出结果来间接验证行为- Mock对象使用: 只能对`mock()`创建的对象使用`when()`进行stub，禁止对真实对象（如通过builder模式创建的对象）使用`when()`### 测试重点- 专注于方法的返回值、异常抛出、状态变更等核心行为- 避免测试框架细节、日志输出等非核心功能- 保持测试的简洁性和可维护性

---description: globs: alwaysApply: false---## 生成记忆- 创建记忆文件夹：记忆文件统一存放在 [.cursor/memory](mdc:.cursor/memory) ，如果我提供了指定了文件目录则按照我提供的文件夹存放，如果我没提供则根据需要梳理的链路自动起名创建文件夹- 创建记忆文件：如果我提供了名字，则按照我提供的名字创建，如果我没有提供，则根据需要梳理的链路自动创建文件，已`.md`格式的文件维护记忆。- 记忆文件内容要求：必须包含一个完整的链路图，并且将必要的代码入口、核心的代码逻辑放在记忆文档中。

---description: globs: alwaysApply: false---## 生成开发任务- 创建任务文件夹：当我要求你创建一个开发任务时，你需要根据`当前分支`的名称在 [.cursor/task](mdc:.cursor/task) 文件中查找是否有对应任务的文件，如果没有则创建一个任务文件夹- 创建任务文件：在以`当前分支`命名的文件夹中，创建当前任务的详细描述文件，使用`.md`的文件格式生成文档内容，文件名根据我的要求自动生成一个中文名
## 文档内容规范- 文档结构：保持简洁，专注技术方案。在没有明确要求时不包含开发计划、风险控制、上线计划等管理内容- 测试要求：单元测试要求，覆盖率达到80%以上- 尽量简洁：在满足要求的情况下尽量简洁，如果有需要补充的内容，我会明确的向你表达
## 代码设计规范- 枚举使用：新增字符串类型字段时优先考虑枚举定义，避免硬编码- 历史兼容：新增字段时考虑历史数据兼容性，提供默认值处理

- 禁止作弊：对于生产代码和测试代码的生成，需要完全遵循框架和需求的要求，**禁止通过硬编码的方式直接生成结果或绕开测试等行为**。- 严格按照要求写代码：如果我提供了开发任务的.md文档，请严格按照文档要求生成代码，不要擅自发挥。- 保持简洁：专注按照我的需求生成技术方案。在没有明确要求时不包含开发计划、风险控制、上线计划等冗余内容