docs: 补充 AGENTS.md 编码原则

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        # 安装依赖并构建