Python 环境管理器技能(neo-python-manager)用于帮助用户在 Python 项目中选择并操作合适的依赖管理工具。
触发场景 当用户询问“如何安装某个包”“这个项目用的是哪个包管理器”,或要求添加、删除、更新 Python 依赖时;当需要初始化虚拟环境或运行 Python 脚本,但不确定该用 uv run、poetry run 还是 python 时;当项目缺少明确的环境配置、需要推荐合适工具时,均可触发该技能。
工作流程 感知:扫描项目根目录中的特征文件,包括 uv.lock、poetry.lock、pyproject.toml、requirements.txt;检查系统环境,通过执行 uv --version 或 poetry --version 判断工具是否已安装。
推理:根据特征文件判断项目应使用的工具,优先级为 uv > Poetry > pip;检查工具可用性,如果项目判定使用 uv 但未安装,或用户想切换到 uv/Poetry 但环境未就绪,则标记为“待安装”。
行动:若工具未安装,必须先询问用户,例如“检测到项目使用[工具名],但你的环境尚未安装。是否需要我提供安装命令并协助安装?”;随后输出所识别管理工具的正确操作命令;若用户同意安装或变更依赖,提供 CLI 命令供用户确认。
工具命令参考
-
uv(推荐,超快工具) 检测标准:存在 uv.lock。 安装(Unix/macOS):curl -LsSf https://astral.sh/uv/install.sh | sh 安装(Windows):powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" 常用命令:uv add <package>(添加包)、uv sync(同步环境)、uv run <script.py>(运行脚本)。
-
Poetry 检测标准:存在 poetry.lock,或 pyproject.toml 中含有 [tool.poetry]。 安装(跨平台):curl -sSL https://install.python-poetry.org | python3 - 常用命令:poetry add <package>(添加包)、poetry install(安装依赖)、poetry run python <script.py>(运行脚本)。
-
venv + pip(传统标准) 检测标准:仅有 requirements.txt 或 .venv。 常用命令:pip install <package>、pip install -r requirements.txt。
交付内容 环境检测报告:告知当前环境状态,例如已安装 uv、检测到 poetry.lock。 安装与操作指导:若工具缺失,主动征求安装同意并提供正确语法。 环境一致性检查:确保提供的命令与项目现有锁文件完全匹配。
校验规则 未经询问用户,绝不直接执行安装命令;安装命令必须区分操作系统(macOS/Linux 与 Windows)。
限制 该技能聚焦于 Python 依赖与环境管理工具的选择、安装与命令指导,不涉及具体项目业务逻辑。