npm - @routerhub/agent-rules - Versions diffs - 1.5.101 → 1.5.102 - Mend

@routerhub/agent-rules 1.5.101 → 1.5.102

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/AGENTS.base.md CHANGED Viewed

@@ -49,6 +49,8 @@
 - ⚠️ PR Title / Description / Test Plan 全部中文。一个 PR 只做一件事。
 - ⚠️ 必须附截图作为可视化证据（前后对比、标注改动区域）。
+- ⚠️ **截图必须直接内嵌在 PR Description 中，让 reviewer 打开 PR 就能看到效果图（`![](CDN_URL)` 方式渲染为可见图片），禁止只在文字里描述"改动了什么"而不放图，也禁止把截图只作为文件附件/提交到分支目录而不在 PR 正文中引用。** 原因：reviewer 看 PR 的第一眼就是看描述，如果看不到图、只能读文字，完全无法直观感知改动效果；截图不内嵌 = 等于没附。
+- ⚠️ **截图必须通过 PR Description 编辑区直接上传（拖拽/粘贴/文件选择按钮），禁止走评论区 `input[type=file]` 上传后再搬运 CDN URL。** 原因：PR Description 编辑区本身支持图片拖拽上传、自动转为 `![](CDN_URL)` 内嵌，一步到位；走评论区上传需要多一步「提交评论 → 复制 URL → 粘贴到 Description」，产生的临时图片评论会留在 PR 对话里干扰 reviewer 阅读，且多了一步手动搬运、容易出错。
 - ⚠️ 创建 PR 使用 `/create-pr` skill（自动生成中文内容 + 效果截图 + CDN 上传）。
 - ⚠️ **私有仓库的 PR/Issue 正文中插入截图，禁止使用 `raw.githubusercontent.com` 链接，必须使用 `github.com/OWNER/REPO/blob/BRANCH/path?raw=true` 格式。** 原因：`raw.githubusercontent.com` 不识别 GitHub 网页端的登录态（session cookie），GitHub 渲染 PR/Issue 正文图片时走的是 camo 图片代理服务器端匿名拉取——对私有仓库该链接返回 404，导致图片框显示为普通文字链接而非图片；`github.com/.../blob/...?raw=true` 走的是 github.com 主域名，能通过登录态正确鉴权，图片才能正常渲染。凡是「先 `git add -f` 把截图提交进 `screenshots/` 目录、再在 PR 描述里用 Markdown 引用」的流程，图片链接一律拼接为后一种格式。
@@ -114,7 +116,7 @@
 ### 非 UI / 后端 / 基础设施改动的效果截图获取方法
 - 后端接口、基础设施类改动没有传统的前后端 UI diff 时，效果截图可以是：(a) 实际打开受影响页面截图，证明功能正常渲染真实数据；(b) 将 curl 请求/响应对比结果渲染成一个简单的本地 HTML（暗色终端风格），用浏览器截图工具截出来，作为"请求响应"证据图。两者都满足"必须附功能效果截图"的强制要求。
-- ⚠️ **`gh` CLI 没有原生的图片上传能力，禁止把截图提交进功能分支来获取图片链接，也禁止用 `gh gist create --public` 等公开托管服务代替**（未经授权的公开发布）。正确做法：用已登录 GitHub 的 agent-browser CDP 会话打开目标 PR 页面 → 找到评论框下的隐藏 `input[type=file]` → 上传图片 → GitHub 会自动转成 `https://github.com/user-attachments/assets/...` 的 CDN 地址并写入评论框文本 → 提交评论使图片持久化（必须先提交评论，图片链接才长期有效）→ 用 `gh pr edit --body-file` 把这些 CDN URL 替换进 PR Description 的占位符位置。详细操作步骤（选择器、提交按钮定位、受控组件输入注意事项）见 `/create-pr` skill。
+- ⚠️ **`gh` CLI 没有原生的图片上传能力，禁止把截图提交进功能分支来获取图片链接，也禁止用 `gh gist create --public` 等公开托管服务代替**（未经授权的公开发布）。正确做法：用已登录 GitHub 的 agent-browser CDP 会话打开目标 PR 页面 → 在 PR Description 编辑区直接拖拽/粘贴图片（或定位编辑区的隐藏 `input[type=file]` 上传）→ GitHub 自动将图片转为 `https://github.com/user-attachments/assets/...` 的 CDN 地址并插入 Description 正文 → 保存 PR Description 使图片持久化。**禁止走评论区上传再搬运 URL**，评论区图片评论会干扰 reviewer 阅读。详细操作步骤见 `/create-pr` skill。
 ## Go 规则

package/package.json CHANGED Viewed

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

package/rules/global.md CHANGED Viewed

@@ -49,6 +49,8 @@ name: "通用规则"
 - ⚠️ PR Title / Description / Test Plan 全部中文。一个 PR 只做一件事。
 - ⚠️ 必须附截图作为可视化证据（前后对比、标注改动区域）。
+- ⚠️ **截图必须直接内嵌在 PR Description 中，让 reviewer 打开 PR 就能看到效果图（`![](CDN_URL)` 方式渲染为可见图片），禁止只在文字里描述"改动了什么"而不放图，也禁止把截图只作为文件附件/提交到分支目录而不在 PR 正文中引用。** 原因：reviewer 看 PR 的第一眼就是看描述，如果看不到图、只能读文字，完全无法直观感知改动效果；截图不内嵌 = 等于没附。
+- ⚠️ **截图必须通过 PR Description 编辑区直接上传（拖拽/粘贴/文件选择按钮），禁止走评论区 `input[type=file]` 上传后再搬运 CDN URL。** 原因：PR Description 编辑区本身支持图片拖拽上传、自动转为 `![](CDN_URL)` 内嵌，一步到位；走评论区上传需要多一步「提交评论 → 复制 URL → 粘贴到 Description」，产生的临时图片评论会留在 PR 对话里干扰 reviewer 阅读，且多了一步手动搬运、容易出错。
 - ⚠️ 创建 PR 使用 `/create-pr` skill（自动生成中文内容 + 效果截图 + CDN 上传）。
 - ⚠️ **私有仓库的 PR/Issue 正文中插入截图，禁止使用 `raw.githubusercontent.com` 链接，必须使用 `github.com/OWNER/REPO/blob/BRANCH/path?raw=true` 格式。** 原因：`raw.githubusercontent.com` 不识别 GitHub 网页端的登录态（session cookie），GitHub 渲染 PR/Issue 正文图片时走的是 camo 图片代理服务器端匿名拉取——对私有仓库该链接返回 404，导致图片框显示为普通文字链接而非图片；`github.com/.../blob/...?raw=true` 走的是 github.com 主域名，能通过登录态正确鉴权，图片才能正常渲染。凡是「先 `git add -f` 把截图提交进 `screenshots/` 目录、再在 PR 描述里用 Markdown 引用」的流程，图片链接一律拼接为后一种格式。
@@ -114,7 +116,7 @@ name: "通用规则"
 ### 非 UI / 后端 / 基础设施改动的效果截图获取方法
 - 后端接口、基础设施类改动没有传统的前后端 UI diff 时，效果截图可以是：(a) 实际打开受影响页面截图，证明功能正常渲染真实数据；(b) 将 curl 请求/响应对比结果渲染成一个简单的本地 HTML（暗色终端风格），用浏览器截图工具截出来，作为"请求响应"证据图。两者都满足"必须附功能效果截图"的强制要求。
-- ⚠️ **`gh` CLI 没有原生的图片上传能力，禁止把截图提交进功能分支来获取图片链接，也禁止用 `gh gist create --public` 等公开托管服务代替**（未经授权的公开发布）。正确做法：用已登录 GitHub 的 agent-browser CDP 会话打开目标 PR 页面 → 找到评论框下的隐藏 `input[type=file]` → 上传图片 → GitHub 会自动转成 `https://github.com/user-attachments/assets/...` 的 CDN 地址并写入评论框文本 → 提交评论使图片持久化（必须先提交评论，图片链接才长期有效）→ 用 `gh pr edit --body-file` 把这些 CDN URL 替换进 PR Description 的占位符位置。详细操作步骤（选择器、提交按钮定位、受控组件输入注意事项）见 `/create-pr` skill。
+- ⚠️ **`gh` CLI 没有原生的图片上传能力，禁止把截图提交进功能分支来获取图片链接，也禁止用 `gh gist create --public` 等公开托管服务代替**（未经授权的公开发布）。正确做法：用已登录 GitHub 的 agent-browser CDP 会话打开目标 PR 页面 → 在 PR Description 编辑区直接拖拽/粘贴图片（或定位编辑区的隐藏 `input[type=file]` 上传）→ GitHub 自动将图片转为 `https://github.com/user-attachments/assets/...` 的 CDN 地址并插入 Description 正文 → 保存 PR Description 使图片持久化。**禁止走评论区上传再搬运 URL**，评论区图片评论会干扰 reviewer 阅读。详细操作步骤见 `/create-pr` skill。
 ## Go 规则