@routerhub/agent-rules 1.5.59 → 1.5.60

package/AGENTS.base.md

@@ -180,6 +180,12 @@ Closes #456
 - 涉及配置、官网或其他系统联动时，需同时打开所有相关页面，并按实际操作路径展示联动结果，方便直接验证。
 - 若客观上无法可视化展示，需说明原因，并补充截图、录屏、日志或请求响应作为替代证据。
 
+## 外部文档查看（Notion / 需登录页面）
+
+- 查看 Notion 文档或其他需要登录态的外部页面时，必须使用 Chrome DevTools MCP（`navigate_page` + `take_snapshot` / `evaluate_script`），禁止使用 WebFetch。WebFetch 无法处理需要登录的页面，会直接报错看不到内容；浏览器 MCP 可复用用户已有的登录态。
+- 页面 snapshot 太大无法直接读取时，用 `evaluate_script` 执行 `document.body.innerText` 或更精准的选择器提取文本内容，再分段读取。
+- 提取到的外部文档内容涉及项目关键规范/数据时，应保存为长期记忆（`memory/` 目录）方便后续引用。
+
 <!-- @domain: frontend -->
 
 ## Figma 还原规范

package/package.json

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

package/rules/global.md

@@ -179,3 +179,9 @@ Closes #456
 - 完成任务后的汇报优先提供可视化结果，能打开页面时就直接在集成浏览器中打开，并定位到相关区域后再汇报。
 - 涉及配置、官网或其他系统联动时，需同时打开所有相关页面，并按实际操作路径展示联动结果，方便直接验证。
 - 若客观上无法可视化展示，需说明原因，并补充截图、录屏、日志或请求响应作为替代证据。
+
+## 外部文档查看（Notion / 需登录页面）
+
+- 查看 Notion 文档或其他需要登录态的外部页面时，必须使用 Chrome DevTools MCP（`navigate_page` + `take_snapshot` / `evaluate_script`），禁止使用 WebFetch。WebFetch 无法处理需要登录的页面，会直接报错看不到内容；浏览器 MCP 可复用用户已有的登录态。
+- 页面 snapshot 太大无法直接读取时，用 `evaluate_script` 执行 `document.body.innerText` 或更精准的选择器提取文本内容，再分段读取。
+- 提取到的外部文档内容涉及项目关键规范/数据时，应保存为长期记忆（`memory/` 目录）方便后续引用。