关于 audit-website
audit-website 是一项使用 squirrel CLI 检查网站并协助修复问题的技能,面向处理网站代码和内容的 Agent。它指导从报告中定位问题、分批应用确认过的修复,并通过重新审计验证结果。
主要功能
- 01运行网站审计并读取报告
- 02按严重性整理问题
- 03将发现映射到代码或内容
- 04分批应用已确认的修复
- 05重新审计并比较分数
适用场景
- 01查找网站的 SEO 与可访问性问题
- 02部署后检查网站回归
- 03依据审计结果修复页面模板或内容
- 04通过完整扫描验证修复
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ squirrelscan/ squirrelscan --skill audit-website安装后在 Claude Code 中输入/audit-website确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.mdagents/openai.yamlassets/icon-small.svgreferences/OUTPUT-FORMAT.md详细介绍
审核网站并修复问题
针对网站运行 squirrelscan 审核,阅读 LLM 报告,将每个问题对应到导致问题的代码或内容,分批修复并重新审核,直到达到目标分数。
需要 squirrel CLI(squirrelscan.com/download;使用 squirrel --version 验证)。有关 CLI 设置、登录、发布、MCP 和 CLI 常规用法,请使用配套的 squirrelscan 技能。
规则文档
在 https://docs.squirrelscan.com/rules/{rule_category}/{rule_id} 查找任何规则,例如:
https://docs.squirrelscan.com/rules/links/external-links
运行审核
squirrel audit https://example.com --format llm
- 使用
--format llm:它简洁、全面,专为 Agent 打造。 - 如果用户没有提供 URL,请询问要审核哪个网站。
- 优先审核线上网站:只有在线上网站才能看到真实的渲染效果、性能和重定向行为。如果同时有本地开发服务器和线上网站,建议审核线上网站;无论如何,都应在本地代码中应用修复。
- 审核结果会在本地缓存。无需重新爬取即可稍后重新生成报告:
squirrel report <audit-id> --format llm。
扫描进度
- 第一轮,快速覆盖(默认):快速、浅层扫描,了解网站结构、技术栈和主要问题,且不会影响网站。
- 第二轮,深入覆盖:使用
-C surface(每种 URL 模式扫描一个页面)覆盖模板级问题,或使用-C full在最终验收前进行全面爬取。
| 模式 | 默认页面数 | 用途 |
|---|---|---|
quick | 25 | 初步检查、CI 检查 |
surface | 100 | 模板级覆盖(每种模式采样一个页面,例如 /blog/{slug}) |
full | 500 | 最终验证、深入分析 |
实用标志:--refresh(忽略缓存,完整重新抓取)、--resume(继续中断的爬取)、-m <n>(页面数上限)、--verbose(显示详细进度)。
如果网站屏蔽未知爬虫(Shopify / Cloudflare),请使用重复的 -H "Name: Value" 标志传入 Web Bot Auth 标头。标头值属于机密信息,会在输出中隐藏。请参阅 https://docs.squirrelscan.com/guides/web-bot-auth
修复流程
- 呈现报告:分数、等级、按严重程度排序的主要问题。
- 提出修复方案:列出可以修复的问题,并在进行任何更改前向用户确认。
- 将问题对应到源文件:找到每项发现对应的模板、组件或内容文件。
- 分批修复:应用已获批准的修复。
- 重新审核(部署或更改内容后使用
--refresh),并展示修复前后的分数。 - 重复执行,直到达到目标,或只剩下需要判断的问题(例如“是否应该移除此链接?”)。将这些问题标记出来供用户审核,不要自行猜测。
每批修复后,验证项目仍能成功构建,且现有检查均通过。
分数目标
| 起始分数 | 目标 | 预期工作 |
|---|---|---|
| < 50 (F) | 75+ (C) | 大幅修复 |
| 50-70 (D) | 85+ (B) | 中等修复 |
| 70-85 (C) | 90+ (A) | 润色 |
| > 85 (B+) | 95+ | 微调 |
最终验收时应使用 -C full 完成爬取,因为快速扫描只会抽查部分网站页面。
规则包含级别(错误、警告、提示)和排名(1-10):优先修复错误,然后处理排名较高的警告。需要修改内容的发现,与需要修改代码的发现同等重要。失效链接通常需要人工决定(移除、替换或保留):请将其标记出来,不要自行猜测。
验证回归问题
与基线进行比较,以证明改进或发现回归:
squirrel report --diff <baseline-audit-id> --format llm
squirrel report --regression-since example.com --format llm
完成标准
完成意味着:所有错误均已修复;警告已修复,或已记录为需要人工审核;重新审核已确认有所改进;并且用户已看到修复前后的分数对比以及所有更改的摘要。定期重新审核,以保持网站健康。如果用户想分享结果,可提供已发布的报告(请参阅 squirrelscan 技能)。
报告格式
LLM 报告是一种紧凑的 XML/文本混合格式,经过优化以提高 token 效率:包含健康评分的摘要、按类别分组并附带受影响 URL 的问题、失效链接以及按优先级排序的建议。完整规范:OUTPUT-FORMAT.md