用途:该技能为 Effect-TS 代码库提供一套有明确倾向的一致性模式,目标是提升类型安全、可测试性、可观测性与可维护性。
主要能力:以速查表形式给出关键规则,包括服务用 Effect.Service(accessors: true)而非 Context.Tag 承载业务逻辑;依赖在服务内用 dependencies: [Dep.Default] 声明,而非在使用处手动 Layer.provide;错误用 Schema.TaggedError 并带 message 字段;错误要具体(如 UserNotFoundError、SessionExpiredError),避免泛化;用 catchTag/catchTags 而非 catchAll/mapError;实体 ID 用 Schema.UUID.pipe(Schema.brand(...));函数用 Effect.fn("Service.method");日志用 Effect.log 而非 console.log;配置用 Config.* 校验而非 process.env;可空性用 Option<T> 而非 null/undefined;Atom 在组件外创建、全局状态用 Atom.keepAlive、React 中用 useAtomSet、副作用用 get.addFinalizer() 清理、结果用 Result.builder 配合 onErrorTag。
使用方式:作为技能加载后,在编写 Effect.Service、Schema.TaggedError、Layer 组合或 Effect Atom 相关代码时应用上述规则。资料还列出参考文件:service-patterns.md、error-patterns.md、schema-patterns.md、layer-patterns.md、rpc-cluster-patterns.md、effect-atom-patterns.md、anti-patterns.md、observability-patterns.md。
适用场景:Effect-TS 后端服务、RPC/Cluster 工作流、React 前端状态管理及可观测性建设。
限制:资料未提供安装命令、收费与价格、平台支持范围及具体效果数据,暂未提供。