@routerhub/agent-rules 1.5.26 → 1.5.28

package/AGENTS.base.md

@@ -143,6 +143,7 @@ Closes #456
 - 当用户要求截图时，必须截取整页（full page），不得只截可视区域。
 - 截图结果必须包含当前页面 URL（地址栏可见或在截图说明中明确写出完整 URL）。
 - 在截图上添加箭头、标注、提示文字等注释时，必须放在页面空白区域，不得覆盖页面原有内容（文字、按钮、表格数据等）。
+- 当用户要求生成 HTML 页面并同时要求截图时，所有截图必须以 base64 data URI 形式内嵌到 HTML 文件中，禁止将截图单独输出为独立的 PNG、JPG、JPEG、SVG、WebP 等图片文件。他人只需打开单个 HTML 文件即可看到完整页面内容和截图，无需额外图片文件。
 
 ## 可视化汇报
 

package/merge.js

@@ -13,6 +13,7 @@
  *
  * 输出文件：
  *   AGENTS.md                                    全量合并（兼容 Cursor/Claude Code）
+ *   CLAUDE.md                                    全量合并（Claude Code 自动加载）
  *   .github/copilot-instructions.md              全局规则（VS Code Copilot）
  *   .github/instructions/*.instructions.md       按域条件加载（VS Code Copilot applyTo）
  *   .github/PULL_REQUEST_TEMPLATE.md             统一 PR 模板（GitHub 新建 PR 时预填）
@@ -31,6 +32,7 @@ let pendingSync = false;
 function getDefaultConfig() {
   return {
     output: path.join(currentRoot, "AGENTS.md"),
+    claudeOutput: path.join(currentRoot, "CLAUDE.md"),
     copilotOutput: path.join(currentRoot, ".github", "copilot-instructions.md"),
     instructionsDir: path.join(currentRoot, ".github", "instructions"),
     rulesDir: path.join(packageRoot, "rules"),
@@ -353,6 +355,7 @@ function mergeAgents(config) {
   } = config;
 
   const agentsOutput = config.output || defaultConfig.output;
+  const claudeOutput = config.claudeOutput || defaultConfig.claudeOutput;
   const copilotOutput = config.copilotOutput || defaultConfig.copilotOutput;
 
   console.log("📦 开始合并规则文件...");
@@ -386,7 +389,7 @@ function mergeAgents(config) {
         privateRules;
     }
 
-    for (const outputPath of [agentsOutput, copilotOutput]) {
+    for (const outputPath of [agentsOutput, claudeOutput, copilotOutput]) {
       ensureParentDir(outputPath);
       fs.writeFileSync(outputPath, merged, "utf-8");
       console.log(`✅ 规则已合并到 ${outputPath}`);
@@ -449,6 +452,11 @@ function mergeAgents(config) {
   ensureParentDir(agentsOutput);
   fs.writeFileSync(agentsOutput, agentsMerged, "utf-8");
   console.log(`✅ 全量规则已合并到 ${agentsOutput}`);
+
+  // CLAUDE.md 与 AGENTS.md 内容一致，供 Claude Code 会话自动加载
+  ensureParentDir(claudeOutput);
+  fs.writeFileSync(claudeOutput, agentsMerged, "utf-8");
+  console.log(`✅ 全量规则已合并到 ${claudeOutput}`);
 }
 
 function initAgents() {
@@ -467,6 +475,7 @@ function initAgents() {
 
   console.log("✅ 初始化完成，后续执行 agent-rules sync 即可刷新规则文件");
   console.log("   输出文件:");
+  console.log("   - CLAUDE.md（全量，Claude Code 会话自动加载）");
   console.log("   - AGENTS.md（全量，兼容 Cursor/Claude Code）");
   console.log("   - .github/copilot-instructions.md（全局规则）");
   console.log("   - .github/instructions/*.instructions.md（按域条件加载）");
@@ -567,7 +576,7 @@ function main() {
       "  agent-rules init   初始化规则文件，并在缺失时创建 AGENTS.private.md 模板",
     );
     console.log(
-      "  agent-rules sync   重新生成所有规则输出文件（AGENTS.md + copilot-instructions.md + instructions/*.instructions.md）",
+      "  agent-rules sync   重新生成所有规则输出文件（CLAUDE.md + AGENTS.md + copilot-instructions.md + instructions/*.instructions.md）",
     );
     console.log(
       "  agent-rules watch  监听 AGENTS.private.md，变更后自动同步所有规则文件",
@@ -575,6 +584,9 @@ function main() {
     console.log("  agent-rules help   查看帮助");
     console.log("");
     console.log("输出文件:");
+    console.log(
+      "  CLAUDE.md                                    全量合并（Claude Code 会话自动加载）",
+    );
     console.log(
       "  AGENTS.md                                    全量合并（兼容 Cursor/Claude Code）",
     );

package/package.json

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

package/rules/devops.md

@@ -4,10 +4,6 @@ applyTo: ["**/Dockerfile","**/Dockerfile.*","**/docker-compose*.yml","**/docker-
 outputName: "devops"
 ---
 
-## Docker 与部署
+## 部署规则
 
-- 默认本地 `docker build`，构建后 `docker push` 到 `ghcr.io`，推送前确保正确 tag。
-- 部署时打包镜像必须统一使用当前 git 提交的 hash 作为镜像 tag 和版本号；项目内所有服务/镜像都必须使用同一个值，无论该镜像是否有代码改动，确保所有镜像版本号一致后再发版。
-- 部署通过 Portainer 管理界面操作，禁止 SSH 手动执行 docker 命令；地址和账号配置在 `AGENTS.private.md` 或环境变量中，禁止硬编码。
-- 始终通过 Portainer API 更新 Stack 环境变量触发重新部署，不要 SSH 手动操作 Portainer 管理的容器。
-- 测试环境和生产环境都通过 Portainer 部署，严禁 SSH 手动操作。测试环境是 Edge Agent（endpoint 7, stack 31），tunnel 按需建立、空闲自动断开，调 API 前必须先请求 `/endpoints/7/docker/info` 预热 tunnel；推荐直接用 `python3 portainer-update-stack.py <VERSION>` 部署（内置 tunnel 预热 + 重试）。生产环境是 Docker API（endpoint 8, stack 26），`APP_VERSION` 三服务共用。
+- 部署方式因项目而异，具体部署规则请在项目 `AGENTS.private.md` 中按需定义。

package/rules/global.md

@@ -25,6 +25,7 @@ name: "通用规则"
 - PR Title 示例：`[auth] Fix token refresh race condition on concurrent requests`、`[payments] Add idempotency key to charge API`、`[infra] Migrate cache layer from Redis 6 to Redis 7`。
 - PR Title 禁止使用 `fix bug`、`update code`、`改了一下` 等无法表达实际改动的标题。
 - PR Description 必须足够充分，至少回答 What（改了什么）、Why（为什么改，解决什么问题或满足什么需求）、How（采用什么方案，为什么选该方案）。
+- PR Description 必须使用中文编写，方便团队成员阅读理解；涉及 UI 改动、交互流程、页面效果等可视化变更时，必须附上截图或录屏作为证据。
 - PR Description 和 Test Plan 的文字应尽可能简洁明了，优先用页面操作路径、按钮点击、表单输入、可见结果描述验证过程；尽量少用代码片段解释，除非代码是理解变更或复现问题的必要证据。
 - 涉及行为变更、接口变更、数据迁移、性能影响时，必须在 Description 中显式写出。
 - 有意不做的事、已知局限、后续 follow-up 必须写清楚，避免 reviewer 重复追问。
@@ -142,6 +143,7 @@ Closes #456
 - 当用户要求截图时，必须截取整页（full page），不得只截可视区域。
 - 截图结果必须包含当前页面 URL（地址栏可见或在截图说明中明确写出完整 URL）。
 - 在截图上添加箭头、标注、提示文字等注释时，必须放在页面空白区域，不得覆盖页面原有内容（文字、按钮、表格数据等）。
+- 当用户要求生成 HTML 页面并同时要求截图时，所有截图必须以 base64 data URI 形式内嵌到 HTML 文件中，禁止将截图单独输出为独立的 PNG、JPG、JPEG、SVG、WebP 等图片文件。他人只需打开单个 HTML 文件即可看到完整页面内容和截图，无需额外图片文件。
 
 ## 可视化汇报