用途:给定一份PRD(产品需求文档)和可选的代码库,为每个实体生成结构化的数据模型审计,回答四个问题:应有哪些字段、它们该放在哪里、现在有什么、需要改什么。最终产物兼具规格说明(目标设计)和迁移指南(如何达到目标)两重作用。
主要能力:从PRD提取每个实体的显式或隐含字段;对每个字段依次执行“五问”(存在的依据、能否派生、持久化则放列还是配置还是关联实体、后端是否解释其值、存储形式与返回形式是否不同);填写规范的八列表格;按变更类型输出变更清单,包括重命名、新增字段(含默认值)、删除字段、存储位置迁移、API缺口;记录运行时计算字段的派生规则、数据来源与计算时机;以单行决策加理由的方式记录非显然的分类决定。
使用方式:先读取用户提供的PRD;若同时给出代码库文件(数据库模型、API类型、schema),一并读取,否则“当前状态”列标记为未知。先阅读references/field-classification.md再作分类决策,最终按references/output-template.md填写规范输出,不另造结构。字段归类可参考PRD自身分节但需重新梳理,避免混淆关注点。未知的当前状态值须显式保留,并区分已验证证据与设计建议。
适用场景:PRD大致确定后,聚焦字段存放位置与存储/迁移差异的审计工作。
限制与转交:若争议只是字段命名,转交hai-naming;若PRD本身有问题(范围错误、需求冲突、产品意图未定),转交hai-prd;若用户想要通用代码质量或组件设计评审,转交code-review-and-quality或hai-architecture。
其它:安装命令、具体依赖、收费与平台信息暂未提供。