前言¶
接手一个新站点或一份老项目时，最费时间的不是写代码，而是搞清楚这个页面到底有哪些按钮、跳到哪、会发哪些请求、登录前后有什么差异。人工点一遍写文档，容易漏掉异常路径和响应式下才有的元素；用 Playwright 写脚本，又要花几天搭环境和维护。下面介绍的这个 Skill 换了一条路：直接基于浏览器调试协议（CDP）驱动页面，把探索过程固化成流水线，最后产出一份结构化的页面功能规格说明书。
这是什么¶
「页面功能规格说明书生成器」是一个面向大模型 Agent 的 Skill，坐标 @user_1417f0ce/page-spec-generator，版本 1.0.3，由社区开发者 user_1417f0ce 发布并维护，分类 dev-programming，来源标记为 community。
它解决的问题是：把一个网站的页面行为自动转成一份人能读懂、机器也能照着执行的规格文档。和写测试脚本相比，它侧重「摸清现状」，而不是「断言结果」。
在 SkillHub 上，该 Skill 的评分为 100000，下载 1420 次，安装 0 次，标签显示 requires_api_key=false，即不需要额外的 API Key。
核心功能¶
该 Skill 基于 Browser Harness（CDP 协议）自动探索目标网站，内部是一条 8 阶段流水线，覆盖以下六类信息：
- 交互元素穷举：列出页面上的可交互控件。
- 导航路由全景：梳理页面之间的跳转关系。
- API 请求/响应深度捕获：记录页面发出的接口调用及返回内容。
- 登录状态机与错误码：覆盖登录前后的状态变化和异常返回。
- 响应式断点：检查不同屏幕宽度下的布局差异。
- 无障碍审计：给出可访问性方面的问题。
流水线跑完后，产出三样东西：一份 14 章的 Markdown 文档、一组页面截图，以及一份行为缺口清单。文档面向前端、后端、测试、产品和管理层，可以直接当作需求或验收的依据。
需要注意一点：该 Skill 明确禁止使用 Playwright，全部探索走 CDP，因此环境依赖和失败模式与 Playwright 脚本不同。
安装与启用¶
该 Skill 遵循通用 SKILL.md 格式，收录在 SkillHub 社区中，官方地址为：
https://api.skillhub.cn/user_1417f0ce/page-spec-generator
SkillHub 页面：
https://www.skillhub.cn/skills/user_1417f0ce/page-spec-generator
官方资料里没有给出跨客户端的安装命令或目录路径，因此这里不臆测。在 Cursor、Codex CLI、Claude Code 等支持 SKILL.md 的客户端里，通常的做法是把该 Skill 的 SKILL.md 放到对应的 skills 目录或通过 SkillHub 的入口添加。添加完成后，Agent 即可在任务中调用。由于 requires_api_key=false，启用时不需要预先配置密钥。
典型用法¶
官方资料没有提供逐条命令行示例，下面按该 Skill 的能力描述它的工作方式。
- 给出目标站点 URL。把这个地址交给启用了该 Skill 的 Agent，让它对目标站点执行探索。
- 运行 8 阶段流水线。Agent 通过 Browser Harness 逐步完成交互元素枚举、路由梳理、API 捕获、登录与错误码覆盖、响应式断点检查和无障碍审计。
- 回收产出。流水线结束后拿到 14 章 Markdown 规格文档、页面截图和行为缺口清单。
- 使用产出。前端按文档补实现或核对现状，测试按行为缺口清单补用例，产品和管理层拿它做验收依据。
适用场景与注意¶
适合这几类人：接手陌生站点的前端和后端，需要一份可信的现状文档；测试同学想快速覆盖登录、错误码、响应式这些容易漏的路径；产品或管理层想在评审前看到页面到底有哪些功能。
使用前有几点要留意：
- 探索范围受目标站点可达性和登录凭据影响，抓不到的页面不会写进文档。
- 登录状态机的覆盖依赖你提供的账号和权限，低权限账号看到的页面会少。
- 文档是「现状快照」，站点改版后需要重跑。
- 该 Skill 不走 Playwright，若团队已有基于 Playwright 的测试体系，两者的脚本和结果不能直接互换。
- 版本 1.0.3，社区来源，遇到问题建议先对照 SkillHub 页面上的发布说明。
结尾¶
这个 Skill 的价值在于把「摸清页面」这件重复劳动变成一条可复跑的流水线，产出直接能用的规格文档，而不是一堆需要人工整理的截图和日志。如果你正在接手一个新站点，可以从它的官方地址开始试：https://api.skillhub.cn/user_1417f0ce/page-spec-generator
