技能 web-performance-seo
📦

web-performance-seo

安全

修復 Lighthouse 可存取性對比度錯誤

此技能修復因色彩對比度失敗導致的 PageSpeed Insights 和 Lighthouse 可存取性錯誤。它會掃描觸發可存取性審核失敗的 CSS 模式,並提供經過驗證的修復模式以改善您的 SEO 效能。

支援: Claude Codex Code(CC)
🥉 74 青銅
1

下載技能 ZIP

2

在 Claude 中上傳

前往 設定 → 功能 → 技能 → 上傳技能

3

開啟並開始使用

測試它

正在使用「web-performance-seo」。 我的網站在 Lighthouse 可存取性中顯示「!」而非分數

預期結果:

「!」表示審核失敗。常見原因包括:CSS backdrop-blur 或 filter、OKLCH/OKLAB 色彩、低透明度背景(< 0.4)、具有透明色彩的漸層文字,或沒有遮罩層的圖片上文字。建議使用以下命令掃描您的程式碼庫:`rg -n "backdrop-blur|filter:|mix-blend-mode" .` 以及類似命令來識別有問題的模式。

正在使用「web-performance-seo」。 我如何為可存取性修復 CSS 中的 OKLCH 色彩?

預期結果:

將 OKLCH 轉換為 HSL 或 RGB。例如,`--primary: oklch(0.55 0.22 264);` 變為 `--primary: hsl(250, 60%, 50%);`。使用色彩挑選器或工具來匹配視覺外觀,同時使用 Lighthouse 可以正確分析的標準色彩空間。

安全審計

安全
v1 • 2/24/2026

Static analysis detected external_commands patterns and weak cryptographic algorithms. Evaluation reveals these are FALSE POSITIVES. The 'external_commands' are CLI command examples in markdown documentation (ripgrep commands for code scanning), not executable code. The 'weak cryptographic algorithm' detections are OKLCH/OKLAB CSS color space specifications misidentified as crypto algorithms. This skill provides documentation and code patterns for fixing accessibility contrast issues - no security risks present.

1
已掃描檔案
93
分析行數
2
發現項
1
審計總數
中風險問題 (1)
Documentation CLI Commands Detected
Static scanner detected 'external_commands' patterns in markdown code blocks. These are CLI command examples (ripgrep) shown as documentation for users to run on their own code, not executable code within the skill itself.
低風險問題 (1)
OKLCH/OKLAB Color Space Misidentified as Crypto
Static scanner flagged 'weak cryptographic algorithm' at lines 3 and 23. This is a FALSE POSITIVE - OKLCH/OKLAB are CSS color space specifications (CSS Color Level 4), not cryptographic algorithms.
審計者: claude

品質評分

38
架構
100
可維護性
87
內容
50
社群
98
安全
91
規範符合性

你能建構什麼

修復失敗的可存取性審核

當 Lighthouse 在可存取性區塊顯示「!」而非分數時,使用此技能識別並修復導致失敗的 CSS 模式。

透過可存取性改善 SEO

可存取性是排名因素。使用此技能修復對搜尋引擎排名產生負面影響的對比度問題。

可存取性程式碼審查

在部署前審查 CSS 和元件的可存取性問題,及早發現對比度問題。

試試這些提示

基本對比度修復請求
我的 Lighthouse 可存取性審核顯示「!」而非分數。color-contrast 審核失敗。請協助我識別並修復導致此問題的 CSS 模式。
OKLCH 色彩轉換
我在 CSS 中使用 OKLCH 色彩,它們在 Lighthouse 中導致可存取性問題。請展示如何將 OKLCH 轉換為可存取的 HSL 或 RGB 替代方案。
漸層文字可存取性
我的網站使用漸層文字,但 Lighthouse 標記了 color-contrast 問題。請提供具有適當色彩備用方案的漸層文字模式,以通過可存取性審核。
圖片上的文字覆蓋
我在圖片上有文字,對比度未能通過可存取性審核。請展示添加遮罩層以確保足夠對比度比率的正確模式。

最佳實務

  • 部署前務必在本機使用 Lighthouse 或 axe 測試
  • 將背景透明度提高到 0.4 或更高(建議 0.6+)
  • 使用 forced-colors 媒體查詢以支援 Windows 高對比度模式
  • 驗證對比度比率符合正常文字 4.5:1 和大文字 3:1 的要求

避免

  • 使用 CSS filter 或 backdrop-blur 而未檢查可存取性影響
  • 使用 OKLCH/OKLAB 色彩而未在 Lighthouse 中測試
  • 在漸層背景上將文字色彩設為透明
  • 將文字直接放置在圖片上而沒有適當的遮罩層

常見問題

Lighthouse 可存取性中的「!」是什麼意思?
「!」表示可存取性審核完全失敗且無法計算分數。這通常發生在 Lighthouse 無法分析某些 CSS 模式(如 filter 或色彩空間)時。
此技能可以為我執行 Lighthouse 測試嗎?
不會。此技能提供指導和程式碼模式。您需要自行執行 Lighthouse 或 PageSpeed Insights 來驗證修復。
為什麼 OKLCH 色彩會導致問題?
Lighthouse 使用 getImageData 分析色彩,對 OKLCH 和 OKLAB 等新 CSS 色彩空間的支援有限。轉換為 HSL 或 RGB 可確保準確分析。
什麼透明度等級對可存取性是安全的?
使用 0.4 或更高的背景透明度。建議 0.6 或更高以獲得更好的對比度。Tailwind 類別如 /10 和 /20 太低;請使用 /40、/60 或更高。
修復可存取性真的有助於 SEO 嗎?
是的。可存取性是 Google 排名因素。具有更好可存取性分數的網站在搜尋結果中可能表現更好。
如何在部署前在本機測試修復?
使用 Chrome DevTools 中的 Lighthouse 或 axe 瀏覽器擴充功能。在部署到生產環境前在本機執行測試以驗證修復。

開發者詳情

檔案結構

📄 SKILL.md