@routerhub/agent-rules 1.5.89 → 1.5.90

package/AGENTS.base.md

@@ -9,6 +9,10 @@
 ## ⚠️ 规则修改入口
 
 - **新增、修改、删除规则，必须改 `AGENTS.base.md`（源文件），禁止直接改 `CLAUDE.md` 或 `AGENTS.md`**。改完后必须执行 `node merge.js sync` 重新生成输出文件。
+- ⚠️ **新增行为/指令时，先判断该放规则还是 Skill**：
+  - **规则（Rule）**：始终生效的约束，如代码风格、命名规范、行为要求、注释规范。写入 `AGENTS.base.md`。
+  - **Skill**：多步骤操作流程，需按需调用，如部署、发 PR、Figma 还原、TDD 流程。新建 `skills/技能名/SKILL.md`。
+  - **判断标准**：「这件事每次写代码都要遵守吗？」→ 是 = 规则，否（只有特定场景才触发）= Skill。
 
 ## 语言与内容
 
@@ -41,6 +45,7 @@
 - 禁止重复实现，发现重复必须提取封装。同一数据/配置只在一处维护。禁止硬编码数字。
 - 前端：Tailwind CSS 禁止原生 CSS，尺寸单位必须 `rem` 禁止 `px`（1rem=16px）。
 - 测试描述、断言使用中文。测试用例先主流程再边界情况。
+- ⚠️ 代码中出现晦涩难懂的技术名词（如 X-Request-ID、反向代理、CORS、JWT、CSRF、幂等、熔断、降级等）时，必须附加中文注解。注解分两层：（1）先说明该名词是什么功能、解决什么问题；（2）再解释其中特殊因子/字段的具体作用。目的是让不熟悉该领域的人也能看懂代码逻辑，不要求已有背景知识。
 
 ## Go 规则
 

package/package.json

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

package/rules/global.md

@@ -9,6 +9,10 @@ name: "通用规则"
 ## ⚠️ 规则修改入口
 
 - **新增、修改、删除规则，必须改 `AGENTS.base.md`（源文件），禁止直接改 `CLAUDE.md` 或 `AGENTS.md`**。改完后必须执行 `node merge.js sync` 重新生成输出文件。
+- ⚠️ **新增行为/指令时，先判断该放规则还是 Skill**：
+  - **规则（Rule）**：始终生效的约束，如代码风格、命名规范、行为要求、注释规范。写入 `AGENTS.base.md`。
+  - **Skill**：多步骤操作流程，需按需调用，如部署、发 PR、Figma 还原、TDD 流程。新建 `skills/技能名/SKILL.md`。
+  - **判断标准**：「这件事每次写代码都要遵守吗？」→ 是 = 规则，否（只有特定场景才触发）= Skill。
 
 ## 语言与内容
 
@@ -41,6 +45,7 @@ name: "通用规则"
 - 禁止重复实现，发现重复必须提取封装。同一数据/配置只在一处维护。禁止硬编码数字。
 - 前端：Tailwind CSS 禁止原生 CSS，尺寸单位必须 `rem` 禁止 `px`（1rem=16px）。
 - 测试描述、断言使用中文。测试用例先主流程再边界情况。
+- ⚠️ 代码中出现晦涩难懂的技术名词（如 X-Request-ID、反向代理、CORS、JWT、CSRF、幂等、熔断、降级等）时，必须附加中文注解。注解分两层：（1）先说明该名词是什么功能、解决什么问题；（2）再解释其中特殊因子/字段的具体作用。目的是让不熟悉该领域的人也能看懂代码逻辑，不要求已有背景知识。
 
 ## Go 规则