SuperAPI AI 工具集

typescript-functions

编程与开发

查看项目

更新于 10-16 01:17

技能介绍

用途:在具体任务中应用 TypeScript Style Guide 的函数约定,可执行应用、审查或解释三类操作。

主要能力:围绕函数职责单一、依赖通过参数显式传入、计算或转换数据时返回值、尽量避免副作用等原则给出指导;区分无状态、确定性与纯函数,并说明网络请求、存储、日志、UI 更新等必要副作用应保持函数小且与纯业务逻辑隔离。参数方面,多个相关参数时倾向使用单一对象参数,使调用点更易理解并便于 API 演进;含义与顺序明显或约定签名更清晰时保留位置参数。尽量让多数参数为必填,少用可选参数;参数过多说明应拆分函数;互斥参数建议使用可辨识联合类型。返回类型方面,主张“外部显式、内部隐式”:API 或库等模块边界显式标注,内部逻辑交给 TypeScript 推断;显式返回类型有助于可读性、避免误用、尽早暴露类型错误、简化重构、促进接口设计讨论,并可能改善编译性能。

使用方式:先检查使用方仓库的约定与配置,仓库显式约定优先于本指南;只应用、审查或解释与当前任务相关的指导;当设计取决于上下文或判断时,说明重要权衡。涉及互斥函数参数时,可在可用时使用 typescript-discriminated-unions。

限制:TypeScript 与 ESLint 能自动检查的内容仍交由它们负责;不因该技能处于激活状态而引入无关的 TypeScript Style Guide 约定。资料未提供具体安装命令、收费方式或平台信息。