SuperAPI AI 工具集

bootstrap-uv-python-workspace

编程与开发

查看项目

更新于 10-15 21:49

技能介绍

用途:为单个 Python 项目和多包工作区创建可重复的 uv 脚手架,并作为其他 Python bootstrap 技能的共享基础。适用于需要 package 或 service 脚手架、但不需要 FastAPI 或 FastMCP 上层封装的场景。

主要能力:提供两个规范入口脚本——单项目 scripts/init_uv_python_project.sh,工作区 scripts/init_uv_python_workspace.sh。默认 Python 3.13,质量工具为 pytest、ruff、mypy,配置基线为已提交的 .env、被忽略的 .env.local 以及基于 pydantic-settings 的类型化配置;默认启用 git 初始化。工作区默认成员为 core-lib、api-service,首个成员为 package,其余为 service,服务通过 uv workspace sources 依赖首个 package 成员。

使用方式:运行脚本并显式指定 --name,可选 --path、--python、--force、--initial-commit、--no-git-init;工作区还可用 --members 与 --profile-map。生成后执行 uv run pytest、uv run ruff check .、uv run mypy . 完成校验,并返回路径与脚本给出的后续命令。

限制:目标目录非空时需 --force,否则拒绝;拒绝覆盖已有 pyproject.toml;启用 git 时需具备 uv 与 git;参数无效或缺少前置条件会以非零退出并给出错误信息。需要 FastAPI 或 FastMCP 优先的脚手架时,建议改用对应的上层技能。具体交互式定制、profile 优先级与命令配方详见其提供的 references 文档。