clean-comments

此工具作為原始程式碼的智慧清理助手，旨在透過移除檔案中的雜訊來提升維護性。在現代軟體開發中，過多或多餘的註解會分散開發者對實際邏輯的注意力，且經常會因程式碼更新而過時。此技能強制執行「程式碼即文件」的哲學，確保註解僅用於澄清複雜的業務邏輯、邊緣案例或非顯而易見的架構決策，而非重述簡單的語法操作。

本工具特別適合準備 Pull Request、進行團隊代碼審查或執行儲存庫重構的工程師。透過分析註解背後的意圖，它能選擇性地移除顯而易見的描述，同時嚴格保護有價值的上下文，例如效能評估、錯誤報告引用（如 issue #1234）或關鍵的遷移警告。它鼓勵開發者撰寫更簡潔、具自我說明性的程式碼，進而減輕閱讀儲存庫人員的認知負荷。

• 自動識別並移除重述程式碼執行過程的多餘內聯註解。

• 保留高價值的上下文，包括決策點、複雜演算法細節與非直觀的實作說明。

• 將冗長的文件區塊濃縮為簡潔的單行說明，強調「為什麼」而非「是什麼」。

• 過濾掉已完成任務的過時 TODO 或 FIXME 註解。

• 支援單次處理最多 15 個檔案，以確保審查週期可管理且具預測性。

• 建議在預審階段使用，以確保審查者專注於邏輯而非文件雜訊。

• 應信任可讀性高的程式碼作為主要文件；僅在程式碼意圖無法被新開發者推斷時才添加註解。

• 進行簡化時，優先解釋業務邏輯或架構限制，而非變數命名慣例。

• 本工具設計旨在與現代儲存庫結構無縫銜接，包括 TypeScript、Python 及其他複雜單體儲存庫中的常見語言。

• 限制：此過程嚴格致力於提升清晰度；建議始終檢查工具建議，確保團隊特定的關鍵文件未被誤刪。