Global Coding Style

Global Coding Style 技能為維護乾淨、可維護且高品質的軟體架構提供自動化指導。它強制執行務實開發哲學，確保代碼是為了當前且經證實的需求而編寫，而非為了臆測性的未來抽象。此技能適用於在複雜代碼庫中工作的軟體工程師與自動化代理，旨在確保結構完整性與代碼清晰度。透過刪除無效代碼、明確命名規範，以及確保所有邏輯都有嚴謹的單元與整合測試支持，進而減少技術債。

• 強制所有函數與模組遵循單一職責原則，以提高可測試性與可讀性。

• 整合 Black、Ruff、Prettier 與 ESLint 等格式化工具與 Linter，維護專案級別的風格一致性。

• 推廣使用防禦性守衛條款（Guard Clauses）來儘早處理無效狀態，簡化函數流程並降低嵌套條件的複雜度。

• 協助在代碼註解中明確記載設計取捨與非顯而易見的實作決策。

• 管理遺留代碼的生命週期，針對何時維護向後相容性與何時進行清理刪除提供經驗法則。

• 要求所有副作用（如 I/O 操作或狀態變更）必須顯式處理，而非隱藏於複雜的業務邏輯中。

• 提供系統化指導以避免臆測性抽象，確保所有功能的實作皆基於已驗證的執行需求或規格。

• 在初始實作、代碼審查與大規模重構期間使用此技能，以確保符合架構標準。

• 輸入：代碼片段、架構設計文件，或需要審查可讀性與複雜度的 PR 變更內容。

• 輸出：重構代碼建議、命名改進、刪除多餘導入或不可達代碼，以及設計基礎的文檔化。

• 最適用於使用 FastAPI、SQLAlchemy 或非同步 Python 框架的環境，在這些環境中，代碼清晰度對長期維護至關重要。

• 約束條件：始終優先考慮現有的測試覆蓋率；若重構決策可能破壞既有的單元測試，請在最終確定前使用 pytest 等工具執行回歸測試。