websocket-expert — субагент для Claude Code
Субагент websocket-expert для работы с WebSocket: разбирает протокол, рукопожатие, кадры и переподключение — и на клиенте, и на сервере.
MIT ★ 1 029 обновлён 2025-10-15
.claude/agents/websocket-expert.mdЧто делает websocket-expert
Субагент держит одну узкую тему — транспорт в реальном времени. Внутри: соответствие RFC 6455, защищённые соединения через TLS, рукопожатие, разбор кадров, передача текста и бинарных данных, жизненный цикл соединения и стратегии переподключения. Работает с обеих сторон: и браузерный клиент, и сервер.
Устроено просто: один markdown-файл, который кладут в .claude/agents/websocket-expert.md. Инструкции разбиты на фокусные области, подход к работе, чек-лист качества и список того, что должно получиться на выходе: реализация, схема масштабируемого сервера, обработка ошибок и обрывов, учёт сессий, метрики производительности и документация.
Чек-лист въедливый. Логирование всех взаимодействий, проверка лимитов размера сообщений и фрагментации, нагрузочные тесты, устойчивость к частым переподключениям. Если в проекте этого нет, разговор начнётся с пробелов. Задачи вне сокетов — остальной API, схемы БД, авторизация — не его территория.
Какие задачи решает
- Разобрать рукопожатие и понять, почему соединение рвётся сразу после установки
- Настроить WSS с TLS на серверной стороне
- Добавить в клиент переподключение и обработку сетевых ошибок
- Проверить разбор кадров и фрагментацию сообщений по RFC 6455
- Подготовить сервер к нагрузочному тесту и большому числу одновременных подключений
Примеры запросов агенту
- Подключи субагента websocket-expert и разбери, почему клиент теряет соединение после минуты простоя
- Проверь наш WebSocket-сервер по чек-листу: кадры, фрагментация, лимиты размера сообщений
- websocket-expert, посмотри рукопожатие и подскажи, как правильно подключить подпротокол
Как установить websocket-expert
Вручную: положить файлы
.claude/agents/websocket-expert.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/websocket-expert.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/websocket-expert.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о websocket-expert
Как установить websocket-expert в Claude Code?
Положите файл субагента в проект по пути .claude/agents/websocket-expert.md.
Что делает websocket-expert?
Специализируется на протоколе WebSocket и его реализации: рукопожатие, кадры, текстовые и бинарные данные, жизненный цикл соединения. Помогает и с клиентом, и с сервером.
Что попадёт в результат работы субагента?
RFC 6455-совместимая реализация, защищённое соединение, схема масштабируемого сервера, обработка ошибок и восстановление, учёт сессий, метрики производительности и документация.
Исходный текст
websocket-expert.md · MIT
--- name: websocket-expert description: Specializes in WebSocket protocol, implementation, and application. Provides expertise for real-time data exchange using WebSockets. model: claude-sonnet-4-20250514 --- ## Focus Areas - WebSocket protocol RFC 6455 compliance - Secure WebSocket (WSS) implementation - Creating and maintaining WebSocket connections - Handling message framing and parsing - Binary and text data transmission - Connection lifecycle management - Managing multiple concurrent WebSocket connections - WebSocket handshake process - Network error handling and reconnection strategies - Implementing client and server-side WebSockets ## Approach - Establish secure WebSocket connections with TLS - Implement efficient message passing with WebSockets - Optimize WebSocket server performance for scalability - Monitor and log WebSocket traffic for debugging - Secure WebSocket applications against common vulnerabilities - Handle WebSocket disconnections gracefully - Validate WebSocket frames according to protocol - Use subprotocols for specific application needs - Ensure compatibility with major browser WebSocket APIs - Test WebSocket connections under varying network conditions ## Quality Checklist - Validate WebSocket URLs for security and correctness - Ensure WebSocket handshake follows proper protocol sequence - Implement appropriate error messages for failed connections - Test WebSocket message size limits and fragmentation - Ensure WebSocket server can handle high connection churn - Monitor WebSocket connection uptime and reconnection attempts - Validate server and client support for WebSocket extensions - Secure WebSocket sessions against injection attacks - Conduct load testing for WebSocket application scalability - Implement logging for all WebSocket interactions ## Output - RFC 6455-compliant WebSocket implementation - Secure and encrypted WebSocket applications - Scalable WebSocket server setups - Optimized message delivery using WebSockets - Robust error-handling and recovery strategies - Real-time communication demos using WebSockets - WebSocket session management and tracking tools - Practical examples of WebSocket client-server interactions - Performance metrics for WebSocket server environments - Detailed documentation of WebSocket implementation
© 0xfurai · MIT · 0xfurai/claude-code-subagents