用途:读取 DynamoDB 表设计 .md 文件,生成完整的数据访问层接口骨架,输出为 markdown 伪代码文件,便于在实现前查看全部仓储接口。属于设计流水线的第 3 步:访问模式 → 表设计 → 查询接口。
主要能力:为每个实体生成实体模型(包含 pk、sk、适用的 GSI 属性与领域属性,可选字段显式标记);为每个唯一键模式生成键构建函数,begins_with 访问模式生成前缀构建器;为每个实体生成仓储接口,每个方法对应表设计中的一个访问模式,并注明 AP 编号、DynamoDB 操作、键构造与条件;为多条目写操作生成事务辅助类型;生成覆盖矩阵确保每个 AP 均被覆盖。多实体读取模式返回按 SK 前缀分组的结构化对象。
使用方式:先读取表设计文件,若不存在或不完整则提示先运行 dynamodb-table-design;读取 reference/language-conventions.md 确定目标语言,并询问用户实现语言,无偏好则用通用伪代码;按步骤生成实体模型、键构建器、仓储接口、事务类型,并验证覆盖率;结果写入 markdown 文件,建议路径 docs/dynamodb/query-interfaces.md 或与其它文件同目录。
适用场景:已有表设计、需要生成数据访问层骨架、需要类型安全的方法签名或希望在实现前查看完整接口时。
限制:必须先有表设计文件;分页始终基于游标,不暴露页码或偏移量;多实体查询需在应用代码中按 SK 前缀过滤;具体语言语法需用户指定,否则为通用伪代码;暂未提供收费、价格或平台等信息。