@routerhub/agent-rules 1.5.82 → 1.5.83

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.
package/AGENTS.base.md CHANGED
@@ -116,6 +116,25 @@ Closes #456
116
116
  - ⚠️ **创建 PR 时,AI 自动附上功能效果截图**:根据改动类型自动截取并贴图 —— UI 改动自动截前后对比截图,接口/后端改动自动截请求响应截图或功能验证截图,修 bug 自动截复现前后对比截图。截图由 AI 自动完成,无需用户手动操作。
117
117
  - ⚠️ **PR 截图必须直接放在 Description 正文中**,以 Markdown 图片语法(`![](url)`)内嵌到 Description 里,reviewer 打开 PR 即可直观看到效果,禁止只贴外部链接或附件形式。
118
118
 
119
+ ### PR 效果截图制作规范
120
+
121
+ - ⚠️ **截图文件禁止提交到 Git 仓库**。截图通过 GitHub 评论区 file input 上传,获取 CDN URL(`https://github.com/user-attachments/assets/...`),公网可直接访问。
122
+ - ⚠️ **截图必须直接内嵌在 PR Description 中**,以 Markdown 图片语法(`![](url)`)渲染,reviewer 打开 PR 即可直观看到效果,禁止只贴外部链接或附件。
123
+ - ⚠️ **截图必须展示前后对比**(修复前 vs 修复后),左右并排排列。
124
+ - ⚠️ **关键改动区域必须用彩色矩形框圈选标注**(修复前红框,修复后绿框),标注框不遮挡页面内容。
125
+ - ⚠️ **标注说明文字放在截图上方独立色条区域**(修复前红色条,修复后绿色条),文字格式:`❌ 修复前:XXX` / `✅ 修复后:XXX`,色条和标注框色统一。
126
+ - ⚠️ **截图只截取改动相关区域**,顶部无关内容(URL 栏、导航栏等)裁掉不截。
127
+
128
+ ### PR 效果截图制作流程(Claude Code 自动执行)
129
+
130
+ 生成 PR 时按以下步骤自动制作效果截图:
131
+
132
+ 1. **截修复后**:本地开发服打开改动涉及的页面 → 滚动到改动区域 → 全页截图
133
+ 2. **截修复前**:临时注释/回退本次改动的代码 → 等 hot reload → 同页面同位置全页截图 → 恢复代码
134
+ 3. **生成对比图**:用 `sharp` 拼接两张截图 —— 上方红/绿色标注条(含修复前/后文字说明),下方截图内容(关键改动区域用对应颜色矩形框圈选),左修复前右修复后并排
135
+ 4. **上传到 GitHub CDN**:打开 PR 页面 → 通过评论区隐藏的 `#fc-new_comment_field` 上传对比图 → 获取 `user-attachments` CDN URL
136
+ 5. **写入 PR Description**:`![](CDN_URL)` 内嵌到 Description 中,清理评论区临时上传的评论
137
+
119
138
  ## 安全
120
139
 
121
140
  - 用户明确要求上线/部署生产环境时,直接执行,无需二次确认。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@routerhub/agent-rules",
3
- "version": "1.5.82",
3
+ "version": "1.5.83",
4
4
  "description": "Shared Copilot agent rules and guidelines for RouterHub projects",
5
5
  "main": "AGENTS.base.md",
6
6
  "bin": {
package/rules/global.md CHANGED
@@ -118,6 +118,25 @@ Closes #456
118
118
  - ⚠️ **创建 PR 时,AI 自动附上功能效果截图**:根据改动类型自动截取并贴图 —— UI 改动自动截前后对比截图,接口/后端改动自动截请求响应截图或功能验证截图,修 bug 自动截复现前后对比截图。截图由 AI 自动完成,无需用户手动操作。
119
119
  - ⚠️ **PR 截图必须直接放在 Description 正文中**,以 Markdown 图片语法(`![](url)`)内嵌到 Description 里,reviewer 打开 PR 即可直观看到效果,禁止只贴外部链接或附件形式。
120
120
 
121
+ ### PR 效果截图制作规范
122
+
123
+ - ⚠️ **截图文件禁止提交到 Git 仓库**。截图通过 GitHub 评论区 file input 上传,获取 CDN URL(`https://github.com/user-attachments/assets/...`),公网可直接访问。
124
+ - ⚠️ **截图必须直接内嵌在 PR Description 中**,以 Markdown 图片语法(`![](url)`)渲染,reviewer 打开 PR 即可直观看到效果,禁止只贴外部链接或附件。
125
+ - ⚠️ **截图必须展示前后对比**(修复前 vs 修复后),左右并排排列。
126
+ - ⚠️ **关键改动区域必须用彩色矩形框圈选标注**(修复前红框,修复后绿框),标注框不遮挡页面内容。
127
+ - ⚠️ **标注说明文字放在截图上方独立色条区域**(修复前红色条,修复后绿色条),文字格式:`❌ 修复前:XXX` / `✅ 修复后:XXX`,色条和标注框色统一。
128
+ - ⚠️ **截图只截取改动相关区域**,顶部无关内容(URL 栏、导航栏等)裁掉不截。
129
+
130
+ ### PR 效果截图制作流程(Claude Code 自动执行)
131
+
132
+ 生成 PR 时按以下步骤自动制作效果截图:
133
+
134
+ 1. **截修复后**:本地开发服打开改动涉及的页面 → 滚动到改动区域 → 全页截图
135
+ 2. **截修复前**:临时注释/回退本次改动的代码 → 等 hot reload → 同页面同位置全页截图 → 恢复代码
136
+ 3. **生成对比图**:用 `sharp` 拼接两张截图 —— 上方红/绿色标注条(含修复前/后文字说明),下方截图内容(关键改动区域用对应颜色矩形框圈选),左修复前右修复后并排
137
+ 4. **上传到 GitHub CDN**:打开 PR 页面 → 通过评论区隐藏的 `#fc-new_comment_field` 上传对比图 → 获取 `user-attachments` CDN URL
138
+ 5. **写入 PR Description**:`![](CDN_URL)` 内嵌到 Description 中,清理评论区临时上传的评论
139
+
121
140
  ## 安全
122
141
 
123
142
  - 用户明确要求上线/部署生产环境时,直接执行,无需二次确认。