venv-manager

venv-manager 技能為 Python 虛擬環境的端到端管理提供了一種自動化、代理式的操作流程。它專為在技術專案資料夾中運作的開發人員和 AI 代理設計，確保專案依賴保持隔離、可重現且可驗證。透過實施環境建立、套件安裝和狀態驗證的標準化程序，該技能減少了環境偏移並防止了開發與生產環境中常見的依賴衝突。它適用於需要強大且可重複之本地 Python 環境協作系統的軟體工程師與 DevOps 從業人員。

• 自動偵測並驗證現有的 Python 解釋器和版本，然後再啟動建立流程。

• 支援標準建立、特定版本環境（例如 python3.11）及站點套件 (site-packages) 存取設定。

• 處理包含 requirements.txt、pyproject.toml 及開發專用依賴檔案的依賴安裝流程。

• 執行環境健康檢查，包含列出已安裝套件、執行 pip check 以及透過 pip freeze 匯出可重現的依賴鎖定檔。

• 整合結構化的復原協定，用於診斷並解決環境設定或啟動過程中的失敗。

• 透過檢查點 (checkpointing) 維護審計記錄，將 Python 版本、pip freeze 快照與驗證狀態記錄在本地目錄中。

• 需要可寫入的目錄以及 Python 3 解釋器才能運作。

• 嚴格遵守基礎檢查，以防止意外刪除現有的虛擬環境。

• 專為命令列執行 (bash/zsh) 設計，並提供標準化的啟用路徑以確保跨平台相容性。

• 最佳實踐包含一致使用 venv/ 或 .venv/ 命名慣例，並透過 .gitignore 主動將環境目錄排除在版本控制之外。

• 當您進入新專案、設定本地開發工作區或執行自動化環境重建任務時，請使用此技能。在啟動環境生成前，請務必確認 Python 版本先決條件以確保相容性。