ismailuddin/agentic-skills

migrate-to-uv

本技能文档说明如何将一个基于 PEP-517 规范（使用 setup.cfg）的 Python 包迁移至使用 pyproject.toml 和 uv 的现代结构。

何时使用

当用户要求将 Python 包仓库结构迁移为符合 uv 规范的格式时，应使用此技能。

操作指南

1. 将 setup.cfg 的内容移至 pyproject.toml 并删除 setup.cfg
2. 添加一个 .python-version 文件，指定版本为 3.11
3. 使用 uv CLI 将 requirements-dev.txt 中的依赖导入到 pyproject.toml（即执行 uv add -r requirements-dev.txt）
4. 将构建系统切换为使用 uv_build，并从开发依赖中移除 build
5. 将 Commitizen 的版本提供者配置为 uv
6. 从开发依赖中移除 pylint、flake8、isort、black，并替换为 ruff。删除所有相关配置文件，如 pylintrc、.flake8，以及 setup.cfg 和/或 pyproject.toml 中的相关配置
7. 使用以下指导配置 ruff，强制单行导入
8. 将 pytest.ini 的配置移至 pyproject.toml
9. 将 black、pylint、isort、flake8 的 pre-commit 钩子替换为 ruff
10. 从依赖中移除 pre-commit，并替换为 prek
11. 对代码库运行 ruff format 和 ruff check --fix
12. 更新所有 CI/CD 流水线以使用 uv

配置 ruff 强制单行导入

[tool.ruff.lint.isort]
force-single-line = true

[tool.ruff.lint]
select = ["F", "I"]