audit

概覽

什麼是 audit 技能？

audit 技能專為前端開發者與團隊設計，幫助系統性評估程式碼庫的技術品質。它會檢查無障礙性（A11y）、效能、主題一致性、響應式設計及常見反模式。此技能會產生帶有嚴重性評分（P0-P3）與可執行方案的評分報告，協助你優先改善並維持高標準。

誰適合使用 audit？

• 需要驗證程式碼品質的前端工程師
• 專注於無障礙性與效能的 QA 團隊
• 為合規或上線做準備的專案負責人
• 任何需要結構化程式碼層級審核（非設計評論）的人員

解決的問題

• 識別無障礙缺口（對比度、ARIA、鍵盤導航、語意 HTML、替代文字、表單）
• 標示效能瓶頸
• 強調主題與響應式設計問題
• 偵測反模式與技術負債
• 提供明確的嚴重性評分與後續步驟

使用說明

安裝步驟

1. 使用以下指令安裝 audit 技能：

   npx skills add https://github.com/pbakaus/impeccable --skill audit
   

2. 閱讀 SKILL.md 檔案，了解詳細指示與評分標準。

準備工作

• 執行 audit 前，先呼叫 /frontend-design 以收集設計脈絡與反模式。如無設計脈絡，請先執行 /teach-impeccable。
• audit 技能專注於可量化的技術面，並不會直接修正問題，而是記錄以供後續處理。

執行 audit

• 使用此技能掃描你的前端程式碼庫，檢查五大面向：
  • 無障礙性（A11y）
  • 效能
  • 主題
  • 響應式設計
  • 反模式
• 每個面向的評分範圍為 0（嚴重問題）至 4（優異合規）。
• 輸出為包含嚴重性評分（P0-P3）與可執行建議的完整報告。

檔案結構與檢視

• 從 SKILL.md 開始，了解工作流程與評分細節。
• 探索其他輔助檔案，如 README.md、AGENTS.md、metadata.json，以及 rules/、resources/、references/、scripts/ 等資料夾，獲取更多背景資訊。

常見問題

audit 適合用於設計審查嗎？

不適合。audit 技能是進行程式碼層級的技術檢查。設計評論請使用 /frontend-design 或相關技能。

audit 報告包含哪些內容？

報告涵蓋無障礙性、效能、主題、響應式設計與反模式，並依嚴重性排序與評分。

audit 可以自動修正問題嗎？

不行。audit 會記錄問題並提供可執行方案，需搭配其他技能或手動修正。

評分標準在哪裡？

評分細節與檢查清單記載於 SKILL.md。可開啟檔案標籤查看完整檔案結構與輔助腳本。

什麼時候該使用 audit？

建議於產品上線前、合規檢查時，或作為定期程式碼品質審核的一部分，確保前端符合技術標準。