python

此技能作為一套完整的 Python 開發指南，旨在簡化現代 Python 專案的編碼、重構與程式碼審查工作流程。它透過強制執行嚴格的風格規範與慣用語法，確保程式碼的可靠性與可維護性。透過直接整合至 Agent 的開發循環中，協助開發者在小型腳本到複雜應用程式的各類專案中維持一致的標準。

• 強制執行 PEP 8 風格標準，包括 88 字元的行長限制與標準化的導入排序。

• 利用 py_compile 進行自動化語法驗證，並透過 pytest 或 unittest 執行強健的測試流程。

• 優先使用高效能的 uv 套件管理器來管理依賴，並同時提供 pip 作為備援。

• 推廣現代 Python 3.10+ 功能，例如類型提示 (Type hints)、match 陳述式、海象運算子 (Walrus operator) 與 dataclasses。

• 實作最佳實踐模式，如 EAFP (更易於請求原諒而非許可) 與適當的資源上下文管理。

• 標註必須避免的關鍵反模式，例如可變預設參數、空的 except 區塊與全域狀態的使用。

• 適用於專注於 Python 後端開發、腳本自動化與工具開發的軟體工程師與 AI Agents。

• 典型的使用情境包括在程式碼生成階段呼叫此技能，以確保符合專業編碼標準。

• 支援使用 uv init 進行快速專案初始化與虛擬環境管理。

• 要求開發者遵循文件化的 docstring 格式，以提升可維護性與 IDE 整合度。

• 對於希望在內部儲存庫中強化程式碼品質、格式標準化與安全依賴實踐的團隊來說至關重要。