用途:该技能用于请求实现、更新或调试基于 robelest/convex-auth 的认证时使用,可复制到其他仓库。核心要求是任何认证改动前必须核对上游:优先运行 bash .cursor/skills/robel-auth/scripts/check-upstream.sh;脚本不可用时手动查阅官方文档、main 与 release 分支 README、分支差异,以及涉及门户或静态托管时的自托管文档。main 与 release 冲突时以用户指定分支为准,未指定则用 release 并说明理由。
主要能力:覆盖安装与依赖策略(尝试 npm view @robelest/convex-auth version,不可用时 npm install github:robelest/convex-auth#release,可用 commit SHA 固定)、CLI 向导安装、核心接线三文件(convex.config.ts 注册组件、auth.ts 用 createAuth 配置 provider、http.ts 通过 auth.http.add 注册回调与 JWKS)、多 provider(GitHub、Google、Apple、Microsoft、password、email、passkey、totp、anonymous、phone、sso、custom)、会话/JWT/限流/回调配置、auth.user 与 member/invite 等授权 API、群组 SSO(OIDC、SAML 2.0、SCIM 2.0)及自托管集成。
用法要点:先询问源分支、是否新集成、框架、是否自托管、是否接受 Git commit 固定;不要假设 npm 包可用,需在执行时验证;以已安装版本实际导出为准,0.0.4-preview.30 起 provider 为小写工厂函数,password() 而非 new Password(),客户端 client({ convex, api: api.auth })。注意 main 与文档站可能超前于 npm 预览版。
限制:不假设功能、价格或平台;缺失事实需明确说明。完成时需报告上游文档检索时间、所用分支及理由、安装路径、改动文件与后续命令。