py-modern

Installation
SKILL.md

Python 現代化與版本遷移

目標與邊界

用此 skill 升級 Python 版本、導入現代語法、改善 typing,並在不破壞既有行為的前提下移除過時寫法。

不要因為某功能存在於最新版 Python,就直接套用到最低版本較舊的專案。若任務主要是依賴、wheel、PyPI 或鎖定檔,改以 py-packaging 為主。

執行流程

  1. 盤點版本契約:讀取 pyproject.toml、.python-version、Dockerfile、CI matrix、type checker 與部署環境。
  2. 建立行為基準:先執行測試;缺少測試時,為公開 API、序列化格式與 CLI 行為補 characterization tests。
  3. 選擇最低語法版本:以實際 requires-python 為準,不以開發機版本為準。
  4. 分批遷移:先處理 deprecation 與相容性,再導入新語法,最後才評估 free-threaded 或 JIT。
  5. 執行靜態與動態驗證:至少執行 compile、lint、type check、test 與目標版本矩陣。
  6. 記錄破壞性變更:列出升級前置條件、回復方式與仍未驗證的第三方套件。

版本決策指南

Installs
2
GitHub Stars
1
First Seen
May 8, 2026