用途:在 Grey Haven 代码库中编写新代码、审查 PR、修复 lint/格式问题、按模板搭建新项目,或配置 Prettier、ESLint、Ruff 时套用统一的编码规范。
主要能力:提供 TypeScript/React(TanStack Start + React 19)与 Python/FastAPI(FastAPI + SQLModel)两套规范,并附 EXAMPLES.md 可复制示例、REFERENCE.md 完整配置与规则说明、templates/ 起始模板、checklists/ 代码审查清单。
关键约定:TypeScript 行宽 90、2 空格缩进、双引号、必需分号、始终尾逗号,允许 any 类型,路径别名 ~/ 指向 ./src/*;Python 行宽 130、4 空格缩进、所有函数必须有类型注解,Ruff 自动修复。变量函数分别用 camelCase 与 snake_case,类与组件用 PascalCase,常量用 UPPER_SNAKE_CASE,布尔字段加 is_/has_ 前缀。数据库列名一律 snake_case,属强制要求。每个表都需包含 tenant_id/tenantId 隔离字段并建索引,配合 RLS 与仓储模式按租户过滤。前端目录含 routes/、lib/components、server、config、hooks、utils、types;后端目录含 config、db/models、db/repositories、routers、services、schemas、utils。
使用方式:在涉及 Grey Haven 代码标准、lint 规则、格式或数据库架构的任务中启用;执行 Python 命令前须先运行 source .venv/bin/activate,提交前运行 pre-commit 钩子。
限制:规范源自 cvi-template 与 cvi-backend-template 生产模板,仅适用于 Grey Haven 项目;具体安装步骤、版本号与收费方式暂未提供。