simple-modern-uv
一个基于uv的现代化、极简Python项目模板与智能体技能
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:simple-modern-uv。 它的用途是:一个基于uv的现代化、极简Python项目模板与智能体技能 完整的 Skill 内容见:https://321skill.com/skills/simple-modern-uv/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“用simple-modern-uv帮我创建一个新的Python数据分析工具项目,名字叫data-helper。”,它会引导你完成项目初始化,自动配置好uv环境、Ruff代码格式化、类型检查以及CI/CD工作流。或者
对AI说:“检查并升级当前项目的工具链到最新标准。”,它会分析你的项目结构,并应用modern-uv的最佳实践进行现代化改造。
介绍
simple-modern-uv 旨在解决Python项目初始化和现代化改造的痛点。传统的Python项目设置涉及虚拟环境、包管理、代码格式化、类型检查等多个工具链,配置繁琐且容易过时。这个模板通过整合uv(极速的Python包安装器和项目管理器)、Ruff(极速的Python代码格式化与检查工具)、BasedPyright(快速的类型检查器)以及GitHub Actions工作流,提供了一个开箱即用的现代化项目基线。
使用方式非常灵活,既可以通过AI智能体技能快速创建新项目或升级现有项目,也可以手动使用Copier模板工具进行初始化。智能体技能会引导用户完成整个流程,包括项目命名、依赖选择、工具配置等。
它非常适合希望快速启动Python项目,或希望将老旧项目升级到现代工具链的开发者。无论是开发开源库、内部工具,还是进行严肃的商业项目开发,这个模板都能提供一个坚实且高效的起点。
建议在使用前确保已安装uv,这是该模板的核心依赖。对于现有项目升级,建议先备份重要文件,因为模板会覆盖或修改如pyproject.toml、.github/workflows等配置文件。
核心特点
与同类Python项目模板相比,它深度集成了新兴的、高性能的现代工具链(uv, Ruff, BasedPyright),并原生支持通过AI智能体技能进行交互式引导,极大降低了上手门槛和心智负担。
注意事项
不适合需要兼容旧版Python(如3.10及以下)或坚持使用传统工具链(如pip+virtualenv+flake8)的项目。
常见问题
这个模板支持哪些Python版本?
支持Python 3.11, 3.12, 3.13及3.14。
如何升级我现有的项目?
通过AI智能体技能或手动使用Copier工具,选择升级模式即可,它会智能合并配置。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/simple-modern-uv/raw/index.md 读取 simple-modern-uv 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/simple-modern-uv/raw/index.md(查看排版版本)