convex-auth 是为现有 Convex 应用接入身份认证的 Skill。它处理认证组件、服务端配置、客户端状态和登录界面的连接,适合页面已经有了,却还没把登录流程真正接通的项目。
登录按钮能点,不代表后端认得当前用户。文档特别提醒检查 auth.config.ts:这个配置缺失或不正确时,应用可能一直表现为未登录,却没有明显提示。
它的工作会把服务端身份配置、部署环境变量、客户端 Provider 和路由保护一起检查。如果界面引用了尚未安装的 UI 组件,也要补齐,否则登录逻辑还没验证,构建就先失败了。
你应提供项目版本、现有登录实现和想使用的认证方式,让 AI 对照实际安装组件确认支持情况。原文给出的安装与密钥配置步骤也需要放回对应版本和部署环境中使用,不能只凭一段旧示例照搬。
完成标准是一轮真实的登录往返:用户完成认证后,应用确实读取到登录状态并进入相应页面。这个 Skill 把验收落在使用结果上,而不只是交付一个看起来完整的登录框。