@routerhub/agent-rules 1.5.121 → 1.5.122
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 +8 -0
- package/CHANGELOG.md +6 -0
- package/package.json +1 -1
- package/rules/global.md +8 -0
package/AGENTS.base.md
CHANGED
|
@@ -45,6 +45,14 @@
|
|
|
45
45
|
- ⚠️ **部署完成的定义 = 脚本执行完 → 功能直接可用 → 期间零人工补操作。** 未满足「零人工补操作」的部署不算完成，禁止在还需手动补步骤时宣称部署完成。
|
|
46
46
|
- ⚠️ **「部署可用」≠「功能已验证」**：部署自动化到位只保证环境就绪、功能直接可操作；功能是否正确，仍需按既有验证铁律用真实数据验证，两者不冲突。
|
|
47
47
|
|
|
48
|
+
## ⚠️ 测试环境功能验证前置铁律（防止缺表报错误判为代码问题）
|
|
49
|
+
|
|
50
|
+
- ⚠️ **在测试环境验证任何涉及新增表/新增字段的功能（如充值、退款、发票，不限于这些）之前，必须先确认数据库表结构已就绪。** 测试环境 AutoMigrate 默认关闭（见「Go 规则」），新表/新字段不会随代码自动创建。跳过这一步直接验证，报出的缺表/缺字段错误是环境问题，不是代码问题，极易误判。
|
|
51
|
+
- ⚠️ **验证前必须显式执行以下任一前置动作，禁止跳过：**
|
|
52
|
+
1. **临时打开 AutoMigrate 开关**，启动/重启服务完成建表后，恢复默认关闭；
|
|
53
|
+
2. **手动执行幂等建表/加字段 SQL**（`CREATE TABLE IF NOT EXISTS` / `ALTER TABLE ... ADD COLUMN IF NOT EXISTS`），并确认目标表/字段已存在。
|
|
54
|
+
- ⚠️ **遇到缺表/缺字段类报错时，第一优先级检查表结构是否就绪，禁止直接定性为代码 bug。** 特征报错：`relation "..." does not exist`、`table ... does not exist`、`column ... does not exist`、`Unknown column`、`Unrecognized name` 等。先查表（`\d 表名` / `DESCRIBE` / `information_schema`）确认就绪后再排查代码。
|
|
55
|
+
|
|
48
56
|
## ⚠️ 排查与协作铁律
|
|
49
57
|
|
|
50
58
|
- ⚠️ **排查「以前能用、现在不行」类问题时禁止用绕过手段掩盖问题**（改配置屏蔽报错、写同步脚本搬数据、临时禁用校验等），必须先定位根因再修复。
|
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,12 @@
|
|
|
2
2
|
|
|
3
3
|
所有对 @routerhub/agent-rules 的重大更改都会记录在这个文件中。
|
|
4
4
|
|
|
5
|
+
## [1.5.122] - 2026-08-11
|
|
6
|
+
|
|
7
|
+
### Added
|
|
8
|
+
|
|
9
|
+
- 新增「测试环境功能验证前置铁律」（防止缺表报错误判为代码问题）：在测试环境验证任何涉及新增表/新增字段的功能（如充值、退款、发票，不限于这些）之前，必须先确认数据库表结构已就绪。原因：测试环境 AutoMigrate 默认关闭（见「Go 规则」），新表/新字段不会随代码自动创建，跳过前置检查直接验证，报出的缺表/缺字段错误是环境问题而非代码问题，极易误判。验证前必须显式二选一：① 临时打开 AutoMigrate 开关（用后恢复默认关闭）② 手动执行幂等建表/加字段 SQL（`CREATE TABLE IF NOT EXISTS` / `ALTER TABLE ... ADD COLUMN IF NOT EXISTS`）；遇到缺表/缺字段类报错（`relation ... does not exist`、`column ... does not exist`、`Unrecognized name` 等）时，第一优先级检查表结构是否就绪，禁止直接定性为代码 bug。
|
|
10
|
+
|
|
5
11
|
## [1.5.121] - 2026-08-10
|
|
6
12
|
|
|
7
13
|
### Added
|
package/package.json
CHANGED
package/rules/global.md
CHANGED
|
@@ -45,6 +45,14 @@ name: "通用规则"
|
|
|
45
45
|
- ⚠️ **部署完成的定义 = 脚本执行完 → 功能直接可用 → 期间零人工补操作。** 未满足「零人工补操作」的部署不算完成，禁止在还需手动补步骤时宣称部署完成。
|
|
46
46
|
- ⚠️ **「部署可用」≠「功能已验证」**：部署自动化到位只保证环境就绪、功能直接可操作；功能是否正确，仍需按既有验证铁律用真实数据验证，两者不冲突。
|
|
47
47
|
|
|
48
|
+
## ⚠️ 测试环境功能验证前置铁律（防止缺表报错误判为代码问题）
|
|
49
|
+
|
|
50
|
+
- ⚠️ **在测试环境验证任何涉及新增表/新增字段的功能（如充值、退款、发票，不限于这些）之前，必须先确认数据库表结构已就绪。** 测试环境 AutoMigrate 默认关闭（见「Go 规则」），新表/新字段不会随代码自动创建。跳过这一步直接验证，报出的缺表/缺字段错误是环境问题，不是代码问题，极易误判。
|
|
51
|
+
- ⚠️ **验证前必须显式执行以下任一前置动作，禁止跳过：**
|
|
52
|
+
1. **临时打开 AutoMigrate 开关**，启动/重启服务完成建表后，恢复默认关闭；
|
|
53
|
+
2. **手动执行幂等建表/加字段 SQL**（`CREATE TABLE IF NOT EXISTS` / `ALTER TABLE ... ADD COLUMN IF NOT EXISTS`），并确认目标表/字段已存在。
|
|
54
|
+
- ⚠️ **遇到缺表/缺字段类报错时，第一优先级检查表结构是否就绪，禁止直接定性为代码 bug。** 特征报错：`relation "..." does not exist`、`table ... does not exist`、`column ... does not exist`、`Unknown column`、`Unrecognized name` 等。先查表（`\d 表名` / `DESCRIBE` / `information_schema`）确认就绪后再排查代码。
|
|
55
|
+
|
|
48
56
|
## ⚠️ 排查与协作铁律
|
|
49
57
|
|
|
50
58
|
- ⚠️ **排查「以前能用、现在不行」类问题时禁止用绕过手段掩盖问题**（改配置屏蔽报错、写同步脚本搬数据、临时禁用校验等），必须先定位根因再修复。
|