SuperAPI AI 工具集

db-engine-selection

数据与分析

查看项目

更新于 10-15 22:11

技能介绍

用途:db-engine-selection(M0)在设计与 /claude-db:start 阶段运行,此时可能尚无 schema,只有对工作负载的描述,用于回答“这个项目该用哪种数据库”。它不是评分模块,不产生 findings,没有轴与严重级别,不进入 score.mjs 或两个评分。

主要能力:收集访问模式(按键点查、范围扫描、多实体连接、全文/语义搜索、时序分析、图遍历、扇出读写)、一致性与完整性需求(强一致/事务 vs 最终一致、多行不变量、数据库强制引用完整性)、规模与形态(数据量、写入速率、读写比、基数、是否仅追加/时序、向量负载)、可运维性与团队(托管 vs 自托管、serverless/边缘、既有经验、平台约束,交叉检查 db-platform-fit M21)。决策树摘要:事务型、多实体、重完整性默认关系型(Postgres 为安全默认,生态要求时用 MySQL/MariaDB);聚合导向、单一访问模式且嵌入优于连接时用文档型(Mongo/Firestore);已知键点查、缓存、会话、高吞吐简单操作用键值型(Redis/DynamoDB);海量写重、按查询建表、分区优先用宽列(Cassandra/Scylla);语义搜索/RAG 用向量(pgvector/Qdrant 等),通常与主存储并存;仅追加指标/事件与时间范围分析用时序(Timescale/ClickHouse/Influx);遍历深度与关系查询为核心时用图(Neo4j)。多语言存储是有效答案,需说明每个存储的职责;当一个引擎可信覆盖负载时,优先“Postgres + 扩展”(pgvector、JSONB、分区、FTS)而非新增第二引擎。

输出契约:由 /claude-db:start 渲染的结构化推荐对象,字段包括 recommended(paradigm、engine、platform?)、rationale(驱动决策的访问模式/一致性/规模事实及对应树分支)、runner_up(备选范式与引擎及放弃它的明确取舍)、assumptions(假设的工作负载事实,未知事实列在此处而非编造)、confidence(established | directional | speculative,仅描述输入至多 directional,关键事实缺失为 speculative)、caveats(锁定、可运维性、平台说明,具体价格/限制交由 M21 或厂商页面)。该对象为指引,不符合 schema/finding.schema.json,也不出现在 audit-report.schema.json 中。

限制与诚实性:不得编造基准、延迟、吞吐、价格或行数上限来支持选择;应基于有文档记录的属性(一致性模型、外键支持、索引类型、可运维性、锁定)比较,并将量级标为 high|medium|low;仅通过 WebFetch 引用厂商页面时须逐字引用。必须给出备选及取舍;工作负载描述不足时应说明并询问,或标记 confidence: speculative,不得凭空强行选择。M0 不产生评分、不设上限,本质为建议性;存在既有 schema 时,正确性判断交由评分模块(M1..M22)与审计器。