yjs-best-practices

用途：该技能是一份面向 Yjs（高性能 CRDT 框架）的实践指南，用于构建实时协作应用。在实现协同编辑、实时同步、共享数据与用户状态时参考。主要能力：按 8 类共 24 条规则组织，含核心文档生命周期（CRITICAL）、共享类型、网络提供器、编辑器绑定、用户感知、撤销重做、常见陷阱与调试。核心规则覆盖 Y.Doc 创建、clientID、gc 设置，transact() 事务与事件顺序，encodeStateAsUpdate、applyUpdate、mergeUpdates 与状态向量，以及垃圾回收与版本历史。共享类型覆盖 Y.Text/RichText、Y.Array、Y.Map、YKeyValue、Y.XmlFragment 等；提供器覆盖 y-websocket、y-webrtc、y-indexeddb 与自定义提供器；编辑器绑定覆盖 TipTap、ProseMirror、CodeMirror、Quill、Monaco；另含 awareness 用户存在与光标、Y.UndoManager 撤销重做、重复导入与子文档等陷阱、以及调试常见问题。使用方式：阅读各规则文件，如 rules/core/core-ydoc-setup.md、rules/shared-types/types-ytext.md、rules/providers/provider-websocket.md；每个规则含原因说明、正确代码示例、验证清单与官方文档指针；入口为 AGENTS.md 压缩索引，AGENTS.full.md 为完整展开版。适用场景：协同文档编辑、实时同步、编辑器集成、离线持久化与状态调试。限制：资料未提供具体版本要求、安装命令、收费与平台信息，暂未提供。