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/<domain>/ 下(可用 --out 或 WEBSITE_AUDIT_OUT 環境變數覆寫):
website-audit-<domain>-<date>.md:報告website-audit-<domain>-<date>.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 <path-to-run>.json 會從 JSON 重新產生 Markdown。
每個領域涵蓋的內容
詳細資訊、閾值和優先權規則位於 <skill-dir>/references/checks.md。簡而言之:
| 領域 | 方法 |
|---|---|
| 行動版佈局 | 每個頁面在 360 / 390 / 768 像素寬度下:橫向滾動、超出邊界的元素、viewport meta、點擊目標、過小的文字 |
| 錯誤 | 主控台錯誤與例外、4xx/5xx 與失敗的請求、混合內容、損毀的圖片、內部連結(HEAD/GET)、表單目標(僅 HEAD) |
| 無障礙性 | 將 axe-core 注入每個頁面,WCAG 2.0/2.1 A + AA 標籤 |
| 效能 | 首頁的 Lighthouse 行動版測試;每個頁面的瀏覽器時間(TTFB、LCP、CLS、頁面大小、請求數) |
| 轉換路徑 | 桌面版和手機版的首屏 CTA、點擊聯絡的次數、電子郵件/電話/預約/潛在客戶表單、見證、案例、標誌、數字 |
| SEO 基礎 | 標題、描述、一個 H1、Canonical 標籤、Open Graph、noindex、robots.txt、sitemap.xml |
規則
- 絕不提交、填寫或點擊表單;絕不登入;絕不繞過機器人防護或 CAPTCHA。如果網站提供驗證頁面,則回報該狀況並停止。
- 尊重 robots.txt 的禁止規則;保持預設延遲,除非使用者擁有該網站並要求更快的執行。
- 標記為「請手動檢查」的發現結果僅是假設,直到您檢視螢幕截圖為止。
- 請勿自行將報告發布到任何地方;它可能描述客戶的弱點。
非此技能
- 文案、定位與訊息傳遞評論 →
website-copy-reframe。 - 從網站產生的品牌/設計系統 →
design-system-generator。 - 關鍵字排名、反向連結、流量估算 → 使用 SEO 資料工具。