python-dev
有主见的Python开发环境配置工具
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:python-dev。 它的用途是:有主见的Python开发环境配置工具 完整的 Skill 内容见:https://321skill.com/skills/python-dev-x-5/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'使用 python-dev skill 初始化我的新 Python 项目,配置 pyproject.toml,设置 ruff 为严格模式,并添加 pytest 测试框架',它会自动生成包含 uv、ruff、pytest、just 配置的项目结构,创建示例测试文件,并执行 just test 验证一切就绪。
介绍
python-dev 提供一个有主见(Opinionated)的 Python 开发环境预设,旨在解决 Python 项目初始化时的配置碎片化问题。它整合了 uv(超快包管理)、ty(类型检查)、ruff(现代化 lint)、pytest(测试)和 just(任务运行器),让你无需在多个工具间反复切换,一键获得标准化的开发体验。
使用方式非常简单:克隆仓库后,直接使用 uv 管理依赖,ruff 自动检查代码质量,pytest 运行测试套件,just 执行构建、测试、格式化等常见任务。所有配置已预设在 pyproject.toml 中,你只需专注于业务代码。
适合 Python 后端开发、全栈开发以及测试工程师,尤其适合希望快速启动新项目、统一团队编码规范的场景。无论是个人项目还是团队协作,都能大幅减少环境配置的心智负担。
建议在团队内统一使用本套配置,确保成员之间代码风格一致。如果项目需要兼容 Python 3.9 以下版本,或依赖非标准包管理器,可能需要进行额外调整。
核心特点
与同类 Python 模板相比,python-dev 以 uv 为核心包管理器,配合 just 任务运行器,替代了传统的 pip/poetry + Makefile 组合,并原生集成了 ty 类型检查,在速度与现代化程度上有明显优势。
注意事项
不适合需要兼容 Python 3.8 以下版本的项目,或依赖 pip/poetry 特定生态的场景。
常见问题
如何添加新的第三方依赖?
使用 uv add <package-name> 命令,uv 会自动更新 pyproject.toml 和锁文件。
如何运行所有测试并检查代码风格?
在项目根目录执行 just test 即可,它会依次运行 ruff 检查、pytest 测试,并输出报告。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/python-dev-x-5/raw/index.md 读取 python-dev 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/python-dev-x-5/raw/index.md(查看排版版本)