diff --git a/AGENTS.md b/AGENTS.md
index 4fabb83..417d8de 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -73,6 +73,7 @@ lpt-be/src/main/java/com/guo/learningprogresstracker/
 - 业务错误：`CommonResult.error(msg)`，code=400，HTTP 200。
 - 未登录：`GlobalExceptionHandler.handleNotLogin()`，HTTP 401 + code=401。
 - 参数校验失败：`MethodArgumentNotValidException`，code=400。
+- 用户可见错误文案必须口语化、可理解，避免“无法生成”“不存在”等技术化表述；技术细节写入日志。例如无学习报告时应提示“这个任务还没开始学习哦，学习后产生学习报告后再来吧”，而不是“没有学习报告，无法生成思维导图”。
 
 ## DTO 转换