SuperAPI AI 工具集

convex-deploy-guard

部署与运维

查看项目

更新于 10-16 03:06

技能介绍

用途:在每次影响 Convex 部署的操作前,先识别并公布目标部署,避免误操作到错误环境。

主要能力:读取 .env.local 中的 CONVEX_DEPLOYMENT、convex.json 以及 CONVEX_DEPLOY_KEY 是否设置,或调用官方 Convex MCP status 工具;将目标分类为 local-anonymous、dev、preview、prod。若两个来源冲突,需先解决再继续。执行前用一行公布目标,例如 target: dev (joyful-capybara-123, personal dev)。

生产保护:执行 npx convex deploy(解析为 prod 时)、npx convex run --prod、生产环境 env set、生产快照导入导出或启动可访问生产的 MCP 前,须说明将改动哪个部署的什么内容,并在本次会话获得明确同意;此前或针对其他目标的同意不适用。

MCP 默认:以非生产作用域启动官方 MCP,如 --deployment dev。两个生产标志风险不同,需分开:只读生产审计仅用 --cautiously-allow-production-pii;会启用可变生产工具的 --dangerously-enable-production-deployments 默认关闭,除非用户本次明确要求修改生产。

只读模式:用户声明只读后,本次会话内绝对禁止 deploy、env set/remove、通过 run 做变更及导入;启动 MCP 时使用 --disable-tools run,envSet,envRemove。

故障诊断:部署似乎没变化时,不要重复部署,而是重跑第一步,通常是部署到了与被观察环境不同的目标。无法确定目标时必须查明,不能猜测。建议将本守卫作为 ship、env、migrate、seed 等技能的第 0 步,其本身不是部署工具。