diff --git a/docs/design/13-toolchain-and-dev-workflow.md b/docs/design/13-toolchain-and-dev-workflow.md
index 6e014d7..19bb9e3 100644
--- a/docs/design/13-toolchain-and-dev-workflow.md
+++ b/docs/design/13-toolchain-and-dev-workflow.md
@@ -1929,6 +1929,7 @@ class TemplateEngine:
 | 未知事件类型 | 忽略 + 日志 info | 200 |
 | 幂等检测到重复 | 忽略 + 日志 info | 200 |
 | 未知 Agent（不在映射表） | 忽略 + 日志 warning | 200 |
+| PR 文件获取失败（3次重试后） | 降级为 risk_level=standard + 错误信息写入 Mail 正文 | 200（handler 内部处理） |
 | 模板填充失败 | 日志 error | 500（触发 Gitea 重试） |
 | Mail 创建失败 | 日志 error | 500（触发 Gitea 重试） |