SuperAPI AI 工具集

effect-expert

编程与开发

查看项目

更新于 10-15 17:27

技能介绍

用途:在涉及 Effect 服务、Layer、Schema 错误、配置与运行时集成时加载该技能,按 effect.solutions 标准审查和指导 Effect TypeScript 最佳实践。

主要能力:覆盖服务与 Layer 设计、类型化错误处理、数据建模、配置、测试策略(@effect/vitest、测试 Layer)以及运行时集成(TRPC/服务端边界)。提供决策树,将服务设计或重构指向 references/services-and-layers.md,类型化错误、Option/Either 与恢复指向 references/error-handling.md,TRPC/服务端运行时边界指向 references/framework-integration.md,agent-tools/* 中的 CLI 工具指向 references/agent-tools-patterns.md,测试与 mock 指向 references/testing-layers.md。

使用方式:实现或审查前先获取当前建议,运行 effect-solutions list,以及 effect-solutions show tsconfig、basics、services-and-layers、data-modeling、error-handling、config、testing、cli。项目规则要求优先服务共置(Context.Tag 与静态 layer 同文件)、使用 Schema.TaggedError 表示领域错误、不通过 _tag 访问 Option/Either 内部而使用 match、isNone、isLeft 等辅助函数、Effect 依赖用 Layer 而非 vi.mock() 进行 mock、在入口点保留一个清晰的 provide 边界。输出应说明检查了哪些 effect-solutions show 主题、使用了哪些参考文件及原因、符合现有项目模式的具体变更提案,以及验证计划(类型检查/测试)。

适用场景:编辑 packages/services/ 或 agent-tools/* 中的服务文件、需要 Effect 代码测试策略、需要 Effect 运行时集成时。

限制:Effect 指导会演进,不应依赖过时记忆;资料未提供收费、价格、平台或效果等信息。