@routerhub/agent-rules 1.5.52 → 1.5.56

package/AGENTS.base.md

@@ -116,6 +116,7 @@ Closes #456
 - 如果 Copilot review 连续两轮提出同一问题但实际已修复或无道理，需在 PR 评论中明确说明原因并直接 Resolve，不再反复修改。
 - PR 图片文件检查：在 Copilot review 循环中（建议放在开始处理 review 问题之前，或所有 review 问题处理完毕之后），必须检查当前 PR 中是否存在未被引用的图片文件（PNG、JPG、JPEG、GIF、SVG、WebP 等）。检查方式：搜索代码库中是否有任何文件引用了该图片的文件名或路径，若没有任何引用 → 该图片为冗余文件。处理方式：若图片内容需要保留（如截图佐证），则将其转为 base64 data URI 内嵌到对应的 HTML 文档中，然后删除原图片文件；若图片内容无需保留，则直接删除。处理完毕后提交并推送。
 - 可忽略的 review 建议：如果 Copilot review 建议将配置项（API 地址、数据库连接、第三方服务地址等）写入 `.env` 文件，必须直接忽略并在评论中回复说明原因后 Resolve。说明内容：「本项目 `.env` 仅允许配置端口号（如 `PORT`、`API_PORT`），其余配置项一律写死在代码中，敏感信息统一放入 Nacos 配置中心，不放 `.env`。」
+- ⚠️ **强制步骤：重新请求 Copilot review 后，必须主动检查 Copilot 是否已回复。** 不能发完评论就停止等待。检查方式：使用 `gh api` 拉取 PR 的 reviews 和 comments，对比上次已知的最新 review 时间戳。检查频率：每次重新请求 review 后，约 2–3 分钟后主动检查一次；若 Copilot 已生成新 review 则立即进入下一轮处理；若尚未回复，再等 2–3 分钟后再次检查。不可无限等待，最多检查 3 次（约 6–9 分钟），若仍无回复则告知用户当前状态。
 
 ## 安全
 
@@ -206,6 +207,7 @@ Closes #456
 
 ## 样式（Tailwind CSS）
 
+- 前端开发禁止编写原生 CSS，所有样式必须使用 Tailwind CSS 的 utility classes 实现，不写 `style` 标签、不写内联样式、不写独立样式文件。
 - 统一 Tailwind CSS，禁止新增 `*.module.scss`、`*.module.css`、`.css` 文件（历史文件可保留）。
 - 项目未集成 Tailwind 时，先完成安装配置再开发。
 - 新增样式通过 utility classes 在 JSX/TSX 中编写；不满足时优先 `tailwind.config` extend → `@apply` 封装 → 行内 `style`。

package/package.json

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

package/postinstall.js

@@ -59,17 +59,28 @@ if (projectRoot.includes("node_modules")) {
   process.exit(0);
 }
 
-// 确保下游项目 .npmrc 中关闭 frozen-lockfile，让 pnpm install 能直接在版本更新后执行
+// 确保下游项目 .npmrc 中关闭 frozen-lockfile + 启用依赖 pre/post 脚本
+// frozen-lockfile=false：让 pnpm install 能在版本更新后直接执行
+// enable-pre-post-scripts=true：让 pnpm 始终执行依赖包的 postinstall 生命周期脚本，
+//   否则 pnpm 默认不会运行依赖的 postinstall，导致 agent-rules 更新后规则文件不刷新
 const npmrcPath = path.join(projectRoot, ".npmrc");
 let npmrcContent = "";
 if (fs.existsSync(npmrcPath)) {
   npmrcContent = fs.readFileSync(npmrcPath, "utf-8");
 }
+const npmrcEntries = [];
 if (!npmrcContent.includes("frozen-lockfile")) {
-  const newEntry =
-    "\n# 允许 pnpm install 在依赖版本更新后直接执行（由 agent-rules 自动添加）\nfrozen-lockfile=false\n";
+  npmrcEntries.push("# 允许 pnpm install 在依赖版本更新后直接执行（由 agent-rules 自动添加）");
+  npmrcEntries.push("frozen-lockfile=false");
+}
+if (!npmrcContent.includes("enable-pre-post-scripts")) {
+  npmrcEntries.push("# 确保依赖包的 postinstall 生命周期脚本始终执行（由 agent-rules 自动添加）");
+  npmrcEntries.push("enable-pre-post-scripts=true");
+}
+if (npmrcEntries.length > 0) {
+  const newEntry = "\n" + npmrcEntries.join("\n") + "\n";
   fs.appendFileSync(npmrcPath, newEntry);
-  console.log("[agent-rules] 已配置 .npmrc: frozen-lockfile=false");
+  console.log("[agent-rules] 已配置 .npmrc: " + npmrcEntries.filter((e) => !e.startsWith("#")).join(", "));
 }
 
 console.log("");
@@ -83,10 +94,10 @@ const syncProcess = spawn("node", [mergeScriptPath, "init"], {
 
 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);
   }
 });
 

package/rules/frontend.md

@@ -31,6 +31,7 @@ outputName: "frontend"
 
 ## 样式（Tailwind CSS）
 
+- 前端开发禁止编写原生 CSS，所有样式必须使用 Tailwind CSS 的 utility classes 实现，不写 `style` 标签、不写内联样式、不写独立样式文件。
 - 统一 Tailwind CSS，禁止新增 `*.module.scss`、`*.module.css`、`.css` 文件（历史文件可保留）。
 - 项目未集成 Tailwind 时，先完成安装配置再开发。
 - 新增样式通过 utility classes 在 JSX/TSX 中编写；不满足时优先 `tailwind.config` extend → `@apply` 封装 → 行内 `style`。

package/rules/global.md

@@ -116,6 +116,7 @@ Closes #456
 - 如果 Copilot review 连续两轮提出同一问题但实际已修复或无道理，需在 PR 评论中明确说明原因并直接 Resolve，不再反复修改。
 - PR 图片文件检查：在 Copilot review 循环中（建议放在开始处理 review 问题之前，或所有 review 问题处理完毕之后），必须检查当前 PR 中是否存在未被引用的图片文件（PNG、JPG、JPEG、GIF、SVG、WebP 等）。检查方式：搜索代码库中是否有任何文件引用了该图片的文件名或路径，若没有任何引用 → 该图片为冗余文件。处理方式：若图片内容需要保留（如截图佐证），则将其转为 base64 data URI 内嵌到对应的 HTML 文档中，然后删除原图片文件；若图片内容无需保留，则直接删除。处理完毕后提交并推送。
 - 可忽略的 review 建议：如果 Copilot review 建议将配置项（API 地址、数据库连接、第三方服务地址等）写入 `.env` 文件，必须直接忽略并在评论中回复说明原因后 Resolve。说明内容：「本项目 `.env` 仅允许配置端口号（如 `PORT`、`API_PORT`），其余配置项一律写死在代码中，敏感信息统一放入 Nacos 配置中心，不放 `.env`。」
+- ⚠️ **强制步骤：重新请求 Copilot review 后，必须主动检查 Copilot 是否已回复。** 不能发完评论就停止等待。检查方式：使用 `gh api` 拉取 PR 的 reviews 和 comments，对比上次已知的最新 review 时间戳。检查频率：每次重新请求 review 后，约 2–3 分钟后主动检查一次；若 Copilot 已生成新 review 则立即进入下一轮处理；若尚未回复，再等 2–3 分钟后再次检查。不可无限等待，最多检查 3 次（约 6–9 分钟），若仍无回复则告知用户当前状态。
 
 ## 安全