用途:读取访问模式文档,输出 DynamoDB 单表设计。位于流水线第 2 步:访问模式 → 表设计(本技能)→ 查询接口。
主要能力:将实体分组为条目集合(item collections),设计 PK/SK(如 USER#<id>、ORDER#<timestamp>),识别并设计 GSI,映射每个访问模式到具体操作,并做校验。
使用方式:先读访问模式文件,若不存在或不完整,需先运行 dynamodb-access-patterns 技能;已有生产表时可读取现有表设计。按六步流程:读取校验访问模式、分组实体、设计主键、识别 GSI(最多 20 个,可选 ALL/KEYS_ONLY/INCLUDE 投影,支持稀疏索引与 GSI1/GSI2 重载)、逐一映射访问模式(Query、GetItem、BatchGetItem、PutItem、TransactWriteItems、UpdateItem、DeleteItem,含 PK/SK 条件、参数、条件表达式)、按 reference/validation-checklist.md 校验。输出为 markdown 文件,建议 docs/dynamodb/table-design.md,可参考 reference/output-template.md 与 reference/design-patterns.md。
限制:必须先有文档化访问模式,不能跳过;优先基表而非 GSI;排序字段须编码进 SK,数字需零填充;需与用户交互确认分组与键设计;需留意热分区与写放大;保持语言无关,使用 DynamoDB 操作名而非 SDK 函数名。
后续:设计完成后,用 dynamodb-query-interfaces 技能生成查询接口。