用途:面向从零搭建后端/API 服务的场景,用统一入口创建生产导向的 FastAPI 起步项目,也可创建包含多个服务成员的工作区。
主要能力:通过 scripts/init_python_service.sh 调用共享的 bootstrap-uv-python-workspace 脚手架层,生成单服务项目或工作区(默认成员 core-lib、api-service,首个成员为 package,其余为 service)。默认使用 Python 3.13,集成 pytest、ruff、mypy;配置上提供已提交的 .env 安全默认值、被忽略的 .env.local 本地覆盖,以及 pydantic-settings 类型化配置。脚本输出状态(success/blocked/failed)、解析后的项目或工作区路径,以及生成的运行与校验命令。
使用方式:先收集 name、mode、path 等输入,单服务模式运行 scripts/init_python_service.sh --name my-service;工作区可加 --mode workspace --members 与 --profile-map;还支持 --force、--no-git-init、--initial-commit。生成后按脚本内置校验路径执行 uv run pytest、uv run ruff check .、uv run mypy .。FastAPI 依赖可用 uv add fastapi --extra standard 与 uv add pydantic-settings python-dotenv,开发运行 uv run fastapi dev app/main.py。
适用场景:新建 FastAPI 服务、需要单项目或工作区结构、希望统一脚手架与质量校验的团队。
限制:目标目录非空时除非加 --force 否则拒绝;除显式禁用 git 初始化外需要 uv 和 git;项目模式使用工作区专用选项会失败;--initial-commit 与 --no-git-init 不能同时使用。若只需通用 uv 脚手架或 FastMCP 服务,应改用对应技能。其他平台支持与定价暂未提供。