用途:该技能用于处理非平凡的 Effect 3 开发工作,包括服务与 Layer、类型化错误、Schema/JSONSchema、Config、运行时与并发、@effect/vitest、@effect/ai 等。仅因文件导入 effect 并不触发此流程。
主要能力:按任务路由到对应参考文档,如 services-layers.md(服务、Layer、标签、Effect.fn)、config.md(配置提供者与密钥)、schema-jsonschema.md(Schema、JSON Schema、编码错误与模型)、testing.md(@effect/vitest、时钟、纤程、重试)、runtime.md(资源、调度、Ref、并发)、streams.md(流与背压)、pattern-matching.md(模式匹配与标签联合)、ai.md(@effect/ai)、sql.md(@effect/sql)、next-js.md(Next.js / @prb/effect-next)、effect-atom.md(Effect Atom)、option-null.md(可空边界上的 Option)。
使用方式:先解析目标包或工作区及其确切安装的 effect 与相关 @effect/* 版本;若 effect 不是 3.x 则停止。检查邻近的服务、Layer、错误、Schema、运行时边界与测试,本地约定决定组织方式,已安装包证据决定 API 事实。先读 references/critical-rules.md,再按任务读取对应参考。编辑前对每个不确定的导入、签名或行为,依据目标工作区可见的包安装进行核实。实现与项目一致的最小模式,并运行覆盖所改语义的最窄测试或类型检查。证据顺序:优先已安装包的 src/、README、测试与变更日志,其次其发布的声明文件,再次匹配的官方包产物或源码标签。不要仅为获取文档而安装或更新依赖,不要信任与目标安装版本不匹配的检出或分支;无法核实确切行为时应停止而非猜测。
适用场景:需要类型化失败与作用域资源、Schema 支撑的错误或模型、配置与密钥、并发与流处理、Effect 测试等 IO 边界工作。
限制:保持纯辅助函数、常量与路径操作纯净,除非 Effect 边界带来具体收益;除非用户要求重构,保留既有领域门面与服务/运行时边界;不要仅为替换小型平台调用而扩大环境要求。完成时按变更或只读工作给出相应状态与验证命令;资料未提供具体命令示例与版本号细节。