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 lint、just test、just format 等命令一键执行代码检查、测试和格式化,无需记忆零散的工具参数。你也可以在 CI/CD 中直接复用这些命令,确保团队代码风格一致。
本工具适合所有 Python 开发者,尤其是需要统一团队开发规范的后端、全栈或运维工程师。无论你是在创建新项目、搭建个人练手环境,还是为企业内部制定标准模板,都能显著减少重复配置时间,让开发更聚焦业务逻辑。
建议先安装 uv 和 just(可通过 pip install uv 和 brew 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 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/python-dev/raw/index.md(查看排版版本)