@routerhub/agent-rules 1.5.189 → 1.5.190

package/AGENTS.base.md

@@ -147,6 +147,7 @@
   2. **每张图标出「该点什么 / 看到什么」**：箭头 + 文字标注具体按钮位置与预期反馈，标注坐标必须来自 DOM 测量（`getBoundingClientRect()`），走 `/screenshot-annotate`；绿色 = 正确操作路径、红色 = 会被拒绝的错误姿势，让读者一眼看出「别这么点、该那么点」；
   3. **图间配过渡说明**：每张 caption 讲清「上一步发生了什么 → 这一步点哪里 → 预期看到什么」，报告内按操作顺序成段排布，读者能跟着连点；
   4. **逐张自检**：只看这张图 + 说明，能否照着点出下一步？能 = 合格；不能 = 补一张步骤图或补标注，直到整条流程读者不靠你就能走完。
+  5. **就近嵌入（位置铁律）**：分步演示必须紧跟在「该操作对应概念/证据在报告中第一次出现、读者正要问『那到底怎么操作』」的地方之后（如展示「账户挂映射删除被 400 拒绝」的证据图 → 该图下方紧跟「先解绑再删除」的完整演示），禁止把演示单独堆到报告末尾或附录里——读者在定义处看不到演示、不知道下文还有、得自己翻到最后去找，等于没配演示。
   - **类比**：交付报告像给菜谱——一道菜（一个功能）从备料到出锅（完整操作流程）必须给出「第 1 步切什么、第 2 步放多少油」的步骤图，读者照做能做出同一道菜；只贴一张成品照让读者猜过程，等于没教。
   - 反面示例：演示「删不掉挂着映射的账户」，只贴「删除被拒」和「最终删除成功」两张图、不展示中间「打开 Models → Remove(Unbind) → 确认」的顺序，读者仍不知道卡住时该点哪里。
 

package/package.json

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

package/rules/global.md

@@ -147,6 +147,7 @@ name: "通用规则"
   2. **每张图标出「该点什么 / 看到什么」**：箭头 + 文字标注具体按钮位置与预期反馈，标注坐标必须来自 DOM 测量（`getBoundingClientRect()`），走 `/screenshot-annotate`；绿色 = 正确操作路径、红色 = 会被拒绝的错误姿势，让读者一眼看出「别这么点、该那么点」；
   3. **图间配过渡说明**：每张 caption 讲清「上一步发生了什么 → 这一步点哪里 → 预期看到什么」，报告内按操作顺序成段排布，读者能跟着连点；
   4. **逐张自检**：只看这张图 + 说明，能否照着点出下一步？能 = 合格；不能 = 补一张步骤图或补标注，直到整条流程读者不靠你就能走完。
+  5. **就近嵌入（位置铁律）**：分步演示必须紧跟在「该操作对应概念/证据在报告中第一次出现、读者正要问『那到底怎么操作』」的地方之后（如展示「账户挂映射删除被 400 拒绝」的证据图 → 该图下方紧跟「先解绑再删除」的完整演示），禁止把演示单独堆到报告末尾或附录里——读者在定义处看不到演示、不知道下文还有、得自己翻到最后去找，等于没配演示。
   - **类比**：交付报告像给菜谱——一道菜（一个功能）从备料到出锅（完整操作流程）必须给出「第 1 步切什么、第 2 步放多少油」的步骤图，读者照做能做出同一道菜；只贴一张成品照让读者猜过程，等于没教。
   - 反面示例：演示「删不掉挂着映射的账户」，只贴「删除被拒」和「最终删除成功」两张图、不展示中间「打开 Models → Remove(Unbind) → 确认」的顺序，读者仍不知道卡住时该点哪里。