python-dev

一键配置 Python 现代开发环境,集成 uv、ruff 等工具

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:python-dev。
它的用途是:一键配置 Python 现代开发环境,集成 uv、ruff 等工具
完整的 Skill 内容见:https://321skill.com/skills/python-dev/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'使用 python-dev 模板初始化一个新项目,要求依赖管理用 uv,代码检查用 ruff,测试框架用 pytest,任务运行用 just。' 它会自动生成完整的 pyproject.toml、配置 ruff 和 pytest 规则,并创建 justfile 包含 lint、test、format 等命令。你只需运行 `just setup` 即可完成全部初始化,后续开发直接使用 `just lint` 检查代码规范。

介绍

许多 Python 开发者在项目初始化时面临工具链碎片化问题:依赖管理、代码格式化、测试框架、任务运行等各自独立配置,难以统一规范,新成员上手成本高。python-dev 提供了有主见(opinionated)的现代开发环境模板,将 uv(依赖管理)、ty(类型检查)、ruff(代码规范与格式化)、pytest(测试)和 just(任务运行器)整合在一起,帮你快速搭建标准化的 Python 项目骨架。

使用方式非常简单:克隆仓库后,运行 just setup 即可自动安装依赖、配置 pyproject.toml、初始化版本控制等。日常开发中,通过 just lintjust testjust format 等命令一键执行代码检查、测试和格式化,无需记忆零散的工具参数。你也可以在 CI/CD 中直接复用这些命令,确保团队代码风格一致。

本工具适合所有 Python 开发者,尤其是需要统一团队开发规范的后端、全栈或运维工程师。无论你是在创建新项目、搭建个人练手环境,还是为企业内部制定标准模板,都能显著减少重复配置时间,让开发更聚焦业务逻辑。

建议先安装 uv 和 just(可通过 pip install uvbrew install just 快速安装),然后使用本模板。注意该配置带有强烈个人偏好(如选择 ruff 而非 black、isort,使用 uv 而非 pip/poetry),若你团队已有既定工具链,可能需要评估兼容性。对于非 Python 项目或需要完全自定义工具链的场景,本模板可能不够灵活。

核心特点

与常见的 cookiecutter 模板或单独配置相比,python-dev 将 uv、ruff、pytest、just 等工具深度集成,开箱即用,且通过 just 提供统一命令入口,无需手动安装和配置每个工具,特别适合追求高效和标准化的团队。

注意事项

不适合非 Python 项目,也不适合需要自定义各大工具版本或混合使用其他工具链(如 poetry、black、isort)的场景。

常见问题

如何安装 uv 和 just?

uv 可通过 `pip install uv` 或官方脚本安装;just 在 macOS 上可用 `brew install just`,Linux 上可用包管理器或从 GitHub Releases 下载二进制。

如何在此模板中添加其他依赖?

直接编辑 pyproject.toml 中的 `[project.dependencies]` 部分,然后运行 `uv sync` 即可安装。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/python-dev/raw/index.md 读取 python-dev 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。