SuperAPI AI 工具集

python-dev-environment

编程与开发

查看项目

更新于 10-16 07:50

技能介绍

Python Development Environment Expertise Skill 是一个面向课程写作的参考型技能,为《Python 开发环境》章节(14.1)提供经过核实的工具链事实。其用途是让内容实现子代理在撰写该章课程时引用已记录的命令、版本号与配置项,避免自行发明命令或配置。

主要能力与覆盖范围:

  1. uv(包管理器与项目编排器):版本 0.10.4(2026 年 2 月 17 日发布),使用 Rust 编写,由 Astral 开发。资料给出 Windows PowerShell、macOS/Linux curl、Homebrew、WinGet 的安装命令;uv init 的项目脚手架用法与生成文件结构;uv add 的依赖管理(含 --dev 开发依赖);uv run 在项目环境中执行命令的流程;以及 uv 相对 pip 在速度、范围、虚拟环境、锁文件、Python 版本管理、卸载清理、磁盘占用和替代工具方面的对比。

  2. pyright(静态类型检查器):版本 1.1.408(2026 年 1 月 8 日发布),使用 TypeScript 编写,由 Microsoft 开发。资料给出通过 uv 安装的方式、pyproject.toml 与 pyrightconfig.json 配置示例、off/basic/standard/strict 四种类型检查模式,以及严格模式额外启用的 28 条规则分类(缺失注解、代码质量、类型安全)和运行命令与输出示例。

  3. ruff(linter 与格式化器):版本 0.15.2(2026 年 2 月 19 日发布),使用 Rust 编写,由 Astral 开发。资料给出安装、lint 与 format 运行命令、pyproject.toml 配置示例、关键规则类别表(F、E、W、I、UP、B、SIM、N、S、T20)、默认启用规则与总规则数量,以及它替代的工具列表。

  4. pytest(测试框架):版本 9.0.2(2025 年 12 月 6 日发布),要求 Python >= 3.10。资料给出安装方式、测试发现约定(文件、函数、类、方法命名)、最小测试文件示例、运行命令与输出格式、输出字符含义,以及 pyproject.toml 配置示例。

  5. Git(版本控制):资料说明 Git 并非 Python 专用工具,列出 git init、git add、git commit、git log --oneline、git diff 等基础命令。

使用方式:该技能供内容实现子代理在撰写第 14.1 章课程时引用,要求只使用其中已记录的命令与配置。资料还包含统一的 pyproject.toml 示例(一个文件配置全部四个工具)、Windows/macOS/Linux 平台差异说明、章节语气与结构模板(人物设定、课程开场模式、章节流程、YAML frontmatter 模板、代码风格、语气),以及各工具与章节公理的对应关系。

适用场景:撰写或审校 Python 开发环境相关课程内容,需要引用 uv、pyright、ruff、pytest、Git 的准确版本、命令与配置时。

限制:资料明确要求不得编造命令或配置选项,只能使用其中记录的内容;requires-python 默认值在文档中显示为 >=3.11,但会随检测到的 Python 版本变化,资料将其标注为 NOTE 而非完全确定。