Unlighthouse 全站审计
用本地 Unlighthouse 一次审计网站多条 URL，汇总性能、可访问性、最佳实践与 SEO 结果。
该技能说明使用本地 Unlighthouse CLI、url_safety 预检和子进程超时管理，且默认无需 API 密钥，体现了较好的本地化和权限控制；但未在本技能文件中明确说明请求范围、用户确认、重定向/外部副作用、报告清理或失败后的恢复机制，因此扣 8 分。
路由、设备参数、最大路由数、输出文件和跨技能分工均有一致描述；但脚本、安装过程、超时异常、无效 URL、依赖缺失及 Unlighthouse 失败时的诊断反馈未提供，静态证据不足，因此扣分并受静态上限约束。
目标场景清晰，包括站点级 Lighthouse、移动/桌面审计、路由上限和持久化输出；但未明确不适用场景、输入约束、完整参数语义、中文输出支持，也未说明 npm 依赖在中国大陆网络环境下的可达性，因此扣 5 分。
技能文件具有名称、版本、兼容性、前置条件、路由表、输出字段和跨技能委派说明；但文档缺少示例输出、故障排查、限制说明、维护责任、更新路径和变更记录，因此扣 6 分。MIT 许可和仓库级版本/维护信息可提供部分补充。
文档定义了多 URL 审计、聚合指标、逐路由 JSON 和 HTML 报告，核心结果格式具有直接可用性；但没有该技能专属的已验证输出或关键路径执行证据，且报告完整性、性能成本和与替代方案的实际收益仍主要依赖声明，因此按静态上限扣分。
技能文件给出了可审计的输出文件名、字段和脚本入口，仓库还提供 CI 与测试存在的间接证据；但所给测试未直接覆盖 Unlighthouse 技能关键路径，缺少该技能专属的可复现实例和第三方交叉佐证，因此扣分。
- 审计会对目标站点执行多 URL 请求；在运行前应确认目标范围、请求负载和授权，尤其是第三方或不受信任站点。
- 必须确认 extensions/unlighthouse/install.sh、scripts/unlighthouse_run.py、Node 18+ 和 unlighthouse npm 包在目标环境中实际可用；当前材料未给出该路径的专属测试或失败示例。
- 默认报告写入临时目录，持久化模式可写入指定目录；应明确敏感页面数据的保存、访问和清理策略。
- 核心依赖 npm 包获取，文档未说明中国大陆网络不可达时的镜像、离线安装或替代方案。
这个 Skill 能做什么，适合哪些场景？
这是 claude-seo 仓库中的单项技能，用 MIT 许可的 Unlighthouse CLI 对网站多条 URL 运行 Lighthouse 审计。它适合在 PageSpeed Insights 免费额度不足、需要本地或离线实验室测量，或部署后进行快速全站回归检查时使用。技能默认最多审计 200 条路由，并生成 JSON 与 HTML 报告。它只负责多页面 Lighthouse 汇总，不应被视为整个 claude-seo 集合的完整 SEO 审计工具。
运行 extensions/unlighthouse/install.sh 预热依赖后，通过 scripts/unlighthouse_run.py 执行 Unlighthouse；执行 URL 安全预检并管理子进程超时；读取输出目录中的 ci-result.json；返回解析后的聚合结果，包括性能、可访问性、最佳实践和 SEO 分数，其中性能分数为已审计路由的中位数；同时保留逐路由明细以及 JSON/HTML 报告。
- SEO 或工程团队需要在 PageSpeed Insights 免费额度不足时，对大型网站进行多页面实验室审计。
- 开发团队在部署后需要快速检查网站范围内的性能回归。
- 受限环境或 CI 流程需要本地运行的 Core Web Vitals 实验室测量。
- 网站负责人希望将审计路由数限制为 50 条，并把报告持久化到指定目录。
这个 Skill 有哪些优点和局限？
- 本地运行，不需要 API key，也不会消耗 PageSpeed Insights 配额。
- 可以对多条路由执行统一审计，并提供聚合分数与逐路由明细。
- 支持移动端、桌面端、最大路由数和输出目录配置。
- 适合 CI、受限环境和部署后的快速回归检查。
- SKILL.md 没有说明完整的 unlighthouse npm 安装版本或具体安装参数。
- 结果是 Lighthouse 实验室数据；技能本身不提供单 URL 的 CrUX 现场数据。
- 默认最多审计 200 条路由，大型网站需要自行调整上限并考虑运行时间。
- 依赖 Node.js、Unlighthouse、Shell 和本地文件系统；实际审计 URL 通常需要网络访问。
如何安装这个 Skill？
在 claude-seo 仓库中执行：bash extensions/unlighthouse/install.sh。需要 Node.js 18+ 位于 PATH 中，且需要 unlighthouse npm 包；不需要 API key。
如何使用这个 Skill？
使用 /seo unlighthouse <url> 运行移动端审计，默认最多 200 条路由，并将 JSON 与 HTML 报告写入临时目录。可使用 /seo unlighthouse <url> --device desktop 运行桌面端审计，或使用 /seo unlighthouse <url> --max-routes 50 --output-dir ./reports 限制路由数并保存报告。单 URL 的 CrUX 或 PageSpeed 工作流应交给 seo-google psi / seo-google crux；慢页面的 LCP 子部分分解使用 scripts/lcp_subparts.py 工作流。
这个 Skill 与同类方案有什么区别？
相较于逐个调用 PageSpeed Insights，这项技能在本地对多条路由运行 Lighthouse，不消耗 PageSpeed Insights 的免费 API 配额；相较于单 URL 的 seo-google psi / seo-google crux 工作流，它更侧重全站路由覆盖与聚合报告，而不是单页现场数据。