SuperAPI AI 工具集

typescript-project

编程与开发

查看项目

更新于 10-16 02:35

技能介绍

用途:该技能为 TypeScript 和 JavaScript 仓库提供统一编程指南,覆盖工具链、代码规范与交付检查,适用于编写、审查或修改代码前参考。

主要能力:规定工具链默认命令,包括安装依赖 bun install、类型检查 bun run tsc --noEmit、检查并修复 bunx biome check --write <FILE_PATH>、仅格式化 bunx biome format --write <FILE_PATH>、测试 bun test。要求同时通过 Biome 与类型检查,禁止在已用 Biome 的仓库引入 ESLint + Prettier,禁止使用 npm、pnpm、yarn、npx、pnpx。深度修改前需阅读 references/biome.md 与 references/typescript-conventions.md。

编码规范:缺失用 undefined、空用 null,不手动制造 undefined(如 = undefined、return undefined、{ key: undefined }),缺失通过省略键表示。联合与交叉类型及函数签名优先用 type;可失败操作用可辨识联合建模;外部输入先收为 unknown 再收窄;用 satisfies 校验对象形状而不放宽;对可辨识联合做穷尽检查;用守卫子句保持浅缩进;抛出带上下文和 code 的类型化错误。反面模式包括默认用 any、用元组返回多字段结果、抛纯字符串、用布尔开关混合无关行为、手动制造 undefined。

交付检查:改动文件通过 Biome、tsc --noEmit 通过、仅用 bun/bunx 执行命令、缺失/空值语义正确、导出 API 有显式稳定类型、异步代码处理超时/取消/传输错误、为行为变更补充或更新测试。

限制:具体平台支持、收费与版本信息暂未提供。