@routerhub/agent-rules 1.4.1 → 1.4.3

package/AGENTS.base.md

@@ -45,9 +45,18 @@
 - 若用户指令中没有上述关键词，默认只在本地或测试/开发环境中执行操作，不得擅自连接或操作生产服务器。
 - 执行生产环境操作前，必须再次向用户确认目标环境，确认无误后方可执行。
 
-## 分支管理规范
-
-- 所有新建分支名称必须使用中文（汉字）或纯中文拼音，禁止英文缩写、数字、拼音与英文混用。
+## 分支管理规范（Git Flow）
+
+- 所有新建分支必须遵循 Git Flow 命名规范，使用以下前缀：
+  - `feature/` - 新功能开发（如 `feature/user-authentication`）
+  - `refactor/` - 代码重构（如 `refactor/payment-module`）
+  - `bugfix/` - 缺陷修复（如 `bugfix/order-calculation`）
+  - `hotfix/` - 紧急生产修复（如 `hotfix/critical-security-issue`）
+  - `chore/` - 杂项维护（如 `chore/upgrade-dependencies`）
+  - `docs/` - 文档更新（如 `docs/api-reference`）
+  - `test/` - 测试相关（如 `test/add-unit-tests`）
+- 分支名称使用英文，单词间用中划线（-）分隔，全小写，简洁明了。
+- 禁止使用下划线、大写字母、中文或特殊字符。
 - 当用户要求提交本次修改时，git commit 提交信息必须使用中文描述，禁止使用英文。
 
 ## 代码风格与结构

package/package.json

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

package/postinstall.js

@@ -1,9 +1,53 @@
 #!/usr/bin/env node
 
-console.log('')
-console.log('[agent-rules] 安装完成')
-console.log('[agent-rules] 下一步执行: npx agent-rules')
-console.log('[agent-rules] 或显式初始化: npx agent-rules init')
-console.log('[agent-rules] 以后同步规则: npx agent-rules sync')
-console.log('[agent-rules] 查看帮助: npx agent-rules help')
-console.log('')
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// 获取当前工作目录（下游项目根目录）
+const projectRoot = process.cwd();
+const packageRoot = __dirname;
+const mergeScriptPath = path.join(packageRoot, 'merge.js');
+
+console.log('');
+console.log('[agent-rules] 安装完成');
+console.log('[agent-rules] 正在初始化规则文件...');
+
+// 第一步：执行初始化，生成 AGENTS.md 和 .github/copilot-instructions.md
+const initProcess = spawn('node', [mergeScriptPath, 'init'], {
+  cwd: projectRoot,
+  stdio: 'inherit',
+});
+
+initProcess.on('close', (code) => {
+  if (code === 0) {
+    console.log('[agent-rules] 规则文件初始化完成');
+    console.log('[agent-rules] 正在启动后台监听进程...');
+
+    // 第二步：在后台启动 watch 模式
+    const watchProcess = spawn('node', [mergeScriptPath, 'watch'], {
+      cwd: projectRoot,
+      detached: true,
+      stdio: 'ignore',
+    });
+
+    // 将 watch 进程从父进程分离，允许其独立运行
+    watchProcess.unref();
+
+    console.log('[agent-rules] 后台监听进程已启动');
+    console.log('[agent-rules] AGENTS.private.md 的变更将自动同步到 AGENTS.md 和 .github/copilot-instructions.md');
+    console.log('');
+    console.log('[agent-rules] 手动命令：');
+    console.log('  - 初始化:     npx agent-rules init');
+    console.log('  - 同步规则:   npx agent-rules sync');
+    console.log('  - 启动监听:   npx agent-rules watch');
+    console.log('  - 查看帮助:   npx agent-rules help');
+    console.log('');
+  } else {
+    console.error('[agent-rules] 初始化失败，退出码:', code);
+  }
+});
+
+initProcess.on('error', (err) => {
+  console.error('[agent-rules] 初始化过程出错:', err.message);
+});