yjs

Skill do obsługi wzorców CRDT w Yjs. Pracujesz nad aplikacją kolaboracyjną? Potrzebujesz rozwiązać konflikty edycji, zarządzać Y.Map, Y.Array i Y.Text, czy zaimplementować synchronizację offline-first? Ten skill daje ci dostęp do wzorców współdzielonych typów danych, strategii rozwiązywania konfliktów (wyższa clientID wygrywa) oraz optymalizacji przechowywania dokumentów. Idealny dla agentów budujących edytory wspólne, aplikacje z drag-and-drop czy systemy z wysoką zmiennością danych.

1. Zainstaluj skill w swoim projekcie agenta, wskazując na repozytorium EpicenterHQ. Skill automatycznie aktywuje się, gdy agent wykryje w zapytaniu słowa kluczowe: Yjs, Y.Doc, CRDT, collaborative editing, shared types, real-time sync lub document storage.

2. Zdefiniuj swój model danych za pomocą współdzielonych typów Yjs. Wybierz Y.Map dla par klucz-wartość, Y.Array dla list uporządkowanych lub Y.Text dla tekstu z formatowaniem. Unikaj wycieku surowych typów Yjs do kodu konsumenta — opakowuj je abstrakcją.

3. Obsługuj konflikty edycji, pamiętając że wyższa clientID dokumentu wygrywa w przypadku jednoczesnych zapisów na ten sam klucz. Dla operacji podatnych na konflikty używaj single-writer keys lub zagnieżdżonych map, aby zmniejszyć ryzyko kolizji.

4. Implementuj drag-and-drop reordering z fractional indexing w Y.Array, aby uniknąć problemów z sekwencyjnym numerowaniem w środowisku rozproszczonym.

5. Optymalizuj przechowywanie Yjs dla workloadów o wysokiej zmienności klucz-wartość, przegląd granic między warstwami, aby zapobiec nieefektywności synchronizacji.

6. Sprawdź powiązany skill workspace-api, jeśli budujesz abstrakcję workspace na bazie Yjs — zawiera on dodatkowe wzorce dla zarządzania przestrzeniami roboczymi.