SuperAPI AI 工具集

gravitas-typescript

编程与开发

查看项目

更新于 10-16 02:33

技能介绍

用途:这是 GRAVITAS 技能针对 TypeScript 项目的扩展,在基础 GRAVITAS 之上补充 TypeScript 特有模式。资料要求先加载 skills/gravitas/SKILL.md,再加载本文件。

主要能力:一、TypeScript 侦察清单,检查 tsconfig.json 是否开启 strict、noUncheckedIndexedAccess、exactOptionalPropertyTypes,package.json 中的 TypeScript 版本与测试运行器(vitest 还是 jest),eslint 配置中的 @typescript-eslint 规则,影响模块的 .d.ts 文件,以及 tsconfig 的 paths 路径别名。二、验证链,按顺序执行:tsc --noEmit、eslint . --max-warnings 0、vitest run --reporter=verbose(或 jest --verbose);可选带覆盖率或类型覆盖率运行。三、反模式约定:不用 any,不用 as 掩盖类型错误,显式处理 undefined,严格空值检查。四、常见失败模式与修复对照,如对象可能未定义、类型不可赋值、属性不存在、找不到模块(路径别名未加)、泛型不匹配、严格模式下隐式 any。五、推荐模式:泛型替代 any、可辨识联合、类型守卫替代断言。六、Vitest 测试结构、vi.mock 模拟方式,以及测试文件位置需遵循项目既有约定。

用法:命令示例包括 cat tsconfig.json | jq '.compilerOptions | {strict, noUncheckedIndexedAccess, exactOptionalPropertyTypes, target, lib}'、tsc --noEmit、eslint . --max-warnings 0、vitest run --reporter=verbose、vitest run --coverage --reporter=verbose、npx type-coverage --strict(可选,需安装 type-coverage)、find src/ -name "*.test.ts"、vitest run src/auth/session.test.ts、vitest --watch。

适用场景:需要按 TypeScript 严格类型与测试规范进行代码检查、重构或缺陷修复的 TS 项目。

限制:资料未提供安装方式、依赖要求、许可与收费信息;type-coverage 为可选工具,需另行安装;测试文件位置等约定需以实际项目为准。