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

implementing-realtime-sync — скилл для Claude Code: суть и запуск

Скилл implementing-realtime-sync помогает выбрать и настроить транспорт для передачи данных в реальном времени: стриминг токенов LLM, чаты, совместное редактирование через CRDT и офлайн-синхронизацию.

MIT 1 установок ★ 533 обновлён 2025-12-11

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add ancoleman/ai-design-components --skill implementing-realtime-sync -a claude-code
Открыть на GitHub

Что делает implementing-realtime-sync

Скилл даёт готовые паттерны и дерево решений для real-time архитектуры. Для односторонней передачи данных вроде генерации ответов нейросетей или вывода метрик на дашборды он предлагает Server-Sent Events (SSE) со встроенным механизмом переподключения браузера. Для двустороннего обмена (чаты, игры) используется WebSocket, а для видео и аудиозвонков — WebRTC со связкой через сигнальный сервер.

При совместной работе с документами скилл опирается на связку WebSocket и CRDT-библиотек Yjs либо Automerge, что решает конфликты правок без единого центрального арбитра. Присутствие пользователей (курсоры, индикаторы набора текста) и работа офлайн через IndexedDB вынесены в отдельные сценарии.

При переходе на WebSocket восстанавливать разорванное соединение придётся вручную: скилл требует закладывать экспоненциальную задержку со случайным разбросом (jitter), иначе сервер ляжет под волной одновременных повторов. Внутри собраны примеры кода и библиотек для Python, Rust, Go и TypeScript.

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

  • организовать стриминг токенов LLM через SSE в FastAPI
  • настроить двусторонний чат на WebSocket с обработкой разрывов связи
  • реализовать совместное редактирование текста с помощью Yjs и CRDT
  • добавить отображение чужих курсоров и статуса присутствия пользователей
  • настроить сохранение изменений в IndexedDB для работы приложения без сети

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

  • Покажи, как отдавать стриминг ответа нейросети через SSE в FastAPI
  • Спроектируй совместное редактирование документа в React с помощью Yjs и WebSocket
  • Настрой сохранение правок в IndexedDB и синхронизацию при восстановлении сети

Как установить implementing-realtime-sync

1Через Skills CLI (Vercel)

npx skills add ancoleman/ai-design-components --skill implementing-realtime-sync -a claude-code

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

~/.claude/skills/implementing-realtime-sync/SKILL.md

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

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

Вопросы об implementing-realtime-sync

Как установить implementing-realtime-sync в Claude Code?

Выполните команду npx skills add ancoleman/ai-design-components --skill implementing-realtime-sync -a claude-code.

Когда для real-time задач стоит выбрать SSE вместо WebSocket?

SSE подходит для одностороннего потока данных от сервера к клиенту, например для стриминга токенов LLM или живых метрик. Браузер переподключается автоматически через стандартный EventSource, тогда как WebSocket требует ручной обработки реконнекта.

Какие языки программирования поддерживает скилл?

В материалах скилла есть рекомендации библиотек и примеры для Python, Rust, Go и TypeScript.

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

SKILL.md · MIT
---
name: implementing-realtime-sync
description: Real-time communication patterns for live updates, collaboration, and presence. Use when building chat applications, collaborative tools, live dashboards, or streaming interfaces (LLM responses, metrics). Covers SSE (server-sent events for one-way streams), WebSocket (bidirectional communication), WebRTC (peer-to-peer video/audio), CRDTs (Yjs, Automerge for conflict-free collaboration), presence patterns, offline sync, and scaling strategies. Supports Python, Rust, Go, and TypeScript.
---

# Real-Time Sync

Implement real-time communication for live updates, collaboration, and presence awareness across applications.

## When to Use

Use this skill when building:

- **LLM streaming interfaces** - Stream tokens progressively (ai-chat integration)
- **Live dashboards** - Push metrics and updates to clients
- **Collaborative editing** - Multi-user document/spreadsheet editing with CRDTs
- **Chat applications** - Real-time messaging with presence
- **Multiplayer features** - Cursor tracking, live updates, presence awareness
- **Offline-first apps** - Mobile/PWA with sync-on-reconnect

## Protocol Selection Framework

Choose the transport protocol based on communication pattern:

### Decision Tree

```
ONE-WAY (Server → Client only)
├─ LLM streaming, notifications, live feeds
└─ Use SSE (Server-Sent Events)
   ├─ Automatic reconnection (browser-native)
   ├─ Event IDs for resumption
   └─ Simple HTTP implementation

BIDIRECTIONAL (Client ↔ Server)
├─ Chat, games, collaborative editing
└─ Use WebSocket
   ├─ Manual reconnection required
   ├─ Binary + text support
   └─ Lower latency for two-way

COLLABORATIVE EDITING
├─ Multi-user documents/spreadsheets
└─ Use WebSocket + CRDT (Yjs or Automerge)
   ├─ CRDT handles conflict resolution
   ├─ WebSocket for transport
   └─ Offline-first with sync

PEER-TO-PEER MEDIA
├─ Video, screen sharing, voice calls
└─ Use WebRTC
   ├─ WebSocket for signaling
   ├─ Direct P2P connection
   └─ STUN/TURN for NAT traversal
```

### Protocol Comparison

| Protocol | Direction | Reconnection | Complexity | Best For |
|----------|-----------|--------------|------------|----------|
| SSE | Server → Client | Automatic | Low | Live feeds, LLM streaming |
| WebSocket | Bidirectional | Manual | Medium | Chat, games, collaboration |
| WebRTC | P2P | Complex | High | Video, screen share, voice |

## Implementation Patterns

### Pattern 1: LLM Streaming with SSE

Stream LLM tokens progressively to frontend (ai-chat integration).

**Python (FastAPI):**
```python
from sse_starlette.sse import EventSourceResponse

@app.post("/chat/stream")
async def stream_chat(prompt: str):
    async def generate():
        async for chunk in llm_stream:
            yield {"event": "token", "data": chunk.content}
        yield {"event": "done", "data": "[DONE]"}
    return EventSourceResponse(generate())
```

**Frontend:**
```typescript
const es = new EventSource('/chat/stream')
es.addEventListener('token', (e) => appendToken(e.data))
```

Reference `references/sse.md` for full implementations, reconnection, and event ID resumption.

### Pattern 2: WebSocket Chat

Bidirectional communication for chat applications.

**Python (FastAPI):**
```python
connections: set[WebSocket] = set()

@app.websocket("/ws")
async def websocket_endpoint(websocket: WebSocket):
    await websocket.accept()
    connections.add(websocket)
    try:
        while True:
            data = await websocket.receive_text()
            for conn in connections:
                await conn.send_text(data)
    except WebSocketDisconnect:
        connections.remove(websocket)
```

Reference `references/websockets.md` for multi-language examples, authentication, heartbeats, and scaling.

### Pattern 3: Collaborative Editing with CRDTs

Conflict-free multi-user editing using Yjs.

**TypeScript (Yjs):**
```typescript
import * as Y from 'yjs'
import { WebsocketProvider } from 'y-websocket'

const doc = new Y.Doc()
const provider = new WebsocketProvider('ws://localhost:1234', 'doc-id', doc)
const ytext = doc.getText('content')

ytext.observe(event => console.log('Changes:', event.changes))
ytext.insert(0, 'Hello collaborative world!')
```

Reference `references/crdts.md` for conflict resolution, Yjs vs Automerge, and advanced patterns.

### Pattern 4: Presence Awareness

Track online users, cursor positions, and typing indicators.

**Yjs Awareness API:**
```typescript
const awareness = provider.awareness
awareness.setLocalState({ user: { name: 'Alice' }, cursor: { x: 100, y: 200 } })
awareness.on('change', () => {
  awareness.getStates().forEach((state, clientId) => {
    renderCursor(state.cursor, state.user)
  })
})
```

Reference `references/presence-patterns.md` for cursor tracking, typing indicators, and online status.

### Pattern 5: Offline Sync (Mobile/PWA)

Queue mutations locally and sync when connection restored.

**TypeScript (Yjs + IndexedDB):**
```typescript
import { IndexeddbPersistence } from 'y-indexeddb'
import { WebsocketProvider } from 'y-websocket'

const doc = new Y.Doc()
const indexeddbProvider = new IndexeddbPersistence('my-doc', doc)
const wsProvider = new WebsocketProvider('wss://api.example.com/sync', 'my-doc', doc)

wsProvider.on('status', (e) => {
  console.log(e.status === 'connected' ? 'Online' : 'Offline')
})
```

Reference `references/offline-sync.md` for conflict resolution and sync strategies.

## Library Recommendations

### Python

**WebSocket:**
- `websockets 13.x` - AsyncIO-based, production-ready
- `FastAPI WebSocket` - Built-in, dependency injection
- `Flask-SocketIO` - Socket.IO protocol with fallbacks

**SSE:**
- `sse-starlette` - FastAPI/Starlette, async, generator-based
- `Flask-SSE` - Redis backend for pub/sub

### Rust

**WebSocket:**
- `tokio-tungstenite 0.23` - Tokio integration, production-ready
- `axum WebSocket` - Built-in extractors, tower middleware

**SSE:**
- `axum SSE` - Native support, async streams

### Go

**WebSocket:**
- `gorilla/websocket` - Battle-tested, compression support
- `nhooyr/websocket` - Modern API, context support

**SSE:**
- `net/http` (native) - Flusher interface, no dependencies

### TypeScript

**WebSocket:**
- `ws` - Native WebSocket server, lightweight
- `Socket.io 4.x` - Auto-reconnect, fallbacks, rooms
- `Hono WebSocket` - Edge runtime (Cloudflare Workers, Deno)

**SSE:**
- `EventSource` (native) - Browser-native, automatic retry
- Node.js `http` (native) - Server-side, no dependencies

**CRDT:**
- `Yjs` - Mature, TypeScript/Rust, rich text editing
- `Automerge` - Rust/JS, JSON-like data, time-travel

## Reconnection Strategies

**SSE:** Browser's EventSource handles reconnection automatically with exponential backoff.
**WebSocket:** Implement manual exponential backoff with jitter to prevent thundering herd.

Reference `references/sse.md` and `references/websockets.md` for complete implementation patterns.

## Security Patterns

**Authentication:** Use cookie-based (same-origin) or token in Sec-WebSocket-Protocol header.
**Rate Limiting:** Implement per-user message throttling with sliding window.

Reference `references/websockets.md` for authentication and rate limiting implementations.

## Scaling with Redis Pub/Sub

For horizontal scaling, use Redis pub/sub to broadcast messages across multiple backend servers.

Reference `references/websockets.md` for complete Redis scaling implementation.

## Frontend Integration

### React Hooks Pattern

**SSE for LLM Streaming (ai-chat):**
```typescript
useEffect(() => {
  const es = new EventSource(`/api/chat/stream?prompt=${prompt}`)
  es.addEventListener('token', (e) => setContent(prev => prev + e.data))
  return () => es.close()
}, [prompt])
```

**WebSocket for Live Metrics (dashboards):**
```typescript
useEffect(() => {
  const ws = new WebSocket('ws://localhost:8000/metrics')
  ws.onmessage = (e) => setMetrics(JSON.parse(e.data))
  return () => ws.close()
}, [])
```

**Yjs for Collaborative Tables:**
```typescript
useEffect(() => {
  const doc = new Y.Doc()
  const provider = new WebsocketProvider('ws://localhost:1234', docId, doc)
  const yarray = doc.getArray('rows')
  yarray.observe(() => setRows(yarray.toArray()))
  return () => provider.destroy()
}, [docId])
```

## Reference Documentation

For detailed implementation patterns, consult:

- `references/sse.md` - SSE protocol, reconnection, event IDs
- `references/websockets.md` - WebSocket auth, heartbeats, scaling
- `references/crdts.md` - Yjs vs Automerge, conflict resolution
- `references/presence-patterns.md` - Cursor tracking, typing indicators
- `references/offline-sync.md` - Mobile patterns, conflict strategies

## Example Projects

Working implementations available in:

- `examples/llm-streaming-sse/` - FastAPI SSE for LLM streaming (RUNNABLE)
- `examples/chat-websocket/` - Python FastAPI + TypeScript chat
- `examples/collaborative-yjs/` - Yjs collaborative editor

## Testing Tools

Use scripts to validate implementations:

- `scripts/test_websocket_connection.py` - WebSocket connection testing

© ancoleman · MIT · ancoleman/ai-design-components

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

Все скиллы по теме «Бэкенд и API» →
realtime-sync oakoss Скилл realtime-sync помогает проектировать синхронизацию данных с низкой задержкой, связывать WebTransport, CRDT и пакетный рендеринг потоков ИИ-токенов. CX Codex +1 108установок websockets-realtime travisjneuman Скилл websockets-realtime для Claude Code и Codex помогает настроить передачу данных в реальном времени. Включается при создании чатов, живых лент и совместного редактирования. CX Codex +1 172установок openai-realtime-voice calesthio Скилл openai-realtime-voice для Claude Code помогает проектировать голосовых агентов на OpenAI Realtime API. Запускается при настройке диалогов через WebRTC или WebSocket с вызовом инструментов. CX Codex +1 141установок websocket-realtime rohitg00 Скилл websocket-realtime обучает Claude Code архитектуре реального времени: от чистого WebSocket и Socket.io до Server-Sent Events и связки с Redis. CX Codex +1 ★ 2 858звёзд репо real-time-collaboration-engine curiositech Скилл real-time-collaboration-engine для Claude Code помогает проектировать совместное редактирование в реальном времени через WebSockets, OT или CRDT. Описывает синхронизацию редакторов, досок и курсоров. CX Codex +1 195установок yjs-best-practices liveblocks Скилл yjs-best-practices подсказывает агенту, как не сломать синхронизацию Yjs: дубли импортов, поддокументы, YKeyValue и V2-кодирование. CX Codex +1 325установок

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

Весь набор →
building-ai-chat Скилл building-ai-chat для Claude Code помогает проектировать интерфейсы ИИ-чата с потоковыми ответами, управлением контекстом и вводом файлов, изображений или голоса. Задача — создать ассистента или чат-копилота. CX Codex +1 1установок architecting-networks Скилл architecting-networks помогает проектировать облачные сети: выбирать между плоской архитектурой, multi-VPC, hub-and-spoke и полносвязной топологией. Нужен при планировании VPC, сегментации сети или гибридной связности. CX Codex +1 1установок implementing-navigation Скилл implementing-navigation внедряет шаблоны навигации для React и маршрутизацию для бэкенда на Python с проверкой доступности по стандарту WCAG 2.1 AA. CX Codex +1 1установок security-hardening Скилл security-hardening проверяет и ужесточает настройки ОС, контейнеров, облака, сети и баз данных. Нужен перед production-развёртыванием, аудитом или проверкой уязвимостей. CX Codex +1 1установок implementing-observability Скилл implementing-observability для Claude Code настраивает метрики, логи и трейсы через OpenTelemetry и показывает, как запустить Loki, Grafana, Tempo и Mimir у себя. По трейсу ищут ошибки между сервисами. CX Codex +1 1установок ingesting-data Скилл ingesting-data для Claude Code содержит паттерны и примеры загрузки данных из облачных хранилищ, API, файлов и потоков в базы данных. CX Codex +1 1установок configuring-firewalls Скилл configuring-firewalls помогает настроить правила для Linux-файрволов, облачных групп безопасности и Kubernetes NetworkPolicies. Пригодится при открытии сервиса или ограничении сетевого доступа. CX Codex +1 1установок building-ci-pipelines Скилл building-ci-pipelines для Claude Code помогает создавать безопасные CI/CD-конвейеры с SLSA, кешированием и параллелизацией тестов в GitHub Actions, GitLab CI и Argo Workflows. CX Codex +1 1установок

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

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