技能 python-development-python-scaffold
📦

python-development-python-scaffold

安全

即时生成生产就绪的Python项目结构

使用正确的结构和工具设置Python项目既耗时又容易出错。此技能可即时生成完整的、生产就绪的项目脚手架,内置现代最佳实践。

支持: Claude Codex Code(CC)
🥉 74 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“python-development-python-scaffold”。 生成具有用户端点和PostgreSQL的FastAPI项目

预期结果:

完整的目录结构,包含src/project_name/,其中有main.py、config.py、api/v1/endpoints/users.py、models/user.py、schemas/user.py,以及带有FastAPI和SQLAlchemy依赖的pyproject.toml,还有带conftest.pyfixture的tests/。

正在使用“python-development-python-scaffold”。 创建使用Typer的CLI工具结构

预期结果:

项目布局,使用Typer装饰器的cli.py、不同操作的命令组、Rich控制台格式设置,以及带有脚本入口点配置的pyproject.toml。

安全审计

安全
v1 • 2/24/2026

Static analyzer flagged 35 patterns as potential security issues, but all are false positives. The 'external_commands' are documentation examples showing users bash commands to run. The 'network' and 'env_access' findings reference example templates in .env.example files. The 'weak cryptographic algorithm' detections match description strings, not actual crypto code. This skill only generates text output and code templates with no execution capabilities.

1
已扫描文件
334
分析行数
0
发现项
1
审计总数
未发现安全问题
审计者: claude

质量评分

38
架构
100
可维护性
87
内容
50
社区
100
安全
91
规范符合性

你能构建什么

快速API开发

快速搭建具有正确结构、数据库集成和测试设置的FastAPI微服务,适用于需要交付多个服务的团队。

开源库创建

生成发布就绪的Python包结构,包含正确的pyproject.toml配置、类型提示和测试基础设施。

Django Web应用程序设置

创建组织良好的Django项目,包含环境配置、调试工具和遵循Django最佳实践的应用程序分离。

试试这些提示

基础FastAPI项目
创建用于用户管理API的FastAPI项目结构,包含PostgreSQL数据库集成和JWT认证。
带应用程序的Django项目
生成具有独立用户、产品和订单应用程序的Django项目结构。包含环境配置和开发工具。
Python CLI工具
使用Typer搭建接受用户输入并显示格式化输出的CLI工具。包含用于不同操作的子命令。
可重用的Python库
创建具有完整类型提示、pytest设置、mypy配置和用于PyPI发布的pyproject.toml的Python库包。

最佳实践

  • 使用uv进行依赖管理,以受益于快速的锁文件解析和现代Python打包
  • 使用src/布局结构化项目,以实现干净的导入并避免意外的本地模块遮蔽
  • 包含全面的类型提示并配置mypy严格模式,以尽早捕获类型错误

避免

  • 不要跳过.env.example文件 - 始终为团队成员记录所需的环境变量
  • 避免将应用程序代码放在项目根目录 - 使用src/布局以获得正确的包结构
  • 不要提交包含实际密钥的.env文件 - 仅提交带有占位符值的模板

常见问题

此技能支持哪些Python版本?
生成的项目针对Python 3.11及以上版本,这是目前新项目推荐的版本。如果需要不同的版本支持,您可以修改pyproject.toml中的requires-python字段。
此技能会在我的系统上执行命令吗?
不,此技能仅生成显示项目结构、文件内容和您应该运行的命令的文本输出。您需要手动在终端中执行建议的命令。
我可以将此技能与现有项目一起使用吗?
此技能专为新项目脚手架设计。对于现有项目,可以考虑将其作为重组或添加缺失组件(如测试设置或类型提示)的参考。
支持哪些数据库后端?
FastAPI模板包含支持PostgreSQL、MySQL、SQLite和其他数据库的SQLAlchemy。示例配置使用PostgreSQL,但可以轻松适配其他数据库。
生成的代码是否包含认证?
模板包含认证结构(security.py、用于依赖项的deps.py),但您需要实现特定的认证逻辑。JWT和OAuth2模式通常与FastAPI一起使用。
如何自定义生成的项目结构?
将生成的结构视为起点。根据项目需要添加或删除目录、模块和依赖项。该技能遵循您可以修改的常见约定。