docs: 明确 Web 白屏诊断顺序

.agents/skills/unidesk-webdev/SKILL.md

@@ -10,6 +10,11 @@ description: UniDesk Web 开发与受控浏览器验证技能。用户提到 Web
 ## 快速规则
 
 - Web、网页、前端、浏览器、网页登录、截图、移动端、响应式、视觉、smoke、E2E、fake-server、Workbench、Performance 和前端状态投影任务必须先用本技能。
+- 页面白屏或应用 bootstrap 失败时，必须立即按以下顺序诊断：
+  - 先通过 `web-probe` 采集当前页面的 `pageerror`、`console.error` 和失败网络请求；
+  - 再依据首个根因错误检查 runtime config、入口脚本、依赖加载和 API 响应；
+  - 根因未分层前，禁止先改 CSS、DOM 或依据截图猜测问题；
+  - 修复后重新确认 console 无错误，再进行 DOM、交互和截图验收。
 - 所有浏览器操作必须通过 `bun scripts/cli.ts web-probe ...` 受控入口执行：
   - 禁止直接调用 `playwright`、`@playwright/cli`、`playwright-cli`、浏览器 MCP 或仓库外临时浏览器脚本；
   - `web-probe` 内部可以使用浏览器引擎，但认证、目标解析、截图、脱敏、artifact 和报告必须由 `web-probe` 合同统一管理；
@@ -133,7 +138,7 @@ description: UniDesk Web 开发与受控浏览器验证技能。用户提到 Web
 1. 先确认目标：repo、分支/lane、node、semantic origin（internal/public）、预期页面或 workflow。
 2. 读取对应 SPEC 或 issue，明确验收口径；Workbench 和 Performance 页不要只凭局部 DOM 判断。
 3. 独立启动 native 测试后端与 HMR 前端，记录端口、日志和停止入口。
-4. 只用 `bun scripts/cli.ts web-probe ...` 受控入口完成 native 复现与迭代；需要的新浏览器动作先补为 typed command。
+4. 只用 `bun scripts/cli.ts web-probe ...` 受控入口完成 native 复现与迭代；白屏先查 console 和失败 network，再查 DOM 与截图；需要的新浏览器动作先补为 typed command。
 5. Native 功能和视觉验收收口后，再通过正式 CI/CD 自动交付。
 6. 用同一业务入口完成部署态复测；需要关闭用户反馈/issue 时，记录真实入口证据、截图/trace/session 和失败或通过结论。