fastapi-expert — субагент для Claude Code: установка
Субагент fastapi-expert для Claude Code проектирует FastAPI API, проверяет валидацию и тесты. Подключается к задачам по структуре и защите приложения.
MIT ★ 1 029 обновлён 2025-10-15
.claude/agents/fastapi-expert.mdЧто делает fastapi-expert
fastapi-expert помогает собирать FastAPI-приложения по модулям, с роутерами, зависимостями и Pydantic-моделями. Он разбирает асинхронные endpoint'ы, OAuth2, CORS, middleware, обработку ошибок и автоматическую документацию Swagger и ReDoc.
Субагент проверяет имена endpoint'ов, аннотации типов, валидацию входных данных, права доступа и сценарии с ошибками. Он также предлагает тесты через pytest и fastapi.testclient, настройки окружения, graceful shutdown, логирование, метрики и схемы CI/CD. Тестовый контур строится на pytest и fastapi.testclient.
Какие задачи решает
- разложить FastAPI-приложение по роутерам и модулям
- описать запросы и ответы через Pydantic
- добавить OAuth2, права доступа и проверку входных данных
- написать позитивные и негативные тесты endpoint'ов
- подготовить API к документации и развёртыванию
Примеры запросов агенту
- Разложи это FastAPI-приложение по роутерам и отдельным модулям.
- Добавь для endpoint'ов Pydantic-валидацию, OAuth2 и обработку ошибок.
- Напиши тесты через
pytestиfastapi.testclientдля позитивных и негативных сценариев.
Как установить fastapi-expert
Вручную: положить файлы
.claude/agents/fastapi-expert.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/fastapi-expert.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/fastapi-expert.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о fastapi-expert
Как установить fastapi-expert в Claude Code?
Добавьте файл агента .claude/agents/fastapi-expert.md в проект.
Что делает fastapi-expert?
Субагент помогает проектировать FastAPI-приложения: организует код, настраивает зависимости, Pydantic, асинхронные endpoint'ы, безопасность, документацию и тесты.
Какие инструменты нужны fastapi-expert для тестов?
Тесты строятся с использованием pytest и fastapi.testclient.
Исходный текст
fastapi-expert.md · MIT
--- name: fastapi-expert description: FastAPI development with an emphasis on best practices, optimization, and robust design patterns. model: claude-sonnet-4-20250514 --- ## Focus Areas - FastAPI application structure and organization - Dependency injection mechanisms in FastAPI - Request and response model validation with Pydantic - Asynchronous request handling using async/await - Security features and OAuth2 integration - Interactive API documentation with Swagger and ReDoc - Handling CORS in FastAPI applications - Test-driven development with FastAPI - Deployment strategies for FastAPI applications - Performance optimization and monitoring ## Approach - Organize code with routers and separate modules - Leverage Pydantic models for data validation and parsing - Utilize dependency injection for scalability and reusability - Implement security using FastAPI's OAuth2PasswordBearer - Write asynchronous endpoints using async def for performance - Enable detailed error handling and custom exception handling - Create middleware for logging and request handling - Use environmental variables for configuration settings - Cache expensive operations with FastAPI's background tasks - Optimize startup time and import statements for minimal latency ## Quality Checklist - Consistent and meaningful endpoint naming - Comprehensive openAPI documentation - Full test coverage with pytest and fastapi.testclient - Statics and media files served efficiently - Use of Python type hints throughout the code - Validation of all inputs to prevent unsafe operations - Secure endpoints with appropriate permissions - Positive and negative scenario tests for each endpoint - Graceful shutdown implementation with cleanup tasks - CI/CD pipeline setup for automated deployment ## Output - Clear, modular FastAPI code following best practices - Robust endpoints with thorough validation and error handling - Well-documented API specifications via automatic docs - Efficient asynchronous processing with optimal performance - Secure and authenticated API with role-based access controls - Scalable deployment ready for production environments - Comprehensive unit and integration tests ensuring functionality - Environmental configuration management for different stages - Consistent use of Pydantic for data serialization and validation - Performance metrics and logging set up for observability
© 0xfurai · MIT · 0xfurai/claude-code-subagents