К основному содержанию
скилл CX Codex

kafka-expert — скилл для Claude Code: что делает и как установить

Скилл kafka-expert для Apache Kafka: продюсеры, консьюмеры, Kafka Streams и партиционирование — пригодится, когда в проекте появляется событийная шина.

Apache-2.0 220 установок ★ 45 обновлён 2026-10-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add personamanagmentlayer/pcl --skill kafka-expert -a claude-code
Открыть на GitHub

Что делает kafka-expert

Скилл подключается, когда в разговоре всплывают Kafka, Kafka Streams или событийная архитектура. Внутри разбор базовых понятий: топики, партиции, оффсеты, группы консьюмеров, Kafka Connect, семантика exactly-once.

Код идёт готовыми примерами. Продюсер на Python с acks='all' и повторами, консьюмер с enable_auto_commit=False и ручным коммитом, топология Kafka Streams на Java с фильтром и mapValues. Адрес брокера в них один и тот же — localhost:9092, так что под свой кластер примеры придётся переписать.

Дальше список практик: ключи партиционирования, отслеживание лага консьюмеров, идемпотентные продюсеры, аккуратный ребаланс. Рядом антипаттерны — топик из одной партиции, синхронная обработка, отсутствие мониторинга. В allowed-tools прописан только Bash(kafka:*), поэтому команды вне kafka скилл через bash не запустит.

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

  • Собрать продюсера с подтверждением записи от всех реплик
  • Перевести консьюмер на ручной коммит оффсетов
  • Написать топологию Kafka Streams с фильтрацией потока
  • Разложить нагрузку по партициям, не потеряв порядок событий
  • Разобраться, почему растёт лаг консьюмеров

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

  • Собери продюсера на Python, который шлёт события в топик user-events с acks='all'
  • Почему у консьюмера растёт лаг и как включить ручной коммит оффсетов?
  • Сделай топологию Kafka Streams: отбрось записи короче 10 символов и переведи остальные в верхний регистр

Как установить kafka-expert

1Через Skills CLI (Vercel)

npx skills add personamanagmentlayer/pcl --skill kafka-expert -a claude-code

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

~/.claude/skills/kafka-expert/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/kafka-expert/

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

Вопросы о kafka-expert

Как установить kafka-expert в Claude Code?

Выполните npx skills add personamanagmentlayer/pcl --skill kafka-expert -a claude-code, затем файл скилла окажется по пути ~/.claude/skills/kafka-expert/SKILL.md.

Что делает kafka-expert?

Даёт агенту экспертизу по Apache Kafka: понятия топиков и партиций, рабочие примеры продюсера и консьюмера, топологию Kafka Streams, практики и антипаттерны.

Какие инструменты разрешены скиллу?

Read, Write, Edit и Bash(kafka:*). Из bash доступны только команды kafka, остальное не выполнится.

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

SKILL.md · Apache-2.0
---
name: kafka-expert
version: 1.1.0
description: >-
  Expert-level Apache Kafka, event streaming, Kafka Streams, and distributed messaging. Use
  when the user mentions streaming, messaging, event driven, or Kafka Streams.
category: data
tags: [kafka, streaming, messaging, event-driven, kafka-streams]
allowed-tools:
  - Read
  - Write
  - Edit
  - Bash(kafka:*)
---

# Apache Kafka Expert

Expert guidance for Apache Kafka, event streaming, Kafka Streams, and building event-driven architectures.

## Core Concepts

- Topics, partitions, and offsets
- Producers and consumers
- Consumer groups
- Kafka Streams
- Kafka Connect
- Exactly-once semantics

## Producer

```python
from kafka import KafkaProducer
import json

producer = KafkaProducer(
    bootstrap_servers=['localhost:9092'],
    value_serializer=lambda v: json.dumps(v).encode('utf-8'),
    acks='all',  # Wait for all replicas
    retries=3
)

# Send message
future = producer.send('user-events', {
    'user_id': '123',
    'event': 'login',
    'timestamp': '2024-01-01T00:00:00Z'
})

# Wait for acknowledgment
record_metadata = future.get(timeout=10)
print(f"Topic: {record_metadata.topic}, Partition: {record_metadata.partition}")

producer.flush()
producer.close()
```

## Consumer

```python
from kafka import KafkaConsumer

consumer = KafkaConsumer(
    'user-events',
    bootstrap_servers=['localhost:9092'],
    group_id='my-group',
    auto_offset_reset='earliest',
    enable_auto_commit=False,
    value_deserializer=lambda m: json.loads(m.decode('utf-8'))
)

for message in consumer:
    print(f"Received: {message.value}")

    # Process message
    process_event(message.value)

    # Manual commit
    consumer.commit()
```

## Kafka Streams

```java
Properties props = new Properties();
props.put(StreamsConfig.APPLICATION_ID_CONFIG, "streams-app");
props.put(StreamsConfig.BOOTSTRAP_SERVERS_CONFIG, "localhost:9092");

StreamsBuilder builder = new StreamsBuilder();

KStream<String, String> source = builder.stream("input-topic");

// Transform and filter
KStream<String, String> transformed = source
    .filter((key, value) -> value.length() > 10)
    .mapValues(value -> value.toUpperCase());

transformed.to("output-topic");

KafkaStreams streams = new KafkaStreams(builder.build(), props);
streams.start();
```

## Best Practices

- Use appropriate partition keys
- Monitor consumer lag
- Implement idempotent producers
- Use consumer groups for scaling
- Set proper retention policies
- Handle rebalancing gracefully
- Monitor cluster metrics

## Anti-Patterns

❌ Single partition topics
❌ No error handling
❌ Ignoring consumer lag
❌ Producing to wrong partitions
❌ Not using consumer groups
❌ Synchronous processing
❌ No monitoring

## Resources

- Apache Kafka: https://kafka.apache.org/
- Confluent Platform: https://www.confluent.io/

© personamanagmentlayer · Apache-2.0 · personamanagmentlayer/pcl

Похожие скиллы

Все скиллы по теме «Данные и базы» →
kafka-stream-processing manutej Скилл kafka-stream-processing снабжает ИИ-агента инструкциями по проектированию потоковой обработки на Apache Kafka. Он пригодится при настройке продюсеров, консьюмеров и топологий Kafka Streams. CX Codex +1 482установок Kafka Streaming taste f Промпт Kafka Streaming taste задаёт правила проектирования и архитектуры потоков данных в Kafka для ChatGPT, Claude.ai и Claude Code. GP ChatGPT ★ 178 201звёзд репо kafka-development Mindrally Скилл kafka-development для Claude Code содержит лучшие практики Apache Kafka и помогает настраивать producer/consumer-пайплайны, партиционирование топиков, Kafka Streams и Schema Registry. CX Codex +1 1 200установок neo4j-kafka-skill neo4j-contrib Скилл neo4j-kafka-skill для Claude Code помогает настраивать Neo4j Connector for Kafka и потоковую репликацию через CDC. Стримит события из Kafka в граф или выгружает изменения Neo4j в топики. CX Codex +1 814установок event-driven-architecture travisjneuman Скилл event-driven-architecture для Claude Code помогает проектировать системы с асинхронными сообщениями, брокерами и распределёнными сценариями. Разбирает архитектуру микросервисов и потоков событий. CX Codex +1 143установок Kafka Schema Registry aywengo MCP-сервер Kafka Schema Registry даёт ИИ-агенту инструменты для работы со схемами Kafka: от просмотра и экспорта до регистрации и миграции между реестрами. CX Codex +1

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

Весь набор →
standards-expert Скилл standards-expert для Claude Code даёт агенту справочник по шести стандартам ISO: процессы, риски и аудиты. Используйте его при подготовке системы менеджмента к сертификации. CX Codex +1 226установок flask-expert Скилл flask-expert для Claude Code помогает разрабатывать Flask-приложения, REST API и серверную часть на Python. Охватывает маршруты, Jinja2, расширения и подготовку к продакшену. CX Codex +1 225установок csharp-expert Скилл csharp-expert для Claude Code помогает писать и разбирать современный C# для .NET, ASP.NET Core и корпоративных приложений. Работает с async-кодом, LINQ и типовыми архитектурными решениями. CX Codex +1 221установок maritime-expert Скилл maritime-expert для Claude Code даёт агенту знания о морских системах, судах, портах и грузах. Помогает проектировать логистическое и портовое ПО. CX Codex +1 221установок fastapi-expert Скилл fastapi-expert для разработки API на FastAPI: модели Pydantic, JWT-авторизация, SQLAlchemy и фоновые задачи с готовыми примерами кода. CX Codex +1 218установок nodejs-expert Скилл nodejs-expert направляет агента в разработке бэкенда на Node.js: учит настраивать Express, валидацию через Joi или Zod, обработку ошибок и кластеризацию. CX Codex +1 216установок databricks-expert Скилл databricks-expert для Claude Code подключает агенту практики Databricks: кластеры, Delta Lake, PySpark и MLflow. Разбирает медленные пайплайны и сбои на join. CX Codex +1 215установок kubernetes-expert Скилл kubernetes-expert помогает управлять кластерами Kubernetes, писать манифесты, дебажить поды через kubectl и собирать чарты Helm. Пригодится при настройке инфраструктуры. CX Codex +1 215установок

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

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