docs(agents): fix bugs at the cause; cut redundant UI copy but keep accessible names

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014Ad9rqAB8pXXvyzh7f4X8v

AGENTS.md

@@ -92,6 +92,8 @@
 
 这份文件是产品与代码 Bug 的长期历史入口；`docs/research/pre_work_error_ledger.md` 负责基础设施、外部引擎、碎片目录与预检风险，两者不得互相替代。
 
+**修在根因上（2026-10-23 产品定）**：Fix a bug at its cause, reasoning from first principles and established best practice. Do not patch over the symptom.
+
 1. 修复前必须用报错原文、接口路径、状态码、模块名和用户操作搜索历史记录，优先检查相同模块的根因与防复发措施。
 2. 若历史问题复发，必须关联原 `BUG-NNN`，说明旧测试、约束或发布门禁为何未拦住；不得把复发伪装成无关的新问题。
 3. Bug 修复必须在同一变更中更新 `docs/BUG_HISTORY.md`：补充现有记录或新增连续编号，并记录状态、现象、触发条件、根因、修复、验证、防复发、关联记录和修复版本。
@@ -117,6 +119,9 @@
 6. 不改数据库结构的轮次不得顺带动迁移；动表的轮次必须真跑 `npm run test:db`。staging 迁移在部署之前自动应用，因此必须对当前已部署的那一版代码向后兼容：加列、加表、加索引、加触发器、加函数可以同轮；删列、删表、重命名、收紧 `NOT NULL` / `CHECK`、改类型必须拆成两轮——先加新的并部署代码，再删旧的。自托管 PostgreSQL 兼容层的 stub 测不到真实查询语法，新用到的查询写法必须 `test:db` 真查或部署后 smoke（BUG-990：未实现的 `not(col,"is",null)` 让归档列表 500 了两周）。
 7. 不得顺手升级依赖、不得顺手修不在任务书里的 warning；发现了写进 `BLOCKED.md` 或进度记录。
 8. 移动、删除或改写组件与语句前，先在 `frontend/tests/` 和 `tests/` 里 grep 该文件路径、要删的类名与语句，找出按源码文本断言的合同测试，同一轮跟着改（按第 3 条写三栏）。漏改会让门禁红而业务代码是对的，已发生多次：BUG-933 / 934 / 939 / 992 / 1014。
+9. Avoid unnecessary secondary labels and descriptions. Let the layout do the explaining.（2026-10-23 产品定）
+10. Avoid unnecessary supporting text, descriptive copy, and redundant UI microcopy.（2026-10-23 产品定）
+11. 删掉重复解释布局的文案，但保留必要的表单标签和控件名称。比如搜索框旁边已有「搜索」按钮，视觉上可以省掉重复标签，代码里的可访问名称却不能一起删。界面清爽和读屏能用不冲突。（2026-10-23 产品定）
 
 ## 8. 隐私与安全