一键生成生产级 Python 项目骨架结构

解决重复造轮子难题:无需手动创建目录和配置文件,让 AI 根据需求(FastAPI、Django、库或 CLI)自动生成符合现代规范的项目结构和基础代码。

为什么需要这个技能

从零搭建 Python 项目往往需要花费大量时间处理目录结构、依赖锁定(pyproject.toml)、虚拟环境配置、测试入口和类型注解。对于重复性较高的微服务或 Web 应用开发,手动初始化效率低下且容易遗漏最佳实践。

本技能通过 uv 等现代工具链,自动输出包含健康检查接口、数据库 ORM 配置、API 路由分层、Pytest 测试套件以及 Makefile 自动化脚本的完整代码框架,让开发者直接切入业务逻辑开发。

适用场景

  • 新建微服务:需要快速搭建基于 FastAPI 的 REST API 接口服务。
  • 企业内部系统:快速生成带有 Admin 面板和 ORM 配置的 Django 应用骨架。
  • 工具包开发:为外部库准备标准结构,包含 hatchling 构建配置。
  • 命令行工具:生成基于 Typer 和 Rich 的 CLI 工具,带有帮助信息和交互提示。

核心工作流

  1. 分析项目类型:确定是 FastAPI 微服务、Django 全栈应用、可复用库、CLI 工具还是通用应用。
  2. 初始化环境:使用 uv 命令创建虚拟环境、初始化 Git 仓库并配置标准的 .gitignore
  3. 生成骨架文件:根据类型输出对应的文件树(如 src/tests/pyproject.toml)。
  4. 配置开发工具链:填充依赖列表(dependencies)、可选开发依赖(dev)以及 ruffpytest 等工具配置。
  5. 完善入口代码:生成 main.pycli.py 主入口,包含基础的中间件、路由或 CLI 命令定义。

下载和安装

下载 python-development-python-scaffold 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹,重启工具后即可使用。

你可能还需要

暂无推荐