Communitygithub.com

victor-shulga/website-audit

对活动网站进行只读的技术和转化率审计,作为 B2B 网站重构前的快照。在同一域名下爬取最多 N 个页面,检查移动端布局、漏洞、无障碍性、性能、转化路径和 SEO 基础,并生成一份 Markdown 报告。

website-audit 是什么?

该技能用于对活动网站执行一次全面、只读的技术和转化率审计,特别适合作为 B2B 网站重构前的基线快照。它会在无头 Chrome 中爬取最多 N 个同源页面(默认 10 个),并以 360/390/768 像素宽度检查移动端布局;检测页面错误(控制台错误、失败请求、损坏的链接和图片)、无障碍性(axe-core,WCAG 2.1 A/AA)、性能(Lighthouse 或浏览器时间指标)、转化路径(首屏 CTA、联系表单、信任标记)和 SEO 基础。最终输出一份 Markdown 报告,包含各领域得分、P0-P3 级问题(问题、位置、对潜在客户的影响、修复方案)以及一份用于重构后对比的快照,同时还会输出原始 JSON 数据。该技能支持 Node.js 22+ 和 Chrome/Chromium,可用于 Claude Code、Cursor 等 AI Agent 平台。当用户提出“审计这个网站”、“网站哪里有问题”、“аудит сайту”等请求时即可调用。请注意,此技能不包括文案审计或设计系统生成功能。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/victor-shulga/website-audit/tree/HEAD/skills/website-audit

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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:

  1. 对照证据确认每个 P0 级别问题(脚本是字面执行的;机器人防护或 JavaScript 表单可能导致误报 P0)。
  2. 通过查看 screens/ 中的截图,逐一解决每个标有“请手动检查”的项目。
  3. 确保“优先修复”部分的内容可以作为重构的第一个迭代。

直接编辑 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 数据工具。

相关技能