用途:快速搭建并验证 Python 开发环境,使用 UV 进行快速、可靠的依赖管理。资料明确要求始终使用 UV,不要直接使用 pip,称 UV 比 pip 快 10–100 倍,支持确定性依赖解析、锁文件与虚拟环境管理,可作 pip 的替代。
主要能力:检查 Python 3.10+;安装 UV;用 UV 创建虚拟环境;安装依赖;配置 Ruff(代码检查与格式化)、MyPy(类型检查)、pytest(测试)与 pre-commit 钩子;验证导入与依赖;运行质量检查与测试;验证环境可复现性。详细步骤见 references/DETAILED-WORKFLOW.md(资料未提供内容)。
使用方式与排错:未安装 UV 时运行 curl -LsSf https://astral.sh/uv/install.sh | sh,然后重启 shell 或 source 配置文件;缺少 Python 时运行 uv python install 3.12;依赖冲突时用 uv pip install --dry-run -r requirements.txt 查看冲突,或用 uv pip install --resolution=lowest .;缺少模块时用 uv pip install -e ".[dev]" 或 uv pip install <module-name>。从 pip 迁移:删除 venv 和 .venv,运行 uv venv,执行 source .venv/bin/activate,用 uv pip install -r requirements.txt 安装,并用 uv pip compile requirements.txt -o requirements.lock 生成锁文件。
最佳实践:始终使用 UV;使用 pyproject.toml;用 Ruff 替代 flake8、black、isort;用 uv lock 或 uv pip compile 锁定依赖;用 uv python pin 固定 Python 版本;启用 mypy strict 模式;使用 pre-commit 钩子;目标覆盖率 90% 以上。该技能可被 quality-check 与 run-tests 等技能调用。