afine907 Python Service — Python 后端服务脚手架生成
自然语言描述 → 完整 Python 项目目录（代码 + 配置 + Dockerfile），一次输出。
不适用：数据分析脚本（非服务）；已有项目的重构；纯前端。
Goal
Python 后端服务脚手架生成器。自然语言描述 → 完整 Python 项目目录
Trigger
- 用户说"创建 FastAPI 服务"、"搭建 Python 后端"、"初始化 Flask 项目"
- 用户要求生成 Python API、Python 微服务脚手架
- 用户提到 fastapi、flask、django 等 Python 框架并需要新建项目
工作流程
描述需求 → 选择框架 → 确认配置 → 生成项目 → 验证导入
Step 1: 收集需求
从用户描述中提取：
- 服务名称：用于目录名
- 框架偏好：FastAPI（默认）/ Flask / Django
- 端口：默认 8000
- 数据库：PostgreSQL / MySQL / SQLite / 无
- 功能模块：用户提到的业务实体
如果信息不足，询问 1-2 个关键问题，不要过度追问。
Step 2: 选择框架
| 框架 | 适用场景 | 特点 |
|---|---|---|
| FastAPI (默认) | 现代 API 服务 | 异步、自动文档、Pydantic 校验 |
| Flask | 轻量服务 | 简单灵活、扩展丰富 |
读取对应的模板文件：
- FastAPI → references/fastapi-template.md
- Flask → references/flask-template.md
Step 3: 生成项目文件
标准目录布局（参考 references/project-layout.md）：
<service-name>/
├── app/
│ ├── __init__.py
│ ├── main.py # 入口：app 创建、lifespan、CORS
│ ├── core/
│ │ ├── __init__.py
│ │ └── config.py # pydantic-settings 配置
│ ├── api/
│ │ ├── __init__.py
│ │ └── <entity>.py # 路由
│ ├── models/
│ │ ├── __init__.py
│ │ └── <entity>.py # SQLAlchemy 模型
│ ├── schemas/
│ │ ├── __init__.py
│ │ └── <entity>.py # Pydantic schemas
│ └── services/
│ ├── __init__.py
│ └── <entity>.py # 业务逻辑
├── tests/
│ ├── __init__.py
│ ├── conftest.py
│ └── test_<entity>.py
├── alembic/ # 数据库迁移（如需要数据库）
├── pyproject.toml
├── Dockerfile
├── .env.example
└── README.md
必生成文件：
app/main.py— App 创建、路由注册、CORS、lifespanapp/core/config.py— pydantic-settings 配置类app/api/*.py— 每个实体一个路由文件app/models/*.py— SQLAlchemy 模型（如需要数据库）app/schemas/*.py— Pydantic 请求/响应 schemaapp/services/*.py— 业务逻辑层pyproject.toml— 依赖和工具配置Dockerfile— 多阶段构建（参考 references/dockerfile-patterns.md）.env.example— 环境变量模板README.md— 项目说明
Step 4: 验证
生成完成后检查 Python 语法：
cd <service-name> && python -m py_compile app/main.py
报告生成结果。
输出格式
完成后输出：
## 项目已生成
**服务**: <name>
**框架**: <fastapi/flask>
**端口**: <port>
### 文件结构
<tree>
### 启动方式
# 安装依赖
pip install -e .
# 启动开发服务器
uvicorn app.main:app --reload
### API 文档
- Swagger UI: http://localhost:<port>/docs
- ReDoc: http://localhost:<port>/redoc