sickn33-python-development-python-scaffold Skill 技能

sickn33-python-development-python-scaffold 是 Skillstore 上面向 Python 开发者的项目脚手架生成技能，为 Claude / Codex / Claude Code 等 AI 代理设计。它把 Python 项目启动时最繁琐的环境搭建、目录结构、依赖管理、测试配置等重复决策，沉淀为一套结构化、可复用的脚手架模板与提示词库，帮助独立开发者、初创团队、企业内部工具团队快速产出格式统一、最佳实践一致、可直接进入业务开发的高质量 Python 工程基线。

技能覆盖 FastAPI、Django、库（library）、CLI 命令行工具、通用 Python 应用五大项目形态，并附带 pyproject.toml、src 布局、Ruff、pytest、mypy、.env.example、Makefile 等现代 Python 工程标配，让团队成员无需从零研究配置即可拥有可直接迭代的项目骨架。

核心能力

项目形态选择：内置 FastAPI 服务、Django 应用、Python 库、Typer CLI、通用脚本五大模板推荐逻辑，根据用户输入自动匹配最合适的项目结构。 目录结构规范：生成 src 包、tests 目录、配置文件、文档目录、CI 占位等标准化布局，符合社区主流的 src layout 实践。 pyproject.toml 配置：自动生成依赖声明、可选依赖分组、Ruff 配置、pytest 配置、构建系统与项目元信息。 类型与测试工具：集成 mypy 类型检查、Ruff 静态检查、pytest 测试运行器，覆盖现代 Python 工程必选项。 CLI 与 API 入口模板：内置 FastAPI 路由 + 健康检查 + 版本化接口、Typer CLI 命令骨架与参数解析样例。 开发者体验文件：生成 .gitignore、.env.example、Makefile（run / test / lint / format 一键目标）、README 起步模板。

安装配置

环境前置：本地安装 Python 3.10+ 与 uv / pipx / poetry 任意一种依赖管理工具。 一键安装：在终端执行 npx skillstore add sickn33/python-development-python-scaffold，自动写入项目 Skills 目录。 目标项目初始化：在项目根目录创建 pyproject.toml 与 src 包结构，把模板中的可复用片段注入仓库。 依赖锁定：执行 uv lock / pip freeze > requirements.txt，把脚手架附带的开发依赖固定到 lockfile。 CI 集成：在 .github/workflows/ 中追加 lint、test、type-check 三步 GitHub Actions 工作流。

使用步骤

明确项目形态：用 Prompt"Create a Python project scaffold for a [FastAPI service / Django app / library / CLI / generic script]"告诉 AI 项目类型、Python 版本、目标部署环境。 生成目录与依赖：调用"Scaffold a [project type] using uv, Python 3.11+, pytest, Ruff"指令，输出完整目录树 + pyproject.toml + 依赖列表。 应用类型安全：使用"Design a Python library scaffold with src layout, py.typed, mypy"指令补齐库类型标注与 PEP 561 元数据。 封装 API 入口：通过"Build a FastAPI service with health check, versioned routes, settings management"指令生成标准化 API 入口与中间件。 运行本地验证：执行 uv run pytest / uv run ruff check / uv run mypy 验证脚手架生成的工程可正常 lint、test、build。

适用场景

新 API 服务启动：从零搭建一个 FastAPI 服务，含路由、配置、模型、schema、测试、运维命令的一站式基线。 Python 库发布准备：为开源或内部库生成 src layout + pyproject.toml + py.typed + 单元测试，可直接发布到 PyPI。 内部 CLI 工具标准化：把团队内部的运维 / 数据 / 迁移脚本统一到 Typer CLI 模板，便于分发与维护。 Django 项目初始化：生成 Django 项目骨架，含 settings 拆分、apps 目录、ORM 迁移占位、基础测试结构。 教学与培训场景：作为新人学习现代 Python 工程最佳实践（uv、Ruff、mypy、pytest）的标准化教学样本。

适用人群

独立开发者：希望快速产出可直接上线的 Python 项目基线，省去研究配置细节的时间。 初创团队工程师：在 MVP 阶段需要可信赖、可复用工程模板的早期 Python 团队。 企业内部工具开发者：负责把内部脚本工程化、标准化、可交接给运维的中后台工程师。 Python 培训讲师：日常教学现代 Python 工程化实践的讲师与课程作者。 开源项目维护者：为新仓库准备标准化脚手架的开源贡献者。

工作原理

技能以 pyproject.toml 与目录结构模板为底座，不强制依赖特定云服务。它把 Python 项目启动的标准流程拆解为"项目形态选择 → 目录布局 → 依赖与配置 → 类型与测试 → 入口与运维"五个环节，每个环节都用对应的 Markdown 模板与 Prompt 引导 AI 代理按社区最佳实践执行。脚手架生成的所有文件均使用占位配置，团队成员只需替换项目名、版本号、依赖版本等真实值即可直接进入业务开发。整体设计强调"现代工具链 + 类型安全 + 测试就绪 + 可直接迭代"四大原则。

官方链接

Skillstore 详情页：https://skillstore.io/skills/sickn33-python-development-python-scaffold GitHub 仓库：https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/python-development-python-scaffold 一键安装：npx skillstore add sickn33/python-development-python-scaffold Manifest：https://skillstore.io/api/skills/sickn33-python-development-python-scaffold/manifest