Communitygithub.com

網站稽核

對線上 B2B 網站進行唯讀的技術與轉換稽核,作為重建前的快照。爬取最多 N 個同源頁面(預設 10 個),並檢查行動版佈局、錯誤、無障礙性、效能、轉換路徑與 SEO 基礎。

網站稽核 是什麼?

此技能提供一個唯讀的網站稽核,專門設計用於在 B2B 網站重建前建立效能與技術的快照。它會在無頭 Chrome 中爬取最多 10 個(可配置)同源頁面,並在 360、390 和 768 像素寬度下測試行動版佈局。稽核會產生一份詳細的 Markdown 報告,包含每個領域(行動版佈局、錯誤、無障礙性、效能、轉換路徑、SEO)的評分,並按嚴重性(P0 到 P3)標記發現的問題,指出問題所在、位置、為何導致潛在客戶流失以及如何修復。它利用 axe-core 進行無障礙性檢查(WCAG 2.1 A/AA)、Lighthouse(若可用)進行效能測試,並在整個過程中尊重 robots.txt。此技能在多地點(Claude Code、Cursor、Codex)運行,並需要 Node.js 22+、Chrome/Chromium 及對該網站的網路存取。輸出包括 Markdown 報告、原始 JSON 和螢幕截圖,可作為重建後比較的基準線。

相容平台✓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/<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:

  1. 針對每個 P0 項目,根據其證據進行確認(腳本是字面執行的;機器人防護或 JavaScript 表單可能偽造 P0)。
  2. 透過檢視 screens/ 中的螢幕截圖,解決每個「請手動檢查」的項目。
  3. 確保「優先修復」的內容看起來像是重建的第一個衝刺。

直接編輯 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 資料工具。

相關技能