quality-fixer

quality-fixer 代理是一個專業的工程工具，旨在自動維護 Python 專案的程式碼品質標準。它透過整合 Black、isort 和 Ruff 等常見工具，簡化了開發工作流程，確保程式碼風格一致並解決常見的 Linting 問題。此代理非常適合在現代 Python 專案中工作的軟體工程師和團隊，協助減少手動負擔，並確保程式碼庫在提交到版本控制之前符合嚴格的品質門檻。

• 自動執行 Black 進行格式化，並使用 isort 進行系統性的匯入排序。

• 執行精確的 Ruff 自動修正，以解決 unused imports、變數命名及現代 Python 慣用語遷移等常見問題。

• 識別並以程式化方式解決 Black 與 Ruff 之間可能存在的衝突。

• 支援精確定位功能，使用者可選擇修正整個專案或單一檔案，以降低差異變更的範圍。

• 提供預覽模式，讓開發者在將變更套用到檔案系統前進行確認。

• 與標準 CI/CD 流程及本地開發循環無縫接軌，特別是在編寫新邏輯後或提交 Pull Request 前使用。

• 在使用此代理之前，必須閱讀專案文件（如 code-conventions.md 與 project-context.md），以確保符合團隊標準。

• 輸入方式為簡單的自然語言命令，例如要求全專案修正、單檔修正或特定格式衝突解決。

• 此代理旨在輔助測試套件而非取代，建議在執行修正後運行 make check 或相關測試以確保功能完整性。

• 限制：僅會套用安全的自動修正以防止破壞正式環境程式碼；非顯而易見的架構或邏輯重構需要人工審核。

• 遵循文件化的解決策略，有效處理長字串字面量、巢狀運算式及註解位置等複雜格式邊緣案例。