用途:当用户要求应用 TypeScript 风格约定、按字母序整理类型、添加注释分隔线或询问相关规范时使用。
主要能力(约定,非硬性规则,有充分理由可不遵守):
- 字母序:函数参数按参数名、对象字面量字段按键名、类型定义字段、类属性按属性名排序。
- 工具:用 BiomeJS 做 JS/TS 的 lint 与格式化,查找 biome.jsonc 文件;若项目已用 ESLint 和 Prettier 则为例外。
- 日期时间:用 dayjs 计算,避免原生 Date 对象,示例:import dayjs from "dayjs"; const now = dayjs(); const tomorrow = now.add(1, "day");
- 禁止使用 any 类型。
- 避免嵌套三元运算符,改用 if/else 或提前返回。
- 不在 forEach 回调中返回值,改用块语句。
- 声明类型优先用 type 而非 interface。
- 注释分隔线:用于主要段落分隔,总宽 80 字符,标题大写居中,即 // ---- // 形式,如分隔 IMPORTS、TYPES 等区块;不用于每个函数或小分组。
使用方式:按上述规则编写或重构 TypeScript 代码,涉及配置时检查 biome.jsonc。
适用场景:TypeScript 项目的代码风格统一与审查。
限制:资料未提供安装命令、具体版本、收费或价格信息。