SuperAPI AI 工具集

meta-design-expressive-typescript

编程与开发

查看项目

更新于 10-16 04:59

技能介绍

用途:这是一套 TypeScript 编码风格技能,目标是写出“读者无需在脑中模拟任何片段就能理解意图”的代码。核心是两层模式:顶层编排函数像伪代码一样只做卫语句、命名函数调用和结果组装;底层纯函数各做一件事、可独立测试。

主要能力:命名谓词、命名常量、命名转换;用卫语句和提前返回压平嵌套条件;用可辨识联合加穷尽 switch(default 中 never 赋值)实现类型安全的控制流;异步编排中用 Promise.all 并行独立操作;用 as const satisfies 定义配置以保留字面量类型并校验结构;提供“是否需要抽取”的决策框架,以及何时用原生 JS 方法、何时用工具库的 80/20 原则。

使用方式:在编写或重构混合了校验、转换、组装逻辑的函数时应用;先阅读现有代码再重构;函数命名描述“做什么”而非“怎么做”,例如 isContentAddition(line) 而非 checkLineStartsWithPlusButNotTriplePlus(line)。技能要求代码遵循项目 CLAUDE.md 约定(kebab-case、具名导出、导入排序、import type、具名常量)。

适用场景:超过约 15 行且混合多种职责的函数、需要模拟才能理解的表达式、缺少描述性名称的重复逻辑、深层嵌套 if/else、异步多步流程、状态或事件建模。

限制:不适用于已清晰的一行式函数、学术函数式编程(monad、functor、Either/Option)、point-free 风格、对平凡表达式过度抽取,以及函数调用开销敏感的性能热点。资料未提供安装命令、收费、平台或效果信息。