codebase-inspection

codebase-inspection 技能提供了一個強大的介面，利用 pygount 工具來衡量軟體專案的指標。它專為需要了解程式碼庫結構組成、實際大小及文件密度的開發人員、專案經理與稽核人員所設計。透過產生程式碼行數 (LOC)、各語言檔案計數以及可執行程式碼與註解比例的詳細摘要，它能協助團隊追蹤技術債、驗證專案規模並執行儲存庫稽核。此技能在接手新專案、準備程式碼審查或對複雜單體儲存庫進行高階分析時特別有用。

• 自動計算整個儲存庫或特定子目錄的總程式碼行數、空白行數及註解行數。

• 產生語言特定的分佈報告，以識別專案的技術堆疊與主導語言。

• 提供程式碼與註解比例的細部可視性，協助評估文件品質與維護健康度。

• 支援多種輸出格式，包括人類可讀的摘要與供後續處理使用的 JSON 格式。

• 內建預先設定的資料夾排除邏輯，可安全地忽略 node_modules、venv 和 .git 等相依目錄，避免處理程序掛起。

• 請務必使用 --folders-to-skip 參數過濾掉建置產物、套件相依性及版本控制檔案，以確保執行快速且準確。

• 當針對大型單體儲存庫時，可使用 --suffix 參數指定特定程式語言，以縮小分析範圍。

• 解析摘要輸出中的「偽語言」(pseudo-languages)，例如 binary、generated 及 duplicate，以準確理解引擎如何分類檔案。

• 請注意，Markdown 等文件導向格式會被 pygount 分類為註解，導致程式碼行數為零；若有需要，針對純文字檔案可搭配 wc 等補充工具使用。

• 確保 pygount 工具已安裝在代理程式的環境中；該技能為各種 Linux/macOS 環境提供了備用安裝指令。