audit

概覽

什麼是 audit 技能？

audit 技能專為需要系統性檢查網頁介面技術品質的前端開發者與團隊設計。它針對無障礙、效能、主題設計、響應式設計及常見反模式進行程式碼層級的審核。該技能會產生一份評分報告，將問題從 P0（嚴重）到 P3（輕微）分級，並提供可行的改進建議。這使其非常適合希望符合無障礙標準、優化效能並維持高品質前端程式碼的專案。

誰應該使用 audit？

• 希望提升程式碼品質的前端開發者
• 準備無障礙或效能審查的團隊
• 目標符合 WCAG 及響應式設計最佳實踐的專案
• 需要在上線或重構前進行結構化技術審核的任何人

解決的問題

• 識別無障礙缺口（對比度、ARIA、鍵盤導航、語意 HTML、替代文字、表單）
• 標示效能瓶頸與反模式
• 檢查主題一致性與響應式設計問題
• 記錄問題以供後續處理，並不直接修改程式碼

使用說明

安裝步驟

1. 使用以下指令安裝 audit 技能：
   npx skills add https://github.com/pbakaus/impeccable --skill audit

初始設定

• 從 SKILL.md 檔案開始，了解 audit 工作流程的詳細說明。
• 閱讀 README.md、AGENTS.md 與 metadata.json 等輔助檔案以獲得背景資訊。
• 探索 rules/、resources/、references/ 與 scripts/ 等資料夾，取得更多指引與輔助腳本。

工作流程指引

• 執行 audit 前，先呼叫 /frontend-design 以收集設計背景並遵循背景收集協議。
• 若無設計背景，請先執行 /teach-impeccable。
• audit 技能會針對五大關鍵領域進行診斷掃描，並以 0（嚴重）到 4（優良）評分。
• 使用參數提示指定要審核的領域（例如 feature、page、component）。
• 該技能會記錄問題，但不會修正；修復請使用其他指令。

推薦預覽檔案

• SKILL.md（主要工作流程與評分標準）

常見問題

audit 技能會檢查什麼？

audit 技能會在程式碼實作層級檢查無障礙、效能、主題設計、響應式設計及反模式。它會為每個領域評分並產生帶有可行建議的報告。

audit 適合用於設計評審嗎？

不適合，audit 專注於技術程式碼品質。設計評審請使用 /frontend-design 或相關技能。

如何準備 audit？

透過 /frontend-design 遵循背景收集協議。若缺乏設計背景，請先執行 /teach-impeccable。

哪裡可以找到輔助腳本與參考資料？

開啟 Files 標籤，瀏覽完整檔案樹，包括巢狀參考與輔助腳本，以獲得更深入的背景資訊。