К основному содержанию
субагент CX Codex

python-pro · voltagent/awesome-codex-subagents — субагент для Codex: Python с контролем границ

Субагент python-pro для задач, где нужно разбираться в поведении Python кода на исполнение, типизацию, тестирование и архитектуру пакетов. Работает с точными границами входа-выхода, а не общими рекомендациями.

MIT ★ 6 505 обновлён 2026-10-05

Установить в Codex · Вручную: положить файлы Все способы и платформы ↓
.codex/agents/python-pro.toml
Открыть на GitHub

Что делает python-pro

python-pro анализирует задачу как контракт: определяет, где код входит в систему, какие данные течёт через границы и какие зависимости нужны. Ищет корневую причину вместо поверхностного исправления, предлагает самое компактное изменение, которое не сломает существующий код за пределами задачи.

Внутри python-pro работает так: сначала прощупывает точку входа и зависимости, потом находит реальную проблему в дизайне или исполнении, потом пишет или советует минимальный фикс. Проверяет основной путь и хотя бы один способ сломаться. Уделяет внимание исключениям, типам (если в проекте стоит статический анализ), структуре импортов, побочным эффектам в I/O и соглашениям фреймворка, который уже есть в коде.

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

Какие задачи решает

  • найти, где код действительно ломается, вместо быстрого хака
  • проверить типы и исключения в критичном пути
  • убедиться, что импорты и инициализация не создают циклы
  • изменить одно, не сломав остальное
  • оставить подробный отчёт о рисках и что ещё нужно валидировать

Примеры запросов агенту

  • Исправь обработку исключений в модуле handlers.py — клиент получает неправильный статус при ошибке подключения
  • Убедись, что типизация в database.py совпадает с тем, что реально возвращается при запросе
  • Найди, почему при изменении конфига в пакете остаются старые модули в памяти

Как установить python-pro

Вручную: положить файлы

.codex/agents/python-pro.toml

Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о python-pro

Как установить python-pro в Codex?

Добавь файл .codex/agents/python-pro.toml в корень проекта с конфигурацией субагента. Путь и содержание зависят от версии Codex — проверь документацию своей версии.

Что делает python-pro?

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

Когда звать python-pro вместо обычного кодинга?

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

Исходный текст

python-pro.toml · MIT
# python-pro

Use when a task needs a Python-focused subagent for runtime behavior, packaging, typing, testing, or framework-adjacent implementation.

Own Python tasks as production behavior and contract work, not checklist execution.

Prioritize smallest safe changes that preserve established architecture, and make explicit where compatibility or environment assumptions still need verification.

Working mode:
1. Map the exact execution boundary (entry point, state/data path, and external dependencies).
2. Identify root cause or design gap in that boundary before proposing changes.
3. Implement or recommend the smallest coherent fix that preserves existing behavior outside scope.
4. Validate the changed path, one failure mode, and one integration boundary.

Focus on:
- entry-point behavior and explicit data-flow boundaries
- exception semantics and predictable failure handling
- typing contracts where repository uses static analysis
- package/import structure effects from touched files
- framework conventions already established in the project
- I/O side effects and transaction-like consistency in stateful operations
- testability and maintainability of the changed path

Quality checks:
- verify one primary success path plus one representative failure path
- confirm exception behavior is explicit and observable to callers
- check import cycles or module initialization side effects
- ensure typing changes reflect runtime truth rather than suppress warnings
- call out environment/runtime assumptions needing integration validation

Return:
- exact module/path and execution boundary you analyzed or changed
- concrete issue observed (or likely risk) and why it happens
- smallest safe fix/recommendation and tradeoff rationale
- what you validated directly and what still needs environment-level validation
- residual risk, compatibility notes, and targeted follow-up actions

Do not perform broad style rewrites or package-wide refactors while solving a scoped issue unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →

Сначала — python-pro от других авторов.

python-pro VoltAgent Community Субагент python-pro для Claude Code пишет типобезопасный Python-код для веб-API, системных утилит и сложных приложений. Выполняет async-задачи в проектах с высокими требованиями к типам. CX Codex 11 689установок python-pro Seth Hobson Субагент python-pro для Claude Code пишет и разбирает код на Python 3.12+, включая async, тесты, API и производительность. Помогает разрабатывать и рефакторить Python-проекты. CX Codex 11 689установок python-pro qdhenry Субагент python-pro для Claude Code помогает рефакторить Python-код, оптимизировать его и добавлять сложные функции. Он подключается к таким задачам и пишет тесты вместе с изменениями. CX Codex ★ 1 357звёзд репо python siviter-xyz Задаёт единый стиль Python: типизация, внедрение зависимостей, структура тестов и модулей. Держит код в одном порядке при правках в существующем проекте. CX Codex +1 353установок python-pypi-package-builder официальный github Скилл python-pypi-package-builder для GitHub Copilot собирает и проверяет Python-пакет, настраивает его версию и публикует в PyPI. Работает с библиотеками, SDK, CLI и плагинами. CX Codex +1 943установок ac-python souliane Скилл ac-python для Claude Code задаёт правила стиля, типов, ООП, тестов и инструментов Python. Охватывает скрипты, CLI, микросервисы и пайплайны. CX Codex +1 1 000установок python-best-practices rohitg00 Скилл python-best-practices подсказывает Claude Code писать Python на современном синтаксисе: тайп-хинты, dataclasses, async, структура проекта и тесты на pytest. CX Codex +1 ★ 2 858звёзд репо 102-python-patterns obviousworks Правило 102-python-patterns задаёт стандарты написания кода на Python: строгую типизацию, асинхронный ввод-вывод, следование PEP 8 и кастомные исключения. Срабатывает при редактировании **/*.py. +1 ★ 97звёзд репо python-packaging Seth Hobson Скилл python-packaging помогает собрать Python-библиотеку или CLI-инструмент в устанавливаемый пакет и подготовить публикацию в PyPI. Подходит для настройки структуры проекта. CX Codex +1 12 915установок

Из того же набора176

Весь набор →
spring-boot-engineer Субагент spring-boot-engineer для задач на Spring Boot: конфигурация, слои данных, API, транзакции и безопасность. Анализирует границы выполнения, находит корни проблем и предлагает минимальные безопасные изменения, сохраняя архитектуру. CX Codex ★ 6 505звёзд репо rust-engineer Субагент rust-engineer для Rust-задач с упором на корректность владения, lifetime и async-поведение. Подходит для системного кода, где ошибка в заимствовании или синхронизации стоит дорого. CX Codex ★ 6 505звёзд репо react-specialist Субагент react-specialist для отладки компонентов React, потоков состояния и багов рендера. Находит причину сбоя и вносит минимальные безопасные правки. CX Codex ★ 6 505звёзд репо rails-expert Субагент rails-expert для Codex разбирает изменения в Ruby on Rails — от маршрута и модели до ответа клиенту. Ищет причины ошибок и предлагает небольшие правки без перестройки архитектуры. CX Codex ★ 6 505звёзд репо powershell-7-expert Субагент powershell-7-expert помогает писать надёжные скрипты на PowerShell 7 для Linux, macOS и Windows, настраивать пайплайны и интеграцию с .NET. CX Codex ★ 6 505звёзд репо powershell-5.1-expert Субагент powershell-5.1-expert помогает разбирать и менять скрипты Windows PowerShell 5.1 с учётом .NET Framework, remoting и административных ограничений. CX Codex ★ 6 505звёзд репо php-pro Субагент php-pro для работы с PHP-кодом: помогает разобраться в логике приложения, интегрировать фреймворки, отладить runtime-ошибки и безопасно менять серверный код. Подходит, когда нужна глубокая экспертиза в PHP, а не просто синтаксис. CX Codex ★ 6 505звёзд репо node-specialist Субагент node-specialist для бэкенда на Node.js. Контролирует блокировки event loop, стримы, утечки ресурсов и корректность асинхронных цепочек. CX Codex ★ 6 505звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой