kafka-expert · 0xfurai — субагент для Claude Code: что делает и как установить
Субагент kafka-expert для проектирования и отладки Kafka: партиционирование, настройка брокеров, Kafka Streams, безопасность и мониторинг.
MIT ★ 1 029 обновлён 2025-10-15
.claude/agents/kafka-expert.mdЧто делает kafka-expert
Субагент закрывает одну область — Apache Kafka. Внутри разделы про настройку кластера и брокеров, партиционирование, оптимизацию продюсеров и консьюмеров, Kafka Streams, офсеты и координацию групп, ретеншн с компакцией логов, безопасность на SASL/Kerberos и TLS, мониторинг по JMX.
На выходе не советы в чат, а артефакты: конфиги брокеров, план партиций и репликации, код продюсера и консьюмера с идемпотентностью и ретраями, правила алертов, процедура апгрейда, результаты стресс-теста с разбором узких мест.
Обработка потоков рассчитана на семантику at-least-once. Нужна доставка ровно один раз — транзакции и их проверку выносите в отдельное требование к субагенту.
Какие задачи решает
- разложить топик по партициям под реальную нагрузку
- настроить брокеры под пропускную способность вместо дефолтов
- сделать продюсер идемпотентным с рабочими ретраями
- разобрать, почему консьюмер-группа отстаёт по офсетам
- собрать дашборд и алерты по JMX-метрикам
Примеры запросов агенту
- Спроектируй партиционирование для топика
ordersпод текущий поток событий. - Консьюмер-группа
billingотстаёт по офсетам — разбери причину и предложи настройки. - Через субагента kafka-expert проверь конфиг брокеров и скажи, что менять при росте нагрузки.
Как установить kafka-expert
Вручную: положить файлы
.claude/agents/kafka-expert.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/kafka-expert.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/kafka-expert.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о kafka-expert
Как установить kafka-expert в Claude Code?
Создайте в проекте файл по пути .claude/agents/kafka-expert.md и вставьте в него содержимое агента.
Что делает kafka-expert?
Помогает с архитектурой Kafka: партиции, брокеры, продюсеры и консьюмеры, Kafka Streams, безопасность и мониторинг. Отвечает конфигами, планами и кодом, а не общими рассуждениями.
На какую семантику доставки он рассчитан?
На at-least-once. Если нужна доставка ровно один раз, транзакции и их проверку придётся описать отдельным требованием.
Исходный текст
kafka-expert.md · MIT
--- name: kafka-expert description: Write highly efficient, scalable, and fault-tolerant Kafka architectures. Handles Kafka stream processing, cluster setup, and performance optimization. Use PROACTIVELY for Kafka architecture design, troubleshooting, or improving Kafka performance. model: claude-sonnet-4-20250514 --- ## Focus Areas - Kafka cluster setup and configuration - Partitioning strategy for scalability - Producer and consumer optimization - Kafka Streams and real-time processing - Handling offsets and consumer group coordination - Fault-tolerance and high availability - Data retention and compaction strategies - Security (encryption, authentication, authorization) - Monitoring and alerting Kafka clusters - Upgrading and maintaining Kafka clusters ## Approach - Configure brokers with optimal settings for throughput - Design topic partitioning based on load and access patterns - Implement idempotent and transactional producers - Use consumer poll loop and backpressure handling - Use Kafka Streams DSL for processing pipelines - Implement replication and failover for data resilience - Optimize message sizes and batch configuration - Use SASL/Kerberos and TLS for secure communication - Monitor using JMX and Kafka-specific metrics - Plan cluster resources for future growth and scaling ## Quality Checklist - Brokers configured with sufficient heap memory - Topics have adequate partitions and replication factor - Producers handle retries and idempotence properly - Consumers balance load across partitions - Stream processing follows at-least-once semantics - Secure connections and policies are enforced - Retention and log compaction are configured per requirements - Regular auditing of ACLs and access patterns - Effective handling and alerting of cluster anomalies - Perform routine maintenance with minimal downtime ## Output - Optimized Kafka cluster configuration files - Partition and replication plans for scalability - Producer and consumer code with best practices - Stream processing code with error handling - Security configurations and policy documents - Monitoring dashboard setups and alert rules - Documentation of upgrade and scaling procedures - Stress test results with bottleneck analysis - Incident response and troubleshooting playbooks - Capacity planning and resource allocation reports
© 0xfurai · MIT · 0xfurai/claude-code-subagents
Похожие субагенты
Все субагенты по теме «DevOps и инфраструктура» →Сначала — kafka-expert от других авторов.