# Agent理解度测试清单 使用这个清单来验证Agent是否正确理解了项目上下文。 ## 基础理解测试 ### 1. 项目结构 问:项目根目录在哪里?app目录下有哪些子目录? 期望:能正确说出路径和主要目录结构 ### 2. 开发规范 问:导入语句应该如何排序? 期望:标准库 -> 第三方库 -> 本地模块 ### 3. 基础类 问:数据库模型应该继承哪个基类? 期望:BaseModel,可能还需要AuditMixin或SoftDeleteMixin ## 架构理解测试 ### 4. 协作机制 问:什么是GlobalContext?它的作用是什么? 期望:能解释全局上下文的作用和使用方式 ### 5. 模块边界 问:你的模块可以直接访问其他模块的数据库表吗? 期望:不可以,应该通过服务接口调用 ### 6. 错误处理 问:如何处理外部服务(如Coze)调用失败? 期望:使用ExternalServiceError,包含重试机制 ## 具体实现测试 ### 7. API响应 问:API响应应该使用什么格式? 期望:使用ResponseModel包装,包含code、message、data ### 8. 依赖注入 问:如何在API中获取当前用户? 期望:使用Depends(get_current_user) ### 9. 日志记录 问:如何记录一个用户登录事件? 期望:使用logger.info(),包含结构化数据 ### 10. 测试要求 问:单元测试覆盖率要求是多少? 期望:80%以上 ## 评分标准 - 10个全部正确:Agent完全理解项目 - 8-9个正确:理解良好,可以开始开发 - 6-7个正确:需要补充部分文档 - 5个以下:需要重新引用完整文档 ## 使用方法 ``` 请回答以下问题来验证你对项目的理解: 1. 项目根目录在哪里? 2. 导入语句应该如何排序? 3. 数据库模型应该继承哪个基类? 4. 什么是GlobalContext? 5. 你的模块可以直接访问其他模块的数据库表吗? 6. 如何处理外部服务调用失败? 7. API响应应该使用什么格式? 8. 如何在API中获取当前用户? 9. 如何记录一个用户登录事件? 10. 单元测试覆盖率要求是多少? ```