py-modern
Installation
SKILL.md
Python 現代化與版本遷移
目標與邊界
用此 skill 升級 Python 版本、導入現代語法、改善 typing,並在不破壞既有行為的前提下移除過時寫法。
不要因為某功能存在於最新版 Python,就直接套用到最低版本較舊的專案。若任務主要是依賴、wheel、PyPI 或鎖定檔,改以 py-packaging 為主。
執行流程
- 盤點版本契約:讀取
pyproject.toml、.python-version、Dockerfile、CI matrix、type checker 與部署環境。 - 建立行為基準:先執行測試;缺少測試時,為公開 API、序列化格式與 CLI 行為補 characterization tests。
- 選擇最低語法版本:以實際
requires-python為準,不以開發機版本為準。 - 分批遷移:先處理 deprecation 與相容性,再導入新語法,最後才評估 free-threaded 或 JIT。
- 執行靜態與動態驗證:至少執行 compile、lint、type check、test 與目標版本矩陣。
- 記錄破壞性變更:列出升級前置條件、回復方式與仍未驗證的第三方套件。