SuperAPI AI 工具集

pauls-project-setup

测试与质量

查看项目

更新于 10-16 03:16

技能介绍

用途:在启动新项目或初始化仓库时,采用这套现代技术栈与配置约定,以提升执行速度、减少配置开销,并避免开发过程中的缓慢构建步骤。

主要能力与约定:包管理器使用 pnpm,以获得严格的依赖解析与速度;类型检查采用 buildless-types 标准,即在 .js 文件中使用完整 JSDoc 注解,或在 .ts 文件中使用可擦除语法配合 tsc --noEmit,从而无需构建步骤即可获得类型安全;测试使用 Node.js 原生测试运行器 node --test,完全避免 Jest;打包与开发服务器使用 esbuild;代码检查使用 oxlint。同构核心要求将核心编排、逻辑与数学部分放在与浏览器无关的库中,可直接在 Node.js 中测试,Web UI 仅作为薄展示层,便于编码代理通过 CLI/Node 单元测试快速迭代,避免浏览器自动化的高开销。

使用方式:package.json 需设为 ES Module,并定义标准脚本,例如 test、test:node、typecheck、lint、preflight;engines 要求 node >=24.11.0。tsconfig.json 需符合 buildless-types 约束,如 erasableSyntaxOnly、verbatimModuleSyntax、allowImportingTsExtensions。直接使用 node script.ts 运行文件,不要使用 npx tsx 或 ts-node。测试优先使用 node --test,若需更丰富生态或类浏览器环境则用 vitest。打包使用 esbuild。lint 使用 oxlint,并在项目根目录配置 .oxlintrc.json。

适用场景:适合希望快速启动、低配置、无构建步骤的现代 JavaScript/TypeScript 项目,尤其是需要编码代理高效迭代逻辑的场景。

限制:资料未提供具体安装命令、版本兼容细节、性能数据或收费信息;部分配置模板需参考原文,此处不展开完整代码。