@routerhub/agent-rules 1.5.81 → 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
@@ -114,6 +114,26 @@ Closes #456
114
114
 
115
115
  - ⚠️ **创建 PR 时,AI 自动在 Description 中补充需求文档链接或需求描述**:自动查找 `docs/` 目录下对应的需求文档并附上链接;如该需求尚无文档,AI 自动根据本次改动内容在 Description 中写出完整的需求描述(含背景、目标、功能点、验收标准),无需用户手动填写。
116
116
  - ⚠️ **创建 PR 时,AI 自动附上功能效果截图**:根据改动类型自动截取并贴图 —— UI 改动自动截前后对比截图,接口/后端改动自动截请求响应截图或功能验证截图,修 bug 自动截复现前后对比截图。截图由 AI 自动完成,无需用户手动操作。
117
+ - ⚠️ **PR 截图必须直接放在 Description 正文中**,以 Markdown 图片语法(`![](url)`)内嵌到 Description 里,reviewer 打开 PR 即可直观看到效果,禁止只贴外部链接或附件形式。
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 中,清理评论区临时上传的评论
117
137
 
118
138
  ## 安全
119
139
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@routerhub/agent-rules",
3
- "version": "1.5.81",
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
@@ -116,6 +116,26 @@ Closes #456
116
116
 
117
117
  - ⚠️ **创建 PR 时,AI 自动在 Description 中补充需求文档链接或需求描述**:自动查找 `docs/` 目录下对应的需求文档并附上链接;如该需求尚无文档,AI 自动根据本次改动内容在 Description 中写出完整的需求描述(含背景、目标、功能点、验收标准),无需用户手动填写。
118
118
  - ⚠️ **创建 PR 时,AI 自动附上功能效果截图**:根据改动类型自动截取并贴图 —— UI 改动自动截前后对比截图,接口/后端改动自动截请求响应截图或功能验证截图,修 bug 自动截复现前后对比截图。截图由 AI 自动完成,无需用户手动操作。
119
+ - ⚠️ **PR 截图必须直接放在 Description 正文中**,以 Markdown 图片语法(`![](url)`)内嵌到 Description 里,reviewer 打开 PR 即可直观看到效果,禁止只贴外部链接或附件形式。
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 中,清理评论区临时上传的评论
119
139
 
120
140
  ## 安全
121
141