website-audit 是做什么的?
一条命令测量网站;然后您确认脚本无法判断的内容,并将一份创始人可以据此采取行动的报告交付给对方。该审计是只读的:绝不会提交表单、绝不会登录、绝不点击任何会改变状态的内容,尊重 robots.txt 并在页面加载之间添加停顿。
输入
- URL(必填)。如果用户未提供,请询问。
- 页面数量上限(可选,默认为 10)。快速查看用 3–5,完整预重构基线用 15–25。
- 报告语言(可选,默认使用用户使用的语言)。
要求
- Node.js 22 或更新版本(
node --version)。Lighthouse 额外需要 Node ≥ 22.19 和 npm(npx)。 - Google Chrome 或 Chromium。在 macOS、Linux 和 Windows 上自动检测,包括已通过
npx playwright install chromium下载的 Chromium。否则请设置CHROME_BIN=/path/to/chrome。 - 能够访问被审计网站的网络的权限,以及一个公共 npm CDN(axe-core)和 npm 注册表(Lighthouse)。如果无法获取其中任何一个工具,报告中会将相应领域标记为“已跳过”并说明原因;运行过程不会失败。
步骤
1. 运行审计
<skill-dir> 是本 SKILL.md 文件所在的文件夹。
node <skill-dir>/scripts/audit.mjs https://example.com --limit 10
选项:--limit N · --delay MS(页面之间停顿时间,默认 1000) · --max-links N(内部链接检查数量,默认 150) · --no-lighthouse · --no-axe · --max-minutes N(默认 15) · --out DIR。
输出目录为相对于当前文件夹的 ./website-audit/<域名>/(可通过 --out 或 WEBSITE_AUDIT_OUT 环境变量覆盖):
website-audit-<域名>-<日期>.md:报告website-audit-<域名>-<日期>.json:原始测量数据、发现的问题、得分、快照screens/:每个页面的首屏截图(桌面端和 390 像素宽度)
进度信息输出到 stderr;最后一行 stdout 是一个 JSON 摘要(ok、report、pages、seconds、overall、counts、scores、skipped)。返回码 2 表示审计完全无法运行(没有 Node 22、没有 Chrome、网站无法访问):向用户展示消息,其中说明了需要安装或检查的内容。
运行 10 个页面大约需要 2–4 分钟;Lighthouse 额外增加 30–60 秒。
2. 手动审核流程
遵循 <skill-dir>/references/manual-review.md:
- 对照证据确认每个 P0 级别问题(脚本是字面执行的;机器人防护或 JavaScript 表单可能导致误报 P0)。
- 通过查看
screens/中的截图,逐一解决每个标有“请手动检查”的项目。 - 确保“优先修复”部分的内容可以作为重构的第一个迭代。
直接编辑 Markdown 报告。不要更改 JSON 文件;它是原始的基线数据。
3. 语言
脚本默认输出英文。如果用户使用其他语言,请翻译报告中的标题、“对潜在客户的影响”和“修复”行。保留 URL、选择器、度量指标名称、HTTP 状态码以及 P0 到 P3 标签的原样。
4. 交付
回复内容包括:总体得分、P0 / P1 数量、“优先修复”列表、哪些领域被跳过及原因,以及报告的路径。提供稍后以相同的页面数量上限在新网站上重新运行审计的选项,以填充快照的“重构后”对比列。
如果用户希望在调整阈值后重新生成报告:
node <skill-dir>/scripts/report.mjs <运行结果目录>.json 可以根据 JSON 文件重新生成 Markdown 报告。
各领域覆盖内容
详细内容、阈值和优先级规则见 <skill-dir>/references/checks.md。简要说明如下:
| 领域 | 如何检查 |
|---|---|
| 移动端布局 | 在每个页面上以 360 / 390 / 768 像素宽度检查:横向滚动、元素超出边界、视口 meta 标签、点击目标、小字体 |
| 漏洞 | 控制台错误和异常、4xx/5xx 及失败请求、混合内容、损坏的图片、内部链接(HEAD/GET)、表单目标(仅 HEAD) |
| 无障碍性 | 向每个页面注入 axe-core,检查 WCAG 2.0/2.1 A + AA 标记 |
| 性能 | 首页的 Lighthouse 移动端测试;每个页面的浏览器时间指标(TTFB、LCP、CLS、页面大小、请求数) |
| 转化路径 | 桌面端和手机端的首屏 CTA、到达联系页面的点击次数、电子邮件/电话/预约/潜在客户表单、推荐信、案例、标志、数据 |
| SEO 基础 | title、description、一个 H1、canonical、Open Graph、noindex、robots.txt、sitemap.xml |
规则
- 绝不提交、填写或点击表单;绝不登录;绝不绕过机器人防护或验证码。如果网站返回挑战页面,则报告该情况并停止。
- 尊重
robots.txt中的禁止规则;保持默认延迟,除非用户拥有该网站并要求更快速的运行。 - 标记为“请手动检查”的发现项在您查看截图之前都是假设性结论。
- 不要自行在任何地方发布报告;报告可能包含客户网站的弱点。
非此技能适用的情况
- 文案、定位和沟通风格评估 → 使用
website-copy-reframe。 - 从网站提取品牌/设计系统 → 使用
design-system-generator。 - 关键词排名、反向链接、流量估算 → 使用 SEO 数据工具。