用途:为 Node/TypeScript 项目搭建并调优 linter 与 formatter,让检查结果聚焦真实缺陷,而不是工具之间互相冲突。主要能力:先根据包管理器锁文件、已有配置(.eslintrc*、eslint.config.、biome.json、.prettierrc*)、框架和插件需求做判断;插件需求决定选型。可选 Biome(lint+format 一体化,适合无特殊插件需求的 TS 库或应用)或 ESLint(仅扁平配置,现代主版本不再加载 eslintrc)加 Prettier(需要插件生态时)。原则:绝不并用两个格式化工具,也不在已有格式化工具时启用 ESLint 风格类规则。会写入显式提交的完整配置、串联 package.json 脚本(lint、format、lint:fix),CI 使用 --max-warnings=0。已有旧配置时按迁移路径处理,例如官方扁平配置迁移器或 biome migrate eslint,并对比有效规则集、保留有意定制。验证方式包括运行 python3 "${CLAUDE_SKILL_DIR}/scripts/check_lint_setup.py",以及 npx biome check . 或 npx eslint . --max-warnings=0。适用场景为 Node/TypeScript 项目初始化和工具迁移。限制:不适用于 Next.js 应用(归 nextjs-quality)、类型检查与 tsconfig(归 node-typescript,Biome 的类型感知规则不能替代 tsc)、测试搭建(归 node-testing)和 CI 流程编写(归 node-ci)。注意扁平配置按被检查文件所在目录解析,monorepo 各包可有独立配置层;biome migrate eslint 会静默丢弃无对应规则,需自行对比列出;工具主版本变化快,相关结论应在使用时重新核对官方文档;仅靠关闭规则通过检查属于失败,应通过修复信号来调优。
node-lint
编程与开发
更新于 10-16 03:14