@routerhub/agent-rules 1.5.45 → 1.5.46

package/README.md

@@ -18,6 +18,14 @@ pnpm i -D @routerhub/agent-rules
 
 写完 `AGENTS.private.md` 后，工具会自动生成项目可用的 `AGENTS.md` 和 `.github/copilot-instructions.md`。
 
+首次执行 `pnpm i -D @routerhub/agent-rules` 时，会自动执行初始化：
+
+- 自动生成 `AGENTS.md`
+- 自动生成 `CLAUDE.md`
+- 自动生成 `.github/copilot-instructions.md`
+- 自动生成 `.github/instructions/*.instructions.md`
+- 如果当前项目还没有 `AGENTS.private.md`，会自动创建模板文件
+
 ## 更新
 
 当 `@routerhub/agent-rules` 有新版本时，锁文件不会自动追最新，需要手动更新：
@@ -32,4 +40,10 @@ pnpm update @routerhub/agent-rules --latest
 
 ---
 
-注意：pnpm i 的时候会启动一个watch函数自动帮你合并AGENTS.privite.md中的内容到AGENTS.md，所以建议给项目配置一键启动脚本来，一键启动脚本里加上先pnpm i然后再启动每个项目
+注意：`pnpm i` 只会自动执行一次初始化或同步，不会常驻启动 watch。
+
+如果你希望修改 `AGENTS.private.md` 后自动重新生成规则文件，需要手动执行：
+
+```bash
+pnpm exec agent-rules watch
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@routerhub/agent-rules",
-  "version": "1.5.45",
+  "version": "1.5.46",
   "description": "Shared Copilot agent rules and guidelines for RouterHub projects",
   "main": "AGENTS.base.md",
   "bin": {
@@ -19,6 +19,7 @@
   ],
   "scripts": {
     "build": "node --check merge.js && node --check postinstall.js",
+    "test:postinstall-init": "node tests/postinstall-init.test.js",
     "merge": "node merge.js",
     "sync": "node merge.js sync",
     "init": "node merge.js init",

package/postinstall.js

@@ -72,23 +72,23 @@ if (!npmrcContent.includes("frozen-lockfile")) {
 }
 
 console.log("");
-console.log("[agent-rules] 安装完成，正在同步规则文件...");
+console.log("[agent-rules] 安装完成，正在初始化规则文件...");
 
-// 执行 sync 生成所有规则输出文件
-const syncProcess = spawn("node", [mergeScriptPath, "sync"], {
+// 执行 init，首次安装时自动补齐 AGENTS.private.md 模板并生成规则输出文件
+const syncProcess = spawn("node", [mergeScriptPath, "init"], {
   cwd: projectRoot,
   stdio: "inherit",
 });
 
 syncProcess.on("close", (code) => {
   if (code === 0) {
-    console.log("[agent-rules] 规则文件同步完成");
+    console.log("[agent-rules] 规则文件初始化完成");
     console.log("");
   } else {
-    console.error("[agent-rules] 同步失败，退出码:", code);
+    console.error("[agent-rules] 初始化失败，退出码:", code);
   }
 });
 
 syncProcess.on("error", (err) => {
-  console.error("[agent-rules] 同步过程出错:", err.message);
+  console.error("[agent-rules] 初始化过程出错:", err.message);
 });