SuperAPI AI 工具集

functional-ts-review-ja

通用与其它

查看项目

更新于 10-16 08:40

技能介绍

用途:按 functional-ts-ja 技能定义的函数式领域建模原则,审查服务端 TypeScript 代码。各检查项与 functional-ts-ja 的章节一一对应,指摘时以相对链接标明依据出处。

主要能力:覆盖六类检查。一是类型建模,包括用 Discriminated Union 表达状态、discriminant 统一为 kind、不用 class 而用 Companion Object、领域类型用 type 而非 interface、用函数属性记法、对语义不同的原始值使用 Branded Types、领域对象加 Readonly<>、一概念一文件。二是函数式状态迁移,要求迁移函数以参数类型约束迁移源,switch 分支带 assertNever 穷尽检查。三是错误处理,领域层不 throw,错误类型用 Discriminated Union,用 Result 链式组合而非立即解包。四是边界防御,所有外部边界做 schema 校验、不用 as 断言、PII 字段用 Sensitive<T> 包装。五是声明式风格,数组操作用 filter/map/reduce,领域事件以不可变记录发布。六是测试数据用 as const satisfies Type 定义 fixture。

使用方式:先读取 ../functional-ts-ja/SKILL.md 及 error-handling.md、boundary-defense.md、state-modeling.md,并按项目 package.json 选择 validation-libraries(zod.md / valibot.md / arktype.md)与 result-libraries(neverthrow.md / byethrow.md / fp-ts.md / option-t.md)指南;再读目标文件,按原则顺序扫描检查项;发现违规时附原则、理由与修正案,非违规但有改进空间则作为建议提出。指摘需写明问题位置(path:line)、原因(含原则链接与风险)和修正代码示例。

适用场景:服务端 TypeScript 代码评审,尤其是采用函数式领域建模的项目。

限制:资料未提供安装命令、运行方式、收费与平台信息;重要度分级中 as 断言、PII 未保护、外部边界校验不足、Branded Types 不足列为 High,class 使用、optional 状态建模、领域层 throw 等列为 Medium,方法记法、interface 使用、Readonly 缺失等列为 Low。