@routerhub/agent-rules 1.5.88 → 1.5.90
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 +14 -1
- package/package.json +1 -1
- package/rules/devops.md +6 -0
- package/rules/global.md +8 -1
- package/skills/deploy-test/SKILL.md +6 -0
package/AGENTS.base.md
CHANGED
|
@@ -9,6 +9,10 @@
|
|
|
9
9
|
## ⚠️ 规则修改入口
|
|
10
10
|
|
|
11
11
|
- **新增、修改、删除规则，必须改 `AGENTS.base.md`（源文件），禁止直接改 `CLAUDE.md` 或 `AGENTS.md`**。改完后必须执行 `node merge.js sync` 重新生成输出文件。
|
|
12
|
+
- ⚠️ **新增行为/指令时，先判断该放规则还是 Skill**：
|
|
13
|
+
- **规则（Rule）**：始终生效的约束，如代码风格、命名规范、行为要求、注释规范。写入 `AGENTS.base.md`。
|
|
14
|
+
- **Skill**：多步骤操作流程，需按需调用，如部署、发 PR、Figma 还原、TDD 流程。新建 `skills/技能名/SKILL.md`。
|
|
15
|
+
- **判断标准**：「这件事每次写代码都要遵守吗？」→ 是 = 规则，否（只有特定场景才触发）= Skill。
|
|
12
16
|
|
|
13
17
|
## 语言与内容
|
|
14
18
|
|
|
@@ -41,6 +45,7 @@
|
|
|
41
45
|
- 禁止重复实现，发现重复必须提取封装。同一数据/配置只在一处维护。禁止硬编码数字。
|
|
42
46
|
- 前端：Tailwind CSS 禁止原生 CSS，尺寸单位必须 `rem` 禁止 `px`（1rem=16px）。
|
|
43
47
|
- 测试描述、断言使用中文。测试用例先主流程再边界情况。
|
|
48
|
+
- ⚠️ 代码中出现晦涩难懂的技术名词（如 X-Request-ID、反向代理、CORS、JWT、CSRF、幂等、熔断、降级等）时，必须附加中文注解。注解分两层：（1）先说明该名词是什么功能、解决什么问题；（2）再解释其中特殊因子/字段的具体作用。目的是让不熟悉该领域的人也能看懂代码逻辑，不要求已有背景知识。
|
|
44
49
|
|
|
45
50
|
## Go 规则
|
|
46
51
|
|
|
@@ -56,7 +61,9 @@
|
|
|
56
61
|
|
|
57
62
|
## 部署规则
|
|
58
63
|
|
|
59
|
-
- 发版统一执行 `./release.sh
|
|
64
|
+
- 发版统一执行 `./release.sh`。
|
|
65
|
+
- ⚠️ 部署测试环境必须使用 `/deploy-test` skill。任何包含「部署测试」「发布测试」「上线测试」「部署test」「推到test」「部署到测试环境」等表述的需求，必须先调用 `Skill` 工具加载 `deploy-test`，严禁跳过 skill 直接执行部署操作。
|
|
66
|
+
- ⚠️ 部署测试环境的正确流程是：当前分支 → 合并到 test 分支 → 推送 test → 触发部署 → 切回原分支。禁止直接在 test 分支上提交代码，禁止跳过合并步骤直接部署功能分支。
|
|
60
67
|
|
|
61
68
|
## 文档规则
|
|
62
69
|
|
|
@@ -94,3 +101,9 @@
|
|
|
94
101
|
## 部署规则
|
|
95
102
|
|
|
96
103
|
<!-- 部署特有规则在此添加 -->
|
|
104
|
+
|
|
105
|
+
### 🚨 测试环境部署铁律（不可跳过）
|
|
106
|
+
|
|
107
|
+
- ⚠️ **部署到测试环境唯一入口：`/deploy-test` skill。** 不论用户怎么表述（「部署测试」「帮我部署」「推到test」「发布测试环境」等），必须通过 `Skill` 工具调用 `deploy-test`，禁止凭记忆手动执行 git 命令。
|
|
108
|
+
- ⚠️ **必须先合并再部署**：流程必须是 `当前功能分支 → merge 到 test → push test → 触发部署 → 切回原分支`。严禁跳过 merge 步骤直接部署功能分支。
|
|
109
|
+
- ⚠️ **部署完成后必须切回原分支**，不得停留在 test 分支。
|
package/package.json
CHANGED
package/rules/devops.md
CHANGED
|
@@ -7,3 +7,9 @@ outputName: "devops"
|
|
|
7
7
|
## 部署规则
|
|
8
8
|
|
|
9
9
|
<!-- 部署特有规则在此添加 -->
|
|
10
|
+
|
|
11
|
+
### 🚨 测试环境部署铁律（不可跳过）
|
|
12
|
+
|
|
13
|
+
- ⚠️ **部署到测试环境唯一入口：`/deploy-test` skill。** 不论用户怎么表述（「部署测试」「帮我部署」「推到test」「发布测试环境」等），必须通过 `Skill` 工具调用 `deploy-test`，禁止凭记忆手动执行 git 命令。
|
|
14
|
+
- ⚠️ **必须先合并再部署**：流程必须是 `当前功能分支 → merge 到 test → push test → 触发部署 → 切回原分支`。严禁跳过 merge 步骤直接部署功能分支。
|
|
15
|
+
- ⚠️ **部署完成后必须切回原分支**，不得停留在 test 分支。
|
package/rules/global.md
CHANGED
|
@@ -9,6 +9,10 @@ name: "通用规则"
|
|
|
9
9
|
## ⚠️ 规则修改入口
|
|
10
10
|
|
|
11
11
|
- **新增、修改、删除规则，必须改 `AGENTS.base.md`（源文件），禁止直接改 `CLAUDE.md` 或 `AGENTS.md`**。改完后必须执行 `node merge.js sync` 重新生成输出文件。
|
|
12
|
+
- ⚠️ **新增行为/指令时，先判断该放规则还是 Skill**：
|
|
13
|
+
- **规则（Rule）**：始终生效的约束，如代码风格、命名规范、行为要求、注释规范。写入 `AGENTS.base.md`。
|
|
14
|
+
- **Skill**：多步骤操作流程，需按需调用，如部署、发 PR、Figma 还原、TDD 流程。新建 `skills/技能名/SKILL.md`。
|
|
15
|
+
- **判断标准**：「这件事每次写代码都要遵守吗？」→ 是 = 规则，否（只有特定场景才触发）= Skill。
|
|
12
16
|
|
|
13
17
|
## 语言与内容
|
|
14
18
|
|
|
@@ -41,6 +45,7 @@ name: "通用规则"
|
|
|
41
45
|
- 禁止重复实现，发现重复必须提取封装。同一数据/配置只在一处维护。禁止硬编码数字。
|
|
42
46
|
- 前端：Tailwind CSS 禁止原生 CSS，尺寸单位必须 `rem` 禁止 `px`（1rem=16px）。
|
|
43
47
|
- 测试描述、断言使用中文。测试用例先主流程再边界情况。
|
|
48
|
+
- ⚠️ 代码中出现晦涩难懂的技术名词（如 X-Request-ID、反向代理、CORS、JWT、CSRF、幂等、熔断、降级等）时，必须附加中文注解。注解分两层：（1）先说明该名词是什么功能、解决什么问题；（2）再解释其中特殊因子/字段的具体作用。目的是让不熟悉该领域的人也能看懂代码逻辑，不要求已有背景知识。
|
|
44
49
|
|
|
45
50
|
## Go 规则
|
|
46
51
|
|
|
@@ -56,7 +61,9 @@ name: "通用规则"
|
|
|
56
61
|
|
|
57
62
|
## 部署规则
|
|
58
63
|
|
|
59
|
-
- 发版统一执行 `./release.sh
|
|
64
|
+
- 发版统一执行 `./release.sh`。
|
|
65
|
+
- ⚠️ 部署测试环境必须使用 `/deploy-test` skill。任何包含「部署测试」「发布测试」「上线测试」「部署test」「推到test」「部署到测试环境」等表述的需求，必须先调用 `Skill` 工具加载 `deploy-test`，严禁跳过 skill 直接执行部署操作。
|
|
66
|
+
- ⚠️ 部署测试环境的正确流程是：当前分支 → 合并到 test 分支 → 推送 test → 触发部署 → 切回原分支。禁止直接在 test 分支上提交代码，禁止跳过合并步骤直接部署功能分支。
|
|
60
67
|
|
|
61
68
|
## 文档规则
|
|
62
69
|
|
|
@@ -15,6 +15,12 @@ description: >-
|
|
|
15
15
|
|
|
16
16
|
将当前功能分支部署到测试环境，完成后自动切回原分支。
|
|
17
17
|
|
|
18
|
+
## 🚨 铁律（违反即错误）
|
|
19
|
+
|
|
20
|
+
- ⚠️ 部署测试环境**唯一正确流程**：当前功能分支 → 合并到 test → 推送 test → 触发部署 → 切回原分支。
|
|
21
|
+
- ⚠️ **绝对禁止**跳过合并步骤、直接在功能分支上部署、或往 test 分支直接提交代码。
|
|
22
|
+
- ⚠️ 每一步必须执行完毕并确认成功后才能进入下一步，不可并行或跳过。
|
|
23
|
+
|
|
18
24
|
## 核心流程
|
|
19
25
|
|
|
20
26
|
### 1. 记录当前分支
|