SuperAPI AI 工具集

biome-lint

编程与开发

查看项目

更新于 10-16 03:58

技能介绍

Biome Lint & TypeScript Type-Check 技能简介

用途 该技能用于修复 Biome 代码检查器错误、TypeScript/tsgo 类型检查错误,以及运行 lint/typecheck 相关工作流。适用于在 TypeScript 项目中处理 Biome 规则报错、类型错误和导入类型问题的场景。

主要能力 提供常见错误与修复方法的快速对照表,覆盖以下 Biome 规则与 TypeScript 错误:

  • noImplicitAnyLet:为 let 变量添加类型,let x; 改为 let x: Type;
  • noUnusedVariables:给未使用变量加下划线前缀,const foo 改为 const _foo;
  • noUnusedFunctionParameters:在解构中重命名,{ param } 改为 { param: _param };
  • noEmptyPattern:将 {} 替换为 _opts: object;
  • noUnreachable:移除死代码或用块注释包裹;
  • noInvalidUseBeforeDeclaration:将声明移到使用之前或提取为 const;
  • TS2322:使用类型断言或过滤,如 as Record<string, string>;
  • TS2345:使用非空断言或默认值,如 value! 或 value ?? '';
  • TS7030:添加显式返回,如 return undefined;;
  • TS2339:通过类型断言扩展,如 as Type & { prop?: T }。

使用方式 Biome Lint 工作流:

  1. 自动修复:pnpm biome lint ./src --write
  2. 检查剩余错误:pnpm biome lint ./src
  3. 修复导入类型问题:npx -y @biomejs/biome lint --only=style/useImportType ./src --write

TypeScript 检查:

  • 单包:pnpm tsgo -p tsconfig.json --skipLibCheck --maxNodeModuleJsDepth 0 --noEmit
  • 所有包:pnpm -r exec just typecheck

单包规则覆盖:可创建本地 biome.json 覆盖规则,配置中设置 "root": false、"extends": "//",并在 linter.rules 中指定 correctness 与 a11y 规则的等级为 warn。

biome-ignore 注释:可使用 // biome-ignore lint/<规则组>/<规则名>: <原因> 的形式忽略特定规则,例如忽略 noSelfCompare(NaN 检查)和 noConstructorReturn(proxy 模式)。

详细指南 该技能附带详细指南,包括 Biome 修复(各 Biome 规则的完整修复示例)、TypeScript 修复(TS 错误、ES 版本问题、跨包依赖),以及破坏性变更(Zod 4、vitest 4、react-router v7 等)。具体内容暂未提供。

适用场景 适用于使用 Biome 作为代码检查工具、并使用 tsgo 进行类型检查的 TypeScript 项目,尤其是需要批量修复 lint 错误、处理类型检查报错或配置单包规则覆盖的开发工作流。

限制 该技能聚焦于错误修复与工作流命令,具体修复效果取决于项目配置与代码上下文;官方文档与更详细说明暂未提供。