页面功能规格说明书生成器

接手站点时缺的不是截图，而是可验证的行为规格

新项目接手、竞品拆解或给遗留前端补文档时，常见困境是：路由表能爬出来，但每个按钮点下去会发生什么、搜索是本地索引还是云 API、未登录与 VIP 权限差在哪——这些往往散落在工程师脑子里，测试也缺少穷举基线。

技能如何工作

本技能通过 Browser Harness（CDP） 连接你正在使用的 Chrome，在真实登录态与扩展环境下做自动化探索，而不是默认拉起 Playwright 等独立驱动。整体是两条流水线：

• 全站分析（Phase 0–7）：先做站点类型判断与初始扫描，再枚举导航与 SPA 路由，对可交互元素逐个操作并记录前后状态（截图、URL、DOM 变化），配合 Performance / 浏览器内 fetch 梳理 API，并覆盖 404、空搜索、登录错误码等状态机场景，最后编译成 14+ 章规格文档（含 Mermaid 导航流、组件状态矩阵、无障碍与 Gap 清单）。
• 模块深度分析（§M）：针对单一功能模块做边界映射与分支穷举（表单输入、筛选、分页、API 六类响应等），产出更密集的 8 章模块文档，可与全站结果合并。

文档编写强调行为而非 DOM 罗列：按钮幂等性、Tab 切换是否重置页码、搜索快捷键与 facet 配置等都会按类型写入；未验证处用 ⚠️ Gap 标注优先级。

适用边界与注意点

• 硬性依赖 Browser Harness：generate_page_spec()、page_info()、js() 等均走 CDP；未安装须先征得你同意再安装，且不能代你改 Chrome 远程调试授权。
• SPA / 重 JS 页面：CDP 滚轮事件可能超时，需降级为 JS 滚动 + 手动采集。
• 反爬与验证码：应放慢请求间隔；遇验证码需你手动完成。
• 可选在存在 src/ 或 package.json 时启用源码增强插件，与页面观测结果交叉标注。