Communitygithub.com

Xza2792/ui-ux-audit-skill

使用 AI 審查網頁和行動 UI 程式碼,在部署前偵測版面錯誤、回應式設計問題及設計系統偏差。

ui-ux-audit-skill 是什麼?

這個技能專為開發人員與 AI 代理人設計,用於自動化 UI/UX 程式碼審查流程。它能夠分析網頁和行動應用程式的原始碼(例如 HTML、CSS、框架組件),並找出常見的佈局失敗、回應式設計錯誤以及設計系統不一致等問題。主要支援的平台包括 Claude Code、Cursor 和 Codex 等 AI 編碼工具。透過與 CI/CD 流程整合,你可以在部署前及早發現視覺回歸問題,確保使用者體驗的一致性。此技能運用 AI 模型來模擬設計系統規則,並比對實際實作與設計規範之間的差距,從而幫助團隊減少手動回歸測試的時間與成本。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add Xza2792/ui-ux-audit-skill

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

ui-ux-audit-skill 是做什麼的?

使用 AI 審查網頁和行動 UI 程式碼,在部署前偵測版面錯誤、回應式設計問題及設計系統偏差。

概述

這個技能能夠自動化 UI/UX 程式碼審查流程,透過分析原始碼來找出常見的 UI 問題,例如版面錯位、元素重疊、斷點錯誤、色彩不一致以及間距破損等。它支援多種框架,包括 React、Vue、Angular、Flutter 和 SwiftUI,並且可以整合到你的開發工作流程中。

使用方式

在支援的 AI 編碼工具(例如 Claude Code、Cursor 或 Codex)中,你可以呼叫此技能來分析指定的檔案或目錄。它會產生一份詳細的審查報告,列出問題的檔案、行號、嚴重程度以及建議的修正方式。

範例

# 審查整個專案
ui-ux-audit ./src

# 指定單一檔案
ui-ux-audit ./src/components/Button.tsx

支援的平台

  • Claude Code:作為自訂技能載入
  • Cursor:透過 rules 整合
  • Codex:作為外掛程式執行

設定

你可以透過環境變數或組態檔來調整技能的行為:

變數名稱說明預設值
UI_AUDIT_STRICT啟用嚴格模式,偵測所有小問題false
UI_AUDIT_DESIGN_TOKENS設計 token 檔案的路徑./design-tokens.json
UI_AUDIT_BREAKPOINTS回應式斷點設定(以逗號分隔)576,768,992,1200

如何運作

  1. 技能會掃描目標檔案,解析其結構與樣式。
  2. 比對設計系統規則(如果已設定)找出偏差。
  3. 模擬不同螢幕尺寸,測試回應式行為。
  4. 產生可讀的報告,包含問題描述與修復建議。

貢獻

歡迎提交問題與合併請求!請先閱讀 CONTRIBUTING.md 以了解貢獻指南。

授權

本專案採用 MIT 授權條款。

相關技能