python-uv

uv 技能提供關於使用 Astral 開發之 uv 工具的專業指引，這是一個以 Rust 編寫的高效能 Python 套件與專案管理工具。其速度比傳統 pip 工作流程快 10 至 100 倍，使 Claude 能夠協助處理從專案初始建立、生產環境 Docker 部署到 CI/CD 管線整合的整個開發生命週期。

• 透過 uv init 簡化專案初始化，自動產生包含 pyproject.toml 與 .python-version 檔案的標準結構。

• 提供先進的相依性管理工作流程，可進行新增、移除與同步套件，並以單一、高速的介面取代 pip、pip-tools 與 poetry。

• 使用 uv run 進行高效率執行，無需手動啟用虛擬環境，系統會自動處理環境同步。

• 具備 Python 版本管理功能，允許使用者透過 uv python 指令輕鬆安裝、列出與切換多種 Python 版本。

• 原生工具管理機制，可取代 pipx 在隔離環境中安裝、執行與升級如 ruff、black 與 pytest 等 CLI 工具。

• 透過 uv pip 介面保持與舊有系統的相容性，可直接將現有的 requirements.txt 檔案遷移至現代化的 uv 管理結構中。

• 當您需要啟動新專案、最佳化現有相依性鏈或解決複雜的 Python 環境問題時，請使用此技能。

• 極力推薦用於 CI/CD 設定中，特別是當可重現的構建與鎖定版本對生產穩定性至關重要時。

• Claude 可以利用此技能產生最佳化的生產用 Dockerfile，藉由 uv 的高效快取與同步機制，確保映像檔體積最小化並縮短建置時間。

• 請一律使用 uv run 來執行指令碼與工具，因為這能確保環境即時更新，並避免手動啟用 venv 常見的問題。

• 請記住 uv 會透過 uv.lock 檔案建立確定性的環境；為了確保專案可攜性，請務必將此檔案納入版本控制。

• 當從舊工具進行遷移時，本技能提供明確的工作流程，協助您匯入需求並平順轉換至現代化的 uv 設定。