该技能是 DynamoDB 单表设计流水线的编排器。当用户希望端到端设计一张 DynamoDB 表,或不清楚该从哪一步开始时使用它。
流水线分三步:第一步梳理实体与访问模式,输出 access-patterns.md;第二步设计 PK/SK/GSI 并将访问模式映射为查询,输出 table-design.md;第三步生成方法签名与类型,输出 query-interfaces.md。三步分别对应技能 dynamodb-access-patterns、dynamodb-table-design、dynamodb-query-interfaces。
使用前会先检测流水线状态:搜索 /access-patterns.md、/table-design.md、**/query-interfaces.md,以及 docs/dynamodb/、docs/、项目根目录。根据结果决定路由:无文件则进入第一步;已有访问模式则带着文件路径进入第二步;已有访问模式与表设计则进入第三步;三个文件齐全则提示流水线完成,询问是否新增实体、修改或评审;仅有表设计则提示应补充访问模式,可选择回填或继续第三步。发现产物后会向用户列出缺失项并确认下一步。
路由规则:从零开始或需定义实体及查询方式,走访问模式技能;已有访问模式需设计键,走表设计技能;已有表设计需代码接口,走查询接口技能;向现有表新增实体,先为其实体走访问模式再继续流水线;仅想理解单表设计概念则直接说明。
核心概念:单表设计中所有实体类型共处一张表,通过共享分区键的条目集合预连接数据,一次 Query 即可取回,减少网络往返。适用于需要任意规模下 30ms 以内响应、访问模式明确且不常变更、单请求需取多种实体、OLTP 负载;不适用于访问模式快速演进、GraphQL 按类型解析器、需要灵活即席查询的场景。原则包括:访问模式优先;预连接为条目集合;一张表使用通用键名 pk/sk;用 GSI 支持替代访问模式(复用优先,最多 20 个);复合排序键编码层级;避免 Scan;多条目写入用事务。
最终产出三份文件作为实现阶段的规格说明。资料未提供具体安装命令、代码示例与收费信息。