SuperAPI AI 工具集

typescript-build-tools

编程与开发

查看项目

更新于 10-16 06:45

技能介绍

用途:为 TypeScript 项目搭建和维护现代构建工具链,帮助在包管理、类型检查、测试、代码检查格式化与单仓编排之间做出与现有仓库一致的选择。

主要能力与选型:按仓库现有 lockfile、packageManager 字段、scripts 和配置沿用既有工具链。存在 bun.lock 或面向 Bun 运行时用 Bun;存在 pnpm-lock.yaml、pnpm-workspace.yaml 或 pnpm packageManager 字段用 pnpm(pnpm 不提供运行时与打包器)。存在 biome.json 用 Biome;存在 .oxlintrc.、oxlint.config.、.oxfmtrc.* 或 oxfmt.config.* 用 Oxlint/Oxfmt。除仓库已在迁移外,不要混用包管理器、检查器或格式化器。

必要用法:Bun 场景可执行 bun add -D typescript @types/bun vitest @vitest/coverage-v8 @biomejs/biome,单仓加 bun add -D turbo;pnpm 场景执行 pnpm add -D typescript @types/node vitest @vitest/coverage-v8 oxlint oxfmt,单仓加 pnpm add -D turbo。类型检查用 pnpm exec tsc --noEmit 或 bunx tsc --noEmit,项目引用用 tsc --build。检查脚本顺序为 typecheck、lint、format:check、test。Bun 管理的 Node 项目用 bun run test 而非 bun test。Oxc 下用 oxlint --fix、oxfmt --check;Biome 下用 biome check --write、biome format --write。

适用场景:单包或 monorepo 的脚本与 CI 配置、Vitest 覆盖率与全局 setup、Turborepo 任务依赖与缓存、Cloudflare Workers 的测试池配置,以及 GitHub Actions 中配合 --frozen-lockfile 的可复现安装。

限制:TypeScript 7.0 不暴露旧版编程式编译器 API,内嵌该 API 的框架与工具可能仍需 TypeScript 6,应遵循其兼容指引;严格模式禁用特定规则需自行配置;类型感知 Oxlint 规则需 oxlint-tsgolint,不建议默认启用实验性 --type-check;pn 仅作交互式别名,CI 中应使用规范 pnpm;具体细节参见 skills 内 references 各文件。