@routerhub/agent-rules 1.5.126 → 1.5.127
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.base.md +4 -0
- package/package.json +1 -1
- package/rules/global.md +4 -0
package/AGENTS.base.md
CHANGED
|
@@ -133,6 +133,10 @@
|
|
|
133
133
|
- 测试描述、断言使用中文。测试用例先主流程再边界情况。
|
|
134
134
|
- ⚠️ 代码中出现晦涩难懂的技术名词(如 X-Request-ID、反向代理、CORS、JWT、CSRF、幂等、熔断、降级等)时,必须附加中文注解。注解分两层:(1)先说明该名词是什么功能、解决什么问题;(2)再解释其中特殊因子/字段的具体作用。目的是让不熟悉该领域的人也能看懂代码逻辑,不要求已有背景知识。
|
|
135
135
|
|
|
136
|
+
## 代码质量
|
|
137
|
+
|
|
138
|
+
- ⚠️ 为上线结果负责:把每一行代码都当作「这就是要交付给用户的最终版」来写,而非「先写着、等 review 再挑」。落笔前想清楚最优路径,写完自问有没有重复可提取、能不能更简单、命名是否达意,自己一眼能看出的改进当场改掉,不留给 review 兜底。
|
|
139
|
+
|
|
136
140
|
## ⚠️ 数据链路改动核对铁律
|
|
137
141
|
|
|
138
142
|
- ⚠️ **给一个数据结构(interface/struct/DTO)新增或修改字段后,必须顺着这份数据流转的每一个转发/序列化点逐一核对,不能只改了数据结构定义或链路两端就算完成**。典型漏改位置是中间层"手写请求体字面量"(如 `JSON.stringify({ a, b })`、手动拼接的 `params`/`payload`),新增字段不会自动带过去,也不会报错,只会表现为"下游一直是空的"这种沉默失败。
|
package/package.json
CHANGED
package/rules/global.md
CHANGED
|
@@ -133,6 +133,10 @@ name: "通用规则"
|
|
|
133
133
|
- 测试描述、断言使用中文。测试用例先主流程再边界情况。
|
|
134
134
|
- ⚠️ 代码中出现晦涩难懂的技术名词(如 X-Request-ID、反向代理、CORS、JWT、CSRF、幂等、熔断、降级等)时,必须附加中文注解。注解分两层:(1)先说明该名词是什么功能、解决什么问题;(2)再解释其中特殊因子/字段的具体作用。目的是让不熟悉该领域的人也能看懂代码逻辑,不要求已有背景知识。
|
|
135
135
|
|
|
136
|
+
## 代码质量
|
|
137
|
+
|
|
138
|
+
- ⚠️ 为上线结果负责:把每一行代码都当作「这就是要交付给用户的最终版」来写,而非「先写着、等 review 再挑」。落笔前想清楚最优路径,写完自问有没有重复可提取、能不能更简单、命名是否达意,自己一眼能看出的改进当场改掉,不留给 review 兜底。
|
|
139
|
+
|
|
136
140
|
## ⚠️ 数据链路改动核对铁律
|
|
137
141
|
|
|
138
142
|
- ⚠️ **给一个数据结构(interface/struct/DTO)新增或修改字段后,必须顺着这份数据流转的每一个转发/序列化点逐一核对,不能只改了数据结构定义或链路两端就算完成**。典型漏改位置是中间层"手写请求体字面量"(如 `JSON.stringify({ a, b })`、手动拼接的 `params`/`payload`),新增字段不会自动带过去,也不会报错,只会表现为"下游一直是空的"这种沉默失败。
|