From 657758dec29601585c46d6f2837e9a285f6de820 Mon Sep 17 00:00:00 2001
From: roymondchen <roymondchen@tencent.com>
Date: Thu, 5 Nov 2026 11:13:56 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=20AGENTS.md=20?=
 =?UTF-8?q?=E7=BC=96=E7=A0=81=E5=8E=9F=E5=88=99?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 AGENTS.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 4cb00c1d..b121274f 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -43,6 +43,13 @@ pre-commit 跑 lint-staged 与 `pnpm check:type`，pre-push 跑 `pnpm coverage`
 - 禁止直接修改 CHANGELOG.md，应通过 `pnpm changelog` 生成
 - 禁止提交未达 85% 测试覆盖率的新增/修改代码
 
+## 编码原则
+
+1. **防过度防御**：几乎不会发生的边界/并发问题，讲清概率并经用户确认后再加，严禁为“理论上更稳”私自膨胀代码。
+2. **入口单次校验**：外部数据只在边界校验一次，内部靠类型系统流转，禁止层层重复判断。
+3. **拒绝提前抽象**：单次使用的逻辑就近内联，不随意提前拆分无意义的 helper。
+4. **控制复杂度**：非必要不用 try/catch，能单函数清晰搞定的别硬拆。
+
 ## 常用命令
 
     pnpm bootstrap        # 安装依赖并构建