@routerhub/agent-rules 1.5.10 → 1.5.12

package/AGENTS.base.md

@@ -14,11 +14,17 @@
 
 ## 安全
 
-- 未明确授权不操作生产环境（指令需含"生产"/"线上"/"prod"/"production"），操作前二次确认。
+- 用户明确要求上线/部署生产环境时，直接执行，无需二次确认。
+- 执行过程中自行触及生产环境操作（非用户明确要求），必须先向用户二次确认后再执行。
 
 ## 需求文档
 
-- 新需求先在 `docs/` 写 MD 文档，含：目标、范围、功能要求、验收标准。
+- 新需求先在 `docs/` 写文档，含：目标、范围、功能要求、验收标准。
+
+## 文档格式
+
+- 所有新建文档必须使用 HTML 格式（`.html`），禁止使用 Markdown（`.md`）格式。
+- 已有的 `.md` 文件可保留，但新增文档一律使用 HTML。
 
 ## 优先级
 
@@ -80,6 +86,7 @@
 - 用户明确要求由代理自行执行自动化测试时，允许使用无头浏览器进行测试与验证。
 - 写完业务后执行 `pnpm run test:e2e:ui`，告知开发者对应测试用例名称；通过后打开 UI 供手动验证。
 - 端口被占用时自动切换新端口。
+- 自动化测试中，若 Mock 数据不影响业务逻辑验证，优先使用 Mock 数据代替真实接口调用，减少外部依赖和测试不稳定性。
 
 ## 错误日志
 

package/README.md

@@ -12,22 +12,26 @@
 在你的项目里安装：
 
 ```bash
-pnpm add -D concurrently @routerhub/agent-rules
+pnpm add -D @routerhub/agent-rules
 ```
 
-## 使用
-
-修改项目package.json中的scripts中的启动命令，改成类似下面这种，
-
-```json
-{
-  "scripts": {
-    "dev": "concurrently \"next dev\" \"agent-rules watch\""
-  }
-}
-```
-
-作用：
-
-- 监听 `AGENTS.private.md` 变更
-- 变更后自动重新同步 `AGENTS.md` 和 `.github/copilot-instructions.md`
+安装完成后会自动：
+
+1. 生成 `AGENTS.md` 和 `.github/copilot-instructions.md`
+2. 在后台启动 watch 进程，持续监听 `AGENTS.private.md` 变更并自动同步
+
+无需手动执行任何命令，修改 `AGENTS.private.md` 即可自动生效。
+
+> **注意：** 后台 watch 进程在重启电脑后会停止。如需每次启动开发时自动恢复监听，可在 `package.json` 中配合 `concurrently` 使用：
+>
+> ```bash
+> pnpm add -D concurrently
+> ```
+>
+> ```json
+> {
+>   "scripts": {
+>     "dev": "concurrently \"next dev\" \"agent-rules watch\""
+>   }
+> }
+> ```

package/package.json

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