@routerhub/agent-rules 1.5.127 → 1.5.128

package/AGENTS.base.md

@@ -133,9 +133,12 @@
 - 测试描述、断言使用中文。测试用例先主流程再边界情况。
 - ⚠️ 代码中出现晦涩难懂的技术名词（如 X-Request-ID、反向代理、CORS、JWT、CSRF、幂等、熔断、降级等）时，必须附加中文注解。注解分两层：（1）先说明该名词是什么功能、解决什么问题；（2）再解释其中特殊因子/字段的具体作用。目的是让不熟悉该领域的人也能看懂代码逻辑，不要求已有背景知识。
 
-## 代码质量
+## 代码质量（一次写对，为结果负责）
 
 - ⚠️ 为上线结果负责：把每一行代码都当作「这就是要交付给用户的最终版」来写，而非「先写着、等 review 再挑」。落笔前想清楚最优路径，写完自问有没有重复可提取、能不能更简单、命名是否达意，自己一眼能看出的改进当场改掉，不留给 review 兜底。
+- ⚠️ 落笔前先做设计权衡：动手前先给出 2~3 个实现方案和各自的代价取舍，选最优再写，不要一头扎进实现。复杂度高的地方（并发、锁、资源、边界等），尤其要先把「最坏情况」想全再动笔。
+- ⚠️ 提交前按「最坏情况」自检：边界值、空值、异常路径、并发/重复触发、重试、依赖不可用（Redis/DB/网络）时，行为是否仍正确、会不会出错或重复执行。
+- ⚠️ 沉淀反模式：每次 review 暴露的设计问题（锁粒度、职责划分、重复实现等），提炼成通用的「反模式」记录，下次写同类代码时自发对照，避免重犯。
 
 ## ⚠️ 数据链路改动核对铁律
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@routerhub/agent-rules",
-  "version": "1.5.127",
+  "version": "1.5.128",
   "description": "Shared Copilot agent rules and guidelines for RouterHub projects",
   "main": "AGENTS.base.md",
   "bin": {

package/rules/global.md

@@ -133,9 +133,12 @@ name: "通用规则"
 - 测试描述、断言使用中文。测试用例先主流程再边界情况。
 - ⚠️ 代码中出现晦涩难懂的技术名词（如 X-Request-ID、反向代理、CORS、JWT、CSRF、幂等、熔断、降级等）时，必须附加中文注解。注解分两层：（1）先说明该名词是什么功能、解决什么问题；（2）再解释其中特殊因子/字段的具体作用。目的是让不熟悉该领域的人也能看懂代码逻辑，不要求已有背景知识。
 
-## 代码质量
+## 代码质量（一次写对，为结果负责）
 
 - ⚠️ 为上线结果负责：把每一行代码都当作「这就是要交付给用户的最终版」来写，而非「先写着、等 review 再挑」。落笔前想清楚最优路径，写完自问有没有重复可提取、能不能更简单、命名是否达意，自己一眼能看出的改进当场改掉，不留给 review 兜底。
+- ⚠️ 落笔前先做设计权衡：动手前先给出 2~3 个实现方案和各自的代价取舍，选最优再写，不要一头扎进实现。复杂度高的地方（并发、锁、资源、边界等），尤其要先把「最坏情况」想全再动笔。
+- ⚠️ 提交前按「最坏情况」自检：边界值、空值、异常路径、并发/重复触发、重试、依赖不可用（Redis/DB/网络）时，行为是否仍正确、会不会出错或重复执行。
+- ⚠️ 沉淀反模式：每次 review 暴露的设计问题（锁粒度、职责划分、重复实现等），提炼成通用的「反模式」记录，下次写同类代码时自发对照，避免重犯。
 
 ## ⚠️ 数据链路改动核对铁律