audit

概覽

什麼是 audit 技能？

audit 技能專為協助前端開發者與團隊系統性評估程式碼庫的技術品質而設計。它涵蓋五大關鍵領域的全面檢查：無障礙性（A11y）、效能、主題設計、響應式設計，以及反模式偵測。掃描完成後，會產生一份帶有評分（P0–P3 嚴重性）及可執行建議的報告，方便優先排序與規劃改進。

誰適合使用 audit？

此技能適合前端工程師、品質保證專員及產品團隊，適用於：

• 確保程式碼符合無障礙與效能標準
• 識別技術負債與反模式
• 準備合規審查或技術稽核
• 獲得可執行且優先排序的回饋，無需手動程式碼審查

audit 解決的問題

• 偵測常見無障礙問題（對比度、ARIA、鍵盤導航、語意化 HTML、替代文字、表單標籤）
• 標示效能瓶頸與低效率模式
• 強調主題設計與響應式設計的不足
• 揭露可能影響維護性與使用者體驗的反模式

使用說明

安裝步驟

1. 將 audit 技能加入專案：

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

2. 閱讀核心文件：

   • 從 SKILL.md 開始，全面了解 audit 的工作流程與需求。
   • 查看 README.md、AGENTS.md 與 metadata.json 以獲得更多背景資訊。
   • 探索 rules/、resources/、references/ 與 scripts/ 資料夾，了解支援檔案與自訂檢查。

執行 audit 前的準備

• 呼叫 $frontend-design： 確保設計原則與反模式被納入考量。請依文件說明遵循上下文收集協議。
• 若無設計上下文： 請先執行 $teach-impeccable 以建立基準。

執行審核

• audit 技能執行程式碼層級掃描，非設計評論。僅檢查可測量且可驗證的實作內容。
• 執行後，將收到詳細報告，包含嚴重性評分（P0–P3）及優先行動計畫。技能會記錄問題，但不會自動修正。

何時使用 audit

• 程式碼審查期間或重大版本釋出前
• 作為 CI/CD 流程的一部分，持續品質保證
• 準備無障礙或效能合規檢查時

常見問題

audit 技能會檢查什麼？

audit 技能會檢查無障礙問題（如對比度、ARIA、鍵盤導航）、效能瓶頸、主題一致性、響應式設計缺陷及程式碼反模式。

audit 會自動修正問題嗎？

不會，audit 會識別並記錄問題，提供評分報告與可行建議。修正需手動執行或搭配其他工具。

audit 適用於後端或非前端專案嗎？

不適用，audit 專注於前端程式碼庫，不適合後端或純伺服器端專案。

哪裡可以找到 audit 檢查的詳細資訊？

請開啟倉庫中的 Files 標籤，瀏覽 SKILL.md 及支援資料夾，了解詳細標準、評分指南與參考資料。