format

此技能提供了一種非破壞性的方式來驗證項目代碼質量，整合了業界標準的 linting 和格式化工具。專為開發人員和自動化 CI/CD 流程設計，它在不修改底層文件的情況下，分析代碼庫中是否存在樣式不一致或規則衝突。通過執行預定義的 Prettier 和 Stylelint 配置，該代理能識別整個存儲庫中的格式差異、語法問題和樣式衝突。

此技能作為代碼質量的守門員，提供代碼庫健康狀況的簡明摘要。當檢測到問題時，它會報告前三個錯誤並建議具體的修復命令（例如 format-fix 技能）。這有助於在防止自動格式化工具在敏感環境中產生意外副作用的同時，維持一個整潔、可讀且統一的代碼庫。

• 使用 Prettier 進行通用代碼格式化驗證，並使用 Stylelint 進行 CSS/SCSS 架構檢查。

• 生成簡明的狀態報告，指示驗證成功（OK）或發現具體問題。

• 識別最關鍵的前三個格式或 linting 違規事項，幫助開發人員優先處理問題。

• 如果發現錯誤，會主動建議下一步操作，引導用戶調用 format-fix 技能。

• 專為 Pull Request 審查、預提交工作流或本地開發檢查而設計，確保代碼樣式符合規範。

• 此技能假設項目存儲庫已在 package.json 文件中正確配置了 Prettier 和 Stylelint。

• 觸發方式是執行已配置的 shell 腳本，針對項目源代碼進行檢查。

• 輸出是顯示在代理界面中的文本摘要，若檢查失敗則列出發現的總問題數。

• 此工具嚴格為唯讀模式；它僅執行分析，不會寫入或覆蓋任何項目文件。

• 強烈建議在合併任何代碼變更之前運行此檢查，以確保團隊間代碼縮排、分號使用和 CSS 屬性順序的一致性。