@routerhub/agent-rules 1.5.96 → 1.5.97
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 +13 -0
- package/package.json +1 -1
- package/rules/global.md +13 -0
package/AGENTS.base.md
CHANGED
|
@@ -24,6 +24,19 @@
|
|
|
24
24
|
- ⚠️ 严格按用户原话实现需求，禁止擅自添加用户未要求的限制、规则或约束。
|
|
25
25
|
- ⚠️ 不确定某个限制是否必要时，必须先询问用户，禁止直接添加。
|
|
26
26
|
|
|
27
|
+
## ⚠️ 排查与协作铁律
|
|
28
|
+
|
|
29
|
+
- ⚠️ **排查「以前能用、现在不行」类问题时禁止用绕过手段掩盖问题**（改配置屏蔽报错、写同步脚本搬数据、临时禁用校验等），必须先定位根因再修复。
|
|
30
|
+
- ⚠️ **给出多个方案（A/B/C）供选择时，必须等用户明确选定后再执行**，禁止默认执行「推荐方案」。
|
|
31
|
+
- ⚠️ **用户提出模糊的调整要求**（如「再加点间距」「跟上面保持一致」「差不多就行」）时，必须先确认具体参照物和数值，禁止凭感觉直接改。
|
|
32
|
+
- ⚠️ **同一个问题被用户连续纠正两次后，第三次必须停下来问清楚根本原因**，禁止继续「改了又错、错了再改」的循环尝试。
|
|
33
|
+
- ⚠️ **修改多处复用的公共部分**（组件、配置、脚本、样式）后，必须找出所有引用/调用位置逐一验证，禁止只验证当前改动的那一处。
|
|
34
|
+
- ⚠️ **「数值/坐标/结构对齐」类验收，除了程序化校验外，必须额外做一次实际效果验证**（截图、真实访问、人工看一眼），不能只信数值对得上就算完成。
|
|
35
|
+
- ⚠️ **验证功能是否修复时，要用真实存在的数据/路径去测试**，避免用虚构的测试数据得出「失败」的假结论。
|
|
36
|
+
- ⚠️ **定位并修复根因后，必须清理诊断过程中留下的临时改动**（调试代码、临时开关、测试脚本），不要把绕过方案的残留物留在代码里。
|
|
37
|
+
- **某个工具/脚本报错时，先检查是否有残留的锁文件、临时文件、缓存导致的问题**，清理后重试；仍失败再切换备用方案，不要一遇报错就直接换路子。
|
|
38
|
+
- **长任务或涉及截图等大内容的操作，注意控制单次传入的数据量**（压缩、降低分辨率等），避免不必要地占满上下文。
|
|
39
|
+
|
|
27
40
|
## Git 规范
|
|
28
41
|
|
|
29
42
|
- 分支用 Git Flow（`feature/`、`bugfix/`、`hotfix/`、`refactor/`、`chore/`、`docs/`、`test/`），英文小写中划线分隔。
|
package/package.json
CHANGED
package/rules/global.md
CHANGED
|
@@ -24,6 +24,19 @@ name: "通用规则"
|
|
|
24
24
|
- ⚠️ 严格按用户原话实现需求，禁止擅自添加用户未要求的限制、规则或约束。
|
|
25
25
|
- ⚠️ 不确定某个限制是否必要时，必须先询问用户，禁止直接添加。
|
|
26
26
|
|
|
27
|
+
## ⚠️ 排查与协作铁律
|
|
28
|
+
|
|
29
|
+
- ⚠️ **排查「以前能用、现在不行」类问题时禁止用绕过手段掩盖问题**（改配置屏蔽报错、写同步脚本搬数据、临时禁用校验等），必须先定位根因再修复。
|
|
30
|
+
- ⚠️ **给出多个方案（A/B/C）供选择时，必须等用户明确选定后再执行**，禁止默认执行「推荐方案」。
|
|
31
|
+
- ⚠️ **用户提出模糊的调整要求**（如「再加点间距」「跟上面保持一致」「差不多就行」）时，必须先确认具体参照物和数值，禁止凭感觉直接改。
|
|
32
|
+
- ⚠️ **同一个问题被用户连续纠正两次后，第三次必须停下来问清楚根本原因**，禁止继续「改了又错、错了再改」的循环尝试。
|
|
33
|
+
- ⚠️ **修改多处复用的公共部分**（组件、配置、脚本、样式）后，必须找出所有引用/调用位置逐一验证，禁止只验证当前改动的那一处。
|
|
34
|
+
- ⚠️ **「数值/坐标/结构对齐」类验收，除了程序化校验外，必须额外做一次实际效果验证**（截图、真实访问、人工看一眼），不能只信数值对得上就算完成。
|
|
35
|
+
- ⚠️ **验证功能是否修复时，要用真实存在的数据/路径去测试**，避免用虚构的测试数据得出「失败」的假结论。
|
|
36
|
+
- ⚠️ **定位并修复根因后，必须清理诊断过程中留下的临时改动**（调试代码、临时开关、测试脚本），不要把绕过方案的残留物留在代码里。
|
|
37
|
+
- **某个工具/脚本报错时，先检查是否有残留的锁文件、临时文件、缓存导致的问题**，清理后重试；仍失败再切换备用方案，不要一遇报错就直接换路子。
|
|
38
|
+
- **长任务或涉及截图等大内容的操作，注意控制单次传入的数据量**（压缩、降低分辨率等），避免不必要地占满上下文。
|
|
39
|
+
|
|
27
40
|
## Git 规范
|
|
28
41
|
|
|
29
42
|
- 分支用 Git Flow（`feature/`、`bugfix/`、`hotfix/`、`refactor/`、`chore/`、`docs/`、`test/`），英文小写中划线分隔。
|