用途:编排一次完整的数据库审计,流程分三阶段——检测、派发、综合。
检测:解析目标(项目目录或自然语言描述),运行 stack-detect(封装 scripts/detect-stack.mjs),得到 stacks 数组,含 paradigm、engine、orm、platform、source_of_truth、confidence。结果为空则转向 /claude-db:start 向导或描述模式,绝不猜测引擎。若用户启用 Tier-1,则运行只读 introspect,否则相关检查返回 needs_api。
派发:对每个技术栈并行启动只读审计子代理(在单条消息中发起多个 Task 调用),传入 source_of_truth、范式、引擎/平台及分配模块。子代理包括 schema-integrity-auditor(M1–M10)、performance-scale-auditor(M11–M18)、nosql-paradigm-auditor(M19,仅文档/键值/宽列)、specialized-platform-auditor(M20、M21、M0)、migration-safety-auditor(M22,存在迁移目录时)。子代理只读,仅用 Read、Grep、Glob、Bash、WebFetch,审计不会改动文件。
综合:合并发现并按 id 去重(保留最严重状态:fail > warn > needs_api > pass > not_applicable)。按范式评分:node scripts/score.mjs --findings <merged.json> --paradigm <paradigm>。多存储时逐栈评分,再按轴取最差并指出拖底存储。报告含两项评分及解读、按轴分类表、置信度行(层级与 needs_api 总数,不得把 needs_api 当作通过)、按严重度×影响÷成本排序的行动项(含证据、复现、建议、可修复性、预期影响),页脚提示运行 /claude-db:fix 应用安全可逆迁移并逐项确认。另附通俗语言摘要,解释两项评分含义、优先修复项及 needs_api 含义。
限制:默认只读;需要实时数据库时标为 needs_api;不得编造统计、延迟、吞吐、行数或价格;推测性发现不参与评分上限;用用户语言(EN/ES)回复。