low-complexity

low-complexity 技能是一款專業的開發工具，旨在開發環境或編碼代理工作流程中自動執行程式碼品質標準。它專注於 SonarSource 的認知複雜度指標與標準循環複雜度，確保每一個函式、方法、類別或模組都維持在可管理的範圍內。此技能針對軟體工程師、技術主管以及實踐 Clean Code 方法論的團隊，目標是在程式碼進入儲存庫之前，就預防技術債與複雜邏輯的產生。

• 在不需明確觸發的情況下，自動監控每一項程式碼修改、編寫與重構任務。

• 強制執行嚴格的複雜度閾值：維持認知與循環複雜度低於 5，並針對複雜邏輯設定 15 的絕對上限。

• 提供業界標準的簡化技術指引，包含函式提取、提前返回 (early return)、防禦性程式碼 (guard clauses)，以及將巢狀迴圈替換為宣告式管線或函數式程式設計模式。

• 支援所有程式語言與框架，使其成為適用於任何現代開發堆疊的通用約束規範。

• 內建邏輯評估速查表，協助開發人員在編碼過程中進行複雜度心算。

• 使用方式為將其安裝至你的 Agent CLI 環境中。它會在執行程式碼產生、功能實作、錯誤修復或重構時自動啟動。

• 當複雜度超過建議上限時，Agent 將會提供具體、可操作的重構步驟以簡化邏輯。

• 優先順序建議：優先考慮方法提取，接著是提前返回，再者是扁平化巢狀條件，並利用現代程式語言特性如 Optional chaining、空值合併運算子 (null-coalescing) 及模式匹配。

• 適用於任何涉及高邏輯性組件、複雜 API 處理程序或關鍵業務服務層的任務，其中程式碼的可讀性與可測試性至關重要。

• 請注意，儘管 Lambda 通常是被允許的，但它們會增加巢狀深度，因此本技能鼓勵保持閉包的淺層結構，以避免結構性複雜度懲罰。