@routerhub/agent-rules 1.5.61 → 1.5.62

package/AGENTS.base.md

@@ -328,3 +328,15 @@ function FieldTooltip({ text }: { text: string }) {
 	  - **依赖更新**：涉及新的系统依赖（如新的中间件、新的外部服务地址、新的环境变量等）时，必须在部署脚本中自动检查依赖可用性，不存在时部署失败并明确报错，禁止静默跳过等人工发现。
 	  - **缓存/队列/索引重建**：涉及 Redis 缓存结构变更、消息队列 topic 新增、ES 索引 mapping 变更等，必须脚本化并自动执行。
 	  - 以上所有自动化脚本必须在 PR 的 Test Plan 中明确写出执行时机（部署前/部署中/部署后）、执行方式和验证方法，不得只写"部署后手动执行"。
+
+## 用户通知
+
+- ⚠️ **强制要求：任务完成或需要用户决策时，必须弹出 macOS 对话框提醒用户，不得静默结束。**
+- 通知场景：任务完成（代码写完、PR 创建、部署完成等）、需要用户决策（等待审批、需要确认、需要输入等）。
+- 通知方式（动态取当前工作目录，适配任意项目）：
+  ```bash
+  osascript -e 'display dialog "消息内容" with title "Claude Code" buttons {"按钮文字"} default button 1 with icon note' && code "$(pwd)" --reuse-window
+  ```
+- 对话框不得自动消失（不加 `giving up after` 参数），必须等用户手动点击。
+- `$(pwd)` 动态取当前会话的工作目录，确保多项目场景下点击按钮后能跳转到正确的 VS Code 窗口。
+- 按钮文字需清晰表明操作（如「收到 👌」「去看看 👀」等）。

package/package.json

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

package/rules/devops.md

@@ -21,3 +21,15 @@ outputName: "devops"
 	  - **依赖更新**：涉及新的系统依赖（如新的中间件、新的外部服务地址、新的环境变量等）时，必须在部署脚本中自动检查依赖可用性，不存在时部署失败并明确报错，禁止静默跳过等人工发现。
 	  - **缓存/队列/索引重建**：涉及 Redis 缓存结构变更、消息队列 topic 新增、ES 索引 mapping 变更等，必须脚本化并自动执行。
 	  - 以上所有自动化脚本必须在 PR 的 Test Plan 中明确写出执行时机（部署前/部署中/部署后）、执行方式和验证方法，不得只写"部署后手动执行"。
+
+## 用户通知
+
+- ⚠️ **强制要求：任务完成或需要用户决策时，必须弹出 macOS 对话框提醒用户，不得静默结束。**
+- 通知场景：任务完成（代码写完、PR 创建、部署完成等）、需要用户决策（等待审批、需要确认、需要输入等）。
+- 通知方式（动态取当前工作目录，适配任意项目）：
+  ```bash
+  osascript -e 'display dialog "消息内容" with title "Claude Code" buttons {"按钮文字"} default button 1 with icon note' && code "$(pwd)" --reuse-window
+  ```
+- 对话框不得自动消失（不加 `giving up after` 参数），必须等用户手动点击。
+- `$(pwd)` 动态取当前会话的工作目录，确保多项目场景下点击按钮后能跳转到正确的 VS Code 窗口。
+- 按钮文字需清晰表明操作（如「收到 👌」「去看看 👀」等）。