SuperAPI AI 工具集

scan-effect-solutions

编程与开发

查看项目

更新于 10-16 03:42

技能介绍

用途:对仓库进行 Effect TypeScript 合规审计,依据 effect.solutions 的推荐实践输出统一的、基于证据的报告。适用场景包括检查 Effect 最佳实践、扫描 Effect 反模式,或用户提到 effect scan、effect audit、effect best-practices checks 时。

主要能力:按 8 个检查项逐项核对——1) TypeScript 配置(exactOptionalPropertyTypes、strict、noUnusedLocals、declarationMap、sourceMap,Effect Language Service 插件,module 设置);2) Services 与 Layers 模式(Context.Tag、@path/ServiceName 标识、Layer.effect/Layer.sync、入口处单一 Effect.provide);3) 数据建模(Schema.Class、Schema.TaggedClass、branded types、Match.valueTags);4) 错误处理(Schema.TaggedError、catchTag/catchTags、缺陷与类型化错误的区分);5) 配置(Schema.Config、config service layer、Config.redacted);6) 测试(@effect/vitest、it.effect()、层组合);7) 运行时执行反模式(应用代码中裸用 Effect.runPromise / Effect.runSync,排除测试文件);8) Option/Either 内部 _tag 分支反模式。

使用方式:先加载当前推荐,执行 effect-solutions list,并按需 effect-solutions show tsconfig / services-and-layers / data-modeling / error-handling / config / testing;再加载 effect-ts 技能。随后按清单逐项检查代码,输出含总分(0-16,按各节 0-2 分累加并换算百分比)、表现良好项、需改进项(含文件位置、当前模式、推荐模式、优先级、生产或测试范围标签)、快速修复与后续步骤的报告。

限制:仅适用于 Effect TypeScript 项目;评分与建议依赖 effect.solutions 的当前推荐;测试文件可豁免运行时与部分 _tag 断言检查;具体命令与流程以技能资料为准,其余细节暂未提供。