Python Code Review with Modern Typing

此技能作為專門的程式碼審查代理，專注於執行嚴格的 Python 型別安全。它專為旨在透過採用 Python 3.12+ 型別註解慣例來現代化其 Python 程式碼庫的開發人員、軟體工程師和自動化 CI 管線而設計。主要目標是消除函式簽章、類別屬性和變數宣告中的模糊性，減少因型別不匹配而導致的執行時期錯誤，並改善 IDE 自動完成和靜態分析效能。

• 系統化審查函式簽章，確保所有參數和回傳型別都已明確註解。

• 強制執行現代內建泛型型別，將舊有的 typing 模組導入（如 List、Dict、Set 和 Tuple）替換為原生的全小寫替代方案。

• 將聯集與選擇性型別轉換為現代語法，特別是使用 | 運算子處理聯集，以及使用 X | None 處理選擇性值。

• 驗證複雜類別屬性型別和內嵌變數註解，以確保全面的型別覆蓋。

• 與靜態分析工具（如 mypy）整合，特別支援 pyproject.toml 中的 --strict 設定。

• 識別已棄用的 typing 模組模式，以防止技術債並確保程式碼具備未來擴充性。

• 非常適合在提取請求 (Pull Request) 審查、重構期間或作為合併前檢查使用，以驗證型別完整性。

• 輸入需求包含原始 Python 程式碼或待審查的檔案路徑；該技能會根據目前的型別標準產生具體的修正建議。

• 它優先考量嚴格遵守 PEP 標準，特別針對移除舊有的型別構造，轉而採用 Python 近期版本中引入的語言原生泛型語法。

• 請注意，此技能刻意忽略高階架構或效能邏輯，僅專注於型別宣告的精確度，以建立穩健的程式碼合約。