python-service-creatorlisted
Install: claude install-skill afine907/skills
# 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](references/fastapi-template.md)
- Flask → [references/flask-template.md](references/flask-template.md)
### Step 3: 生成项目文件
标准目录布局(参考 [references/project-layout.md](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
│ └── serv