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

fastapi-developer · voltagent/awesome-codex-subagents — субагент Codex для FastAPI

Субагент fastapi-developer для Codex, который берёт на себя разработку FastAPI приложений: асинхронные операции, типизированные контракты Pydantic v2, внедрение зависимостей и развёртывание на ASGI.

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

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

Что делает fastapi-developer

fastapi-developer следит за граничными условиями роутов, графом зависимостей и транзакционными границами. Он строит тип-безопасные контракты запрос-ответ, проверяет асинхронность пути операций, управляет временем жизни сессий и ресурсов, а потом валидирует изменения на трёх сценариях: успех, валидационная ошибка, откат при сбое.

Фокус на Pydantic v2 модели с валидаторами и дискриминированными объединениями, async-await без блокировок события цикла, SQLAlchemy 2.0 с асинхронными сессиями, OAuth2/JWT границы доступа и стабильные схемы ошибок. Каждое изменение проверяется на совместимость с опубликованной OpenAPI схемой — в reports видны дельты схемы и заметки о клиентской совместимости.

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

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

  • строить асинхронные эндпоинты без блокировок события цикла
  • определять и валидировать контракты Pydantic v2 с дискриминированными типами
  • управлять временем жизни сессий SQLAlchemy 2.0 и транзакционными границами
  • сохранять OpenAPI совместимость при изменении моделей запроса и ответа
  • внедрять OAuth2/JWT авторизацию с правильными скопами и ролями

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

  • Добавь эндпоинт POST /users с валидацией Pydantic и откатом при конфликте уникальности
  • Рефакторь обработчик /orders/{id} чтобы он был асинхронным и использовал yield-зависимость для пула коннектов
  • Проверь, сломаю ли я OpenAPI если изменю формат поля created_at с ISO строки на Unix timestamp

Как установить fastapi-developer

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

.codex/agents/fastapi-developer.toml

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

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

Вопросы о fastapi-developer

Как установить fastapi-developer в Codex?

Поместите конфиг субагента в .codex/agents/fastapi-developer.toml в корне проекта, затем перезагрузите Codex. Субагент появится в списке агентов для назначения задач.

Когда использовать fastapi-developer?

Когда вам нужно реализовать или изменить FastAPI эндпоинты — асинхронные операции, типизированные контракты, внедрение зависимостей или развёртывание на ASGI. Субагент проверит асинхронность, валидирует контракты и отследит совместимость схемы.

Что проверяет fastapi-developer при валидации?

Субагент валидирует успешный путь (асинхронность, корректность сессий), валидационный путь (ошибки Pydantic с предсказуемыми полями) и откат (откат транзакций при сбое). Также проверяет, что авторизация ещё работает и OpenAPI схема совместима с клиентами.

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

fastapi-developer.toml · MIT
# fastapi-developer

Use when a task needs FastAPI implementation — async endpoints, Pydantic v2 contracts, dependency injection, or ASGI deployment behavior.

Own FastAPI work as production API behavior and contract integrity, not generic Python edits.

Prioritize type-safe request/response contracts, async correctness, and the smallest change that preserves OpenAPI shape and existing client compatibility.

Working mode:
1. Map the router boundary, dependency graph, and persistence path affected by the task.
2. Identify the request/response model contract and whether it is part of the public OpenAPI surface.
3. Implement the smallest coherent change that preserves async semantics and transaction boundaries.
4. Validate one success path, one validation/error path, and one persistence rollback path.

Focus on:
- Pydantic v2 model contracts, validators, and discriminated unions
- async path operations and correct use of yield dependencies for resources
- dependency injection scope (function, class, session) and shared resource lifetimes
- SQLAlchemy 2.0 async session management and explicit transaction boundaries
- authentication and authorization boundaries (OAuth2/JWT, scopes, roles)
- exception handlers, HTTPException shape, and stable error response schema
- OpenAPI schema impact and backward compatibility for existing clients

Quality checks:
- verify path operation is genuinely async and does not block the event loop
- confirm Pydantic validators raise predictable errors with stable field paths
- check session/transaction lifetime ends before response is returned
- ensure auth dependencies still gate the changed routes
- call out any change that breaks the published OpenAPI schema

Return:
- exact router and model files changed and OpenAPI deltas, if any
- behavior change summary including async and transaction semantics
- validation performed on success, validation failure, and rollback paths
- residual risk, client-compatibility notes, and ASGI deployment implications

Do not introduce sync I/O inside async paths or change response schemas without explicit versioning unless requested by the parent agent.

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

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

Все субагенты по теме «Бэкенд и API» →

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

fastapi-developer VoltAgent Community Субагент fastapi-developer для Claude, который пишет и разбирает async-API на FastAPI: модели Pydantic v2, внедрение зависимостей, документация OpenAPI. CX Codex ★ 26 718звёзд репо fastapi-python Mindrally Скилл fastapi-python для Claude Code, Codex, Cursor и других платформ: эксперт по FastAPI и асинхронному Python. Включается при разработке REST API, валидации через Pydantic и оптимизации производительности. CX Codex +1 14 100установок fastapi-development aj-geddes Скилл fastapi-development для ИИ-агента, который помогает писать Python-API на FastAPI: асинхронные роуты, валидация через Pydantic, JWT и автодокументация OpenAPI. CX Codex +1 627установок api-scaffolding-fastapi-pro Seth Hobson Субагент api-scaffolding-fastapi-pro для Claude Code помогает проектировать и писать асинхронные API на FastAPI. Подключается к задачам по FastAPI, оптимизации async-кода и архитектуре API. CX Codex ★ 42 780звёзд репо fastapi-patterns affaan-m Скилл fastapi-patterns задаёт структуру продакшен-проекта на FastAPI, схему валидации Pydantic v2 и внедрение зависимостей. Пригодится при проектировании сервисов, настройке JWT-авторизации и подготовке тестов. CX Codex +1 6 700установок fastapi-expert https://github.com/Jeffallan Скилл fastapi-expert для Claude Code помогает разрабатывать асинхронные API на FastAPI с моделями Pydantic V2. Охватывает маршруты, аутентификацию, работу с базой и тесты. CX Codex +1 6 600установок fastapi-pro davila7 Скилл fastapi-pro настраивает Claude Code на разработку асинхронных API на FastAPI с Pydantic V2. Пригодится при проектировании микросервисов и подготовке деплоя. CX Codex +1 201установок

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

Весь набор →
javascript-pro Субагент javascript-pro разбирает JavaScript для браузера и Node.js: ищет причины ошибок, меняет код и проверяет затронутые пути выполнения. CX Codex ★ 6 505звёзд репо java-architect java-architect — субагент для архитектурных задач Java-приложений. Анализирует структуру кодовых баз, поведение JVM и границы фреймворков, выявляет корневые причины и предлагает минимальные безопасные изменения. CX Codex ★ 6 505звёзд репо golang-pro Субагент golang-pro для Codex помогает находить гонки данных и настраивать каналы и контексты без лишней перестройки архитектуры. CX Codex ★ 6 505звёзд репо flutter-expert Субагент flutter-expert разбирает Flutter-задачи: поведение виджетов, состояние, рендеринг и мобильную реализацию. Подключайте его к точечным изменениям в существующем проекте. CX Codex ★ 6 505звёзд репо expo-react-native-expert Субагент expo-react-native-expert помогает вести мобильную разработку на Expo и React Native, настраивать навигацию в Expo Router, сборки EAS и оптимизировать рендеринг. CX Codex ★ 6 505звёзд репо erlang-expert Субагент erlang-expert для задач с Erlang/OTP, rebar3, BEAM-процессами и распределённой логикой. Анализирует граничные условия выполнения, ищет корень проблемы в архитектуре и предлагает минимальные безопасные изменения. CX Codex ★ 6 505звёзд репо elixir-expert Субагент elixir-expert для задач с Elixir и OTP: процессы, супервизия, отказоустойчивость, Phoenix. Анализирует границы выполнения, находит корни проблем и предлагает минимальные безопасные изменения. CX Codex ★ 6 505звёзд репо dotnet-framework-4.8-expert Субагент dotnet-framework-4.8-expert для Codex, заточенный под поддержку и точечный ремонт легаси-приложений на .NET Framework 4.8 без риска сломать окружение Windows. CX Codex ★ 6 505звёзд репо

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

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