audit

概覽

什麼是 audit 技能？

audit 是一款專門用於系統性檢查前端程式碼品質的工具。它聚焦於五大重點領域：無障礙、效能、主題設計、響應式設計與反模式。此技能會產生帶有嚴重性評分（P0–P3）的報告，並提供可行的修正方案。非常適合希望確保網站無障礙、效能優化及整體前端品質的團隊使用。

誰適合使用 audit？

audit 適用於前端開發者、UI/UX 設計師及技術主管，幫助他們評估並記錄網頁介面的品質。特別適合在開始修正或深入設計審查前，取得清晰且客觀的程式碼層級審核結果。

解決的問題

• 識別無障礙缺失（例如對比度、ARIA、鍵盤導航）
• 標示效能瓶頸
• 檢查主題一致性
• 評估響應式設計實作
• 偵測常見前端反模式

使用說明

安裝步驟

1. 安裝 audit 技能：
   使用以下指令將技能加入專案：

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

2. 檢視重要檔案：

   • 從 SKILL.md 開始，了解完整技能概述與使用說明。
   • 查閱 README.md、AGENTS.md 與 metadata.json 以獲得輔助文件。
   • 探索 rules/、resources/、references/ 與 scripts/ 資料夾，取得更多背景資訊與輔助腳本。

執行審核

• 準備工作：
  • 先執行 /frontend-design 以收集設計上下文，確保反模式與原則已載入。
  • 若無設計上下文，請依技能文件指示執行 /teach-impeccable。
• 執行審核：
  • 使用相關參數（如功能、頁面或元件名稱）執行 audit 技能。
  • 技能將掃描程式碼庫，輸出包含分數與嚴重性等級的 JSON 報告。
• 後續步驟：
  • 利用產生的報告來優先處理修正事項。audit 技能會記錄問題，但不會自動修復。

何時使用 audit

• 重大版本發布或程式碼審查前
• 新專案或團隊加入時
• 作為持續整合流程中的前端品質保證

常見問題

audit 技能會檢查什麼？

audit 技能會系統性檢視前端程式碼中的無障礙、效能、主題設計、響應式設計與反模式，並輸出帶有嚴重性評分及可行建議的報告。

audit 會自動修復問題嗎？

不會，audit 會識別並記錄技術問題，但不會自動修復。請依報告指引，使用其他工具或手動更新進行修正。

audit 適合用於設計評審嗎？

不適合，audit 著重於程式碼層級、可量化的前端品質面向。設計評審請搭配其他技能或工作流程。

哪裡可以找到更多細節？

請在倉庫的 Files 標籤中瀏覽所有輔助文件，包括巢狀參考資料與輔助腳本。建議從 SKILL.md 開始，獲得最相關的指引。