# grpc-expert

Субагент grpc-expert для Claude Code проектирует и отлаживает gRPC-сервисы: стриминги, protobuf, каналы, балансировку, TLS и наблюдаемость. Разбирает сбои со статус-кодами.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 1029 у репозитория
- Автор: 0xfurai
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/0xfurai/claude-code-subagents/tree/HEAD/agents/grpc-expert.md
- Обновлён: 2025-10-15
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/grpc-expert

## Что делает

Субагент закрывает весь путь по gRPC: разбирает требования к сервису, пишет `.proto`, помогает с реализацией и настройкой каналов. В фокусе — четыре типа вызовов (unary, server-streaming, client-streaming и двунаправленный стриминг), Protocol Buffers, балансировка, SSL/TLS и обработка статус-кодов.

Внутри — рабочий чек-лист. Он требует, чтобы реализация совпадала со спецификацией `.proto`, стримы выбирались по характеру потока данных, а в логи и метрики попадали латентность, доля ошибок и размер payload. На выходе вы получаете код, схемы, гайд по обработке ошибок, настройку мониторинга и результаты нагрузочных прогонов.

Весь чек-лист завязан на protobuf и `.proto`-файлы, поэтому в проекте без них пользы почти не будет. Установка сводится к одному файлу `grpc-expert.md` в `.claude/agents/`, без скриптов и настроек рядом.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/agents/grpc-expert.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/grpc-expert.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/grpc-expert.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/0xfurai/claude-code-subagents/tree/HEAD/agents/grpc-expert.md

## Когда брать
- выбрать тип стриминга под поток событий от сервиса
- настроить каналы и дедлайны, чтобы вызовы не висели
- разложить сбои по gRPC-статусам вместо текстовых сообщений
- добавить метрики латентности и ошибок в gRPC-сервис
- описать контракт в `.proto` и сверить с ним реализацию

## Примеры запросов агенту
- Опиши сервис заказов в `orders.proto`: unary для записи, server-streaming для статусов.
- Клиент получает `Unavailable` — разбери статус-коды и предложи настройки каналов.
- Добавь в сервис метрики по латентности и ошибкам, а в логи — трейсы запросов.

## Похожие
- [grpc-service-development](https://affpapa.org/nevibecode/skills/grpc-service-development.md) — скилл · 533 установки
- [grpc-development](https://affpapa.org/nevibecode/skills/grpc-development.md) — скилл · 802 установки
- [golang-grpc](https://affpapa.org/nevibecode/skills/claude-mpm-team-golang-grpc.md) — скилл · 523 установки
- [public-grpc-api-design](https://affpapa.org/nevibecode/skills/public-grpc-api-design.md) — скилл · 10200 установок
- [grpc-microservices](https://affpapa.org/nevibecode/skills/grpc-microservices.md) — скилл · 510 установок
- [protobuf-grpc-api-review](https://affpapa.org/nevibecode/skills/protobuf-grpc-api-review.md) — скилл · 7 установок

Из того же набора: [0xfurai/claude-code-subagents](https://affpapa.org/nevibecode/by/0xfurai/claude-code-subagents.md) — 137 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
