python-pro - Python с типами и проверками ошибок

Когда звать

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

Что делает Python Pro

Python Pro предназначен для проектов на Python 3.11 и новее. Скилл направляет агента на явные типы, обработку ошибок и проверяемый результат: вместе с модулем должны появиться тесты, а проверка типов должна завершиться без ошибок.

В основном файле автор описывает аннотации функций и атрибутов, dataclasses, протоколы и асинхронный ввод-вывод. Это не отдельный интерпретатор Python и не библиотека, которую приложение импортирует во время работы. Файлы скилла читает ваш агент, когда пишет или меняет программу.

Какой порядок работы задан

Сначала агент изучает структуру проекта, зависимости, имеющиеся типы и тесты. Затем проектирует интерфейсы, реализует код и проверяет его через pytest, строгий режим mypy, black и ruff. Если инструмент сообщает ошибку, автор требует исправить её и повторить проверку до сдачи.

В наборе пять справочников: система типов, асинхронные шаблоны, стандартная библиотека, тестирование и упаковка. Для конкретной задачи агент может обратиться к нужному файлу. Например, при чтении конфигурации полезны работа с путями, управление ресурсами и явные исключения; при обращении к нескольким сервисам - правила асинхронной работы.

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

С чего начать после подключения

Переносите skills/python-pro целиком, вместе с references. Отдельный SKILL.md будет ссылаться на отсутствующие материалы. QUICKSTART репозитория предлагает также установку всего набора; она не равна добавлению одного Python-скилла. Порядок для Claude Code описан в материале как установить скилл.

Для первой проверки дайте небольшую функцию, которая читает файл настроек, и попросите добавить типы и тесты на неправильный ввод. Уточните: «Не обращайтесь к внешним сервисам, используйте временные файлы, покажите фактические результаты pytest и mypy». Так можно увидеть, следует ли агент инструкции, не выдавая ему рабочие доступы.

Принимайте результат по выводу запущенных инструментов. Фраза «проверка типов пройдена» без запуска или пример успешного вывода из документации не подтверждают состояние вашего кода. Если в окружении нет pytest или mypy, агент должен сообщить об этом отдельно.

Где заканчиваются возможности скилла

Сам текст не добавляет права на файлы или сеть. Эти права определяет клиент агента. Работа с настоящими API потребует отдельных настроек доступа; для тестов обычно достаточно подменённых ответов, не содержащих секретов.

Не переносите рекомендации автора механически в существующий проект. Например, заявление скилла о замене os.path на pathlib не означает, что весь модуль os.path объявлен устаревшим в Python. Сохраняйте требования проекта и проверяйте спорные советы по документации языка.

Мы прочитали основной файл версии 1.1.0 и проверили лицензию MIT и состав папки на 22 октября 2026 года. Python Pro в этой проверке не устанавливали и пользовательский код с ним не запускали. Для поиска причины уже возникшей ошибки можно дополнить работу Debugging Wizard.