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 版本先决条件以确保兼容性。