用途:在改动一个 Convex 应用前先弄清它是什么。逐行阅读十几个函数文件既慢又易错,本能力通过读取不会说谎的两个来源——schema(数据模型)与函数导出面(functionSpec/导出的 query、mutation、action)——快速且准确地生成架构地图。它是纯描述性的:说明现状,把判断交给审计能力,把修改交给修复能力,也常作为优化或自愈会话的第一步。
主要能力:检测应用(convex/ 目录、schema.ts、是否已有部署;有部署时通过官方 MCP 获取 functionSpec/表作为权威实时接口面,否则直接读源码)。从 schema.ts 列出每张表及其字段,重点是关系:哪些 v.id("other") 指向何处、存在哪些索引(索引反映预期访问路径),用文字画出外键图。枚举每个导出函数,区分 PUBLIC(query/mutation/action,即攻击面/API 面)与 INTERNAL(internalQuery 等,客户端不可达),各给一行“做什么+触及什么”。说明身份如何建立(auth.config.ts 提供方?以 tokenIdentifier 为键的 users 表?)与归属如何强制(是否有 requireOwner 式检查、哪个字段是所有者);若没有认证基础要明说。列出 convex.config.ts 中安装的 @convex-dev/* 组件及其作用、http.ts 路由、cron,以及 action 中的外部调用(哪些 API、哪些环境变量)。追踪 1–2 条代表性端到端路径,例如 createTask 校验后按调用者写入 tasks,再由 listMyTasks 通过 by_owner 索引读回。
使用方式:以可扫描的地图呈现——数据模型→公开/内部函数→认证模型→组件与边界→一两条流程;结尾指向下一步动作(审计用 reviewer/authz,评分用 launch-readiness,扩展用 design/expert)。
限制与规则:只读,任何部署内省均为只读,不修改应用;以 schema 与函数面为准,绝不描述代码未体现的行为,模糊处如实说明而非猜测;只描述认证模型、不审计漏洞(那是 convex-authz 的职责)。未提供的具体命令、安装方式与价格信息暂未提供。