当您需要执行以下操作时，请使用此技能：

当您需要执行以下操作时，请使用此技能：

Yjs提供了六种共享类型。您主要会使用三个：

核心原则：写作是为了耳朵，而不仅仅是眼睛。散文应该适合大声朗读。

具有版本化迁移的表和 KV 存储的类型安全架构定义。

所有规格都位于根 /specs/ 目录中。不要在 apps/ 或 packages/ 中创建嵌套规范。

检查文件是否符合 Web 界面指南。

在 TypeScript 中始终使用类型而不是接口。

使用 typebox ，而不是 @sinclair/typebox 。 @sinclair/typebox 包已被弃用。

每个 .test.ts 文件必须以 JSDoc 块开头，解释正在测试的内容以及验证的关键行为。这作为模块合同的文档。

所有文章必须遵循写作语音规则。

在选择路径 API 之前，请确定您的执行上下文：

客户端的初始化是同步的。异步工作存储为您可以等待的属性，同时传递引用。

始终更喜欢使用来自 TanStack 查询的 createMutation 进行突变。这提供了：

避免创建不必要的包装 div。如果类可以直接应用于现有的语义元素并获得相同的结果，则更喜欢这种方法。

遵循散文部分的写作声音。

当收到规范文档（specs/*.md 文件）时，有条不紊地分批执行它。每波都会产生工作代码、更新的规范和提交。目标是一个干净的 git 历史记录，其中每次提交都代表了符合规范的一个连贯的进展单元。

遵循写作的语气。

接受单个项目和数组，在顶部标准化，统一处理。

该技能记录了如何在 Whispering 架构中实现服务。服务是纯粹的、独立的业务逻辑，没有返回 Result<T, E> 类型以进行错误处理的 UI 依赖项。