Навыки python-development-python-scaffold
📦

python-development-python-scaffold

Безопасно

Мгновенно создавайте готовые к продакшену структуры Python-проектов

Настройка Python-проектов с правильной структурой и инструментами отнимает время и подвержена ошибкам. Этот навык мгновенно генерирует полные, готовые к продакшену шаблоны проектов с встроенными современными лучшими практиками.

Поддерживает: Claude Codex Code(CC)
📊 71 Адекватно
1

Скачать ZIP навыка

2

Загрузить в Claude

Перейдите в Settings → Capabilities → Skills → Upload skill

3

Включите и начните использовать

Протестировать

Использование «python-development-python-scaffold». Сгенерируйте FastAPI-проект с пользовательскими эндпоинтами и PostgreSQL

Ожидаемый результат:

Полная структура каталогов с src/project_name/, содержащая main.py, config.py, api/v1/endpoints/users.py, models/user.py, schemas/user.py, плюс pyproject.toml с зависимостями FastAPI и SQLAlchemy, и tests/ с фикстурами conftest.py.

Использование «python-development-python-scaffold». Создайте структуру CLI-инструмента с Typer

Ожидаемый результат:

Структура проекта с cli.py, использующим декораторы Typer, группы команд для различных операций, форматирование консоли 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
Контент
31
Сообщество
100
Безопасность
91
Соответствие спецификации

Что вы можете построить

Быстрая разработка API

Быстро создавайте шаблоны новых FastAPI-микросервисов с правильной структурой, интеграцией с базой данных и настройкой тестирования для команд, выпускающих множество сервисов.

Создание библиотек с открытым исходным кодом

Генерация структур пакетов Python, готовых к публикации, с правильной конфигурацией pyproject.toml, подсказками типов и инфраструктурой тестирования.

Настройка Django веб-приложений

Создание хорошо организованных Django-проектов с конфигурацией окружения, инструментами отладки и разделением приложений в соответствии с лучшими практиками Django.

Попробуйте эти промпты

Базовый FastAPI-проект 
Создайте структуру FastAPI-проекта для API управления пользователями с интеграцией базы данных PostgreSQL и JWT-аутентификацией.
Django-проект с приложениями 
Сгенерируйте структуру Django-проекта с отдельными приложениями для пользователей, продуктов и заказов. Включите конфигурацию окружения и инструменты разработки.
Python CLI-инструмент 
Создайте CLI-инструмент с Typer, который принимает пользовательский ввод и отображает форматированный вывод. Включите подкоманды для различных операций.
Повторно используемая Python-библиотека 
Создайте пакет Python-библиотеки с полными подсказками типов, настройкой pytest, конфигурацией mypy и pyproject.toml для публикации на PyPI.

Лучшие практики

  • Используйте uv для управления зависимостями, чтобы воспользоваться преимуществами быстрого разрешения lock-файлов и современной упаковкой Python
  • Структурируйте проекты с макетом src/ для чистых импортов и избежания случайного затенения локальных модулей
  • Включайте полные подсказки типов и настраивайте строгий режим mypy для раннего обнаружения ошибок типов

Избегать

  • Не пропускайте файл .env.example — всегда документируйте необходимые переменные окружения для членов команды
  • Избегайте размещения кода приложения в корне проекта — используйте макет src/ для правильной структуры пакета
  • Не коммитьте .env файлы с настоящими секретами — коммитьте только шаблоны со значениями-заполнителями

Часто задаваемые вопросы

Какие версии Python поддерживает этот навык?
Сгенерированные проекты ориентированы на Python 3.11 и выше, что является текущей рекомендуемой версией для новых проектов. Вы можете изменить поле requires-python в pyproject.toml, если вам нужна поддержка другой версии.
Выполняет ли этот навык команды в моей системе?
Нет, этот навык только генерирует текстовый вывод со структурами проектов, содержимым файлов и командами, которые вам следует выполнить. Вы вручную выполняете предложенные команды в своем терминале.
Могу ли я использовать этот навык с существующими проектами?
Этот навык предназначен для создания новых проектов. Для существующих проектов рассмотрите возможность использования его как ориентира для реструктуризации или добавления отсутствующих компонентов, таких как настройка тестирования или подсказки типов.
Какие бэкенды баз данных поддерживаются?
Шлоны FastAPI включают SQLAlchemy, который поддерживает PostgreSQL, MySQL, SQLite и другие базы данных. Примеры конфигураций используют PostgreSQL, но их можно легко адаптировать для других баз данных.
Включает ли сгенерированный код аутентификацию?
Шлоны включают структуру для аутентификации (security.py, deps.py для зависимостей), но вам нужно реализовать вашу конкретную логику аутентификации. Паттерны JWT и OAuth2 часто используются с FastAPI.
Как настроить сгенерированную структуру проекта?
Рассматривайте сгенерированную структуру как отправную точку. Добавляйте или удаляйте каталоги, модули и зависимости в соответствии с потребностями вашего проекта. Навык следует общим соглашениям, которые вы можете модифицировать.

Сведения для разработчиков

Автор

sickn33

Лицензия

MIT

Репозиторий

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/python-development-python-scaffold

Ссылка

main

Структура файлов

📄 SKILL.md