SuperAPI AI 工具集

code-style

编程与开发

查看项目

更新于 10-15 23:49

技能介绍

用途:在 latitude-dev/latitude-llm 仓库中统一代码风格、TypeScript 用法与命名约定,涉及 Biome 格式化、导入风格、严格类型、React 文件名以及生成文件处理。若需了解领域代码位置,应参考 architecture-boundaries。

主要能力与规则:Biome 配置 biome.json 为唯一依据,缩进 2 空格、最大行宽 120、双引号、按需分号,忽略 dist/、coverage/、.turbo/、node_modules/、/*.gen.ts、/models.dev.json。优先使用包内格式化命令,如 pnpm --filter @app/api format。导入方面优先静态导入,类型导入用 import type,保持显式、可搜索、分组清晰,避免通配符导出与 barrel 文件,相对导入使用 .ts/.tsx 扩展名。TypeScript 基于 tsconfig.base.json,类型检查使用 tsgo -p tsconfig.json --noEmit,而非 tsc;启用 strict,模块为 NodeNext + ESM。领域数据契约优先以 Zod schema 定义,再推导类型;实体 schema 位于 src/entities/<entity>.ts,系统字段如 id、createdAt、updatedAt 视为核心字段;枚举式契约用字面量联合或 as const,不用 enum;避免 any,用 unknown 加收窄;多参数函数默认使用单个命名参数对象;不可变数据用 readonly。命名上类型用 PascalCase,变量函数用 camelCase,真正常量用 UPPER_SNAKE_CASE,否则 camelCase 加 as const;React 组件文件用 kebab-case,如 my-component.tsx,不用 PascalCase 文件名。生成文件如 apps/web/src/routeTree.gen.ts 由 TanStack Router 自动生成,不可手动编辑,变更时可提交但不得手改。

适用场景:在该仓库内进行代码编写、格式化、类型检查与命名审查时使用。限制:以上规则来自该仓库约定,其他项目未必适用;未提供收费、平台支持或效果数据。