SuperAPI AI 工具集

write-persistence-representations

编程与开发

查看项目

更新于 10-15 20:13

技能介绍

用途:编写或更新把应用数据映射到所用存储技术的持久化表示,适用于 SQL 表映射、ORM 实体、schema DSL 文件、文档 schema、集合定义、记录类型等面向存储的定义。

主要能力与规则:先识别持久化技术与项目约定,查看邻近的 model、entity、schema、mapping、migration 文件,匹配文件位置、命名、装饰器、schema 构建器、关系声明、枚举、索引与时间戳字段的本地风格;框架语义不清或对版本敏感时查阅官方文档。优先更新既有表示模式,而非引入新抽象。只添加任务所需的存储结构,定义字段名、类型、可空性、标识符、关系、索引、约束、内嵌对象及表/集合名,保持表示层聚焦持久化,不混入服务行为或请求层塑形。

无默认值规则:表示定义不得声明默认值,包括数据库列默认值、ORM/schema 的 default 或 defaultValue、静默写入持久值的属性初始化器、回填业务值的 schema 钩子或模型回调,以及 status、计数器、布尔、枚举、数组、JSON、外键等的生成占位值。仅允许创建时间审计字段(如 createdAt、created_at、inserted_at 或项目等价命名)使用 now、CURRENT_TIMESTAMP 或框架等价机制;updatedAt、deletedAt、publishedAt、status、enabled、role、count、version、metadata 等业务字段不得设默认值。若框架把 createdAt 与其他自动字段捆绑在一个开关后,先查项目约定,若违反规则则显式建模字段。已有违规默认值不扩散,除非任务要求重构,否则保留现状。

使用方式与校验:按真实写入契约使用必填/可选标记,不因缺少默认值而把字段弱化为可选;若字段必须存在而表示层无法自动提供,要求应用写入路径提供。完成后核对字段名、关系接线、索引与可空性是否与邻近代码一致,确认省略默认值未掩盖写入流程中缺失的必填输入,在安全且范围内运行该技术栈的常规本地校验(类型检查、schema 校验、生成客户端检查),并说明应用代码需新提供的值。最后报告创建或更新了哪些表示、增改了哪些字段/关系/索引、是否使用创建时间审计默认值、以及应用代码是否需提供必填值。

限制:资料未提供具体支持的技术栈清单、安装命令、收费或平台信息。