用途:在采用 Effect 的 TypeScript 代码库中编写和修改类型化、可组合的服务、Schema 与工作流。核心要求是以当前 Effect v4 / effect-smol 源码为唯一依据,而不是记忆或旧版 Effect v2/v3 示例。
用法:若 .opencode/references/effect-smol 不存在,需在项目中(而非技能目录)克隆 https://github.com/Effect-TS/effect-smol。回答或实现 Effect 相关代码前,先在该目录中查找确切 API、示例、测试与命名模式,同时检查仓库现有代码以遵循本地风格,并优先给出有具体源文件或邻近示例支撑的答案。
主要规范:多用 Effect v4 当前 API 与项目本地模式;多步流程用 Effect.gen(function* () { ... });可复用服务方法或重要流程用 Effect.fn("Name") 或 Effect.fnUntraced(...);API 与领域数据结构优先使用 Effect Schema,建模新错误面时对 ID 使用 branded schema、使用 Schema.TaggedErrorClass 表达类型化领域错误;HTTP 处理保持轻薄(解码输入、读取请求上下文、调用服务、映射传输错误),业务规则放入服务;服务代码中优先使用感知 Effect 的平台抽象与依赖;层组合保持显式,避免隐藏的宽泛依赖注入。不要为了满足类型而引入 any、非空断言、未检查类型转换或旧版 Effect API。
测试:测试 Effect 服务、层、运行时上下文、作用域资源或平台集成时使用 packages/opencode/test/lib/effect.ts 中的 testEffect(...);文件系统、git 仓库、HTTP 服务器、socket、子进程、锁、实时与其它真实平台行为使用 it.live(...);测试须在包目录(如 packages/opencode)运行,不要在仓库根运行;优先显式测试层,保持依赖可见;需清理的临时目录、标志、数据库、fiber、服务器与全局状态应使用作用域 fixture 和 finalizer。限制:以上能力与用法均以所给资料为限,未提供的收费、价格、平台与效果信息暂未提供。