用途：把现有认证方案（NextAuth、Passport、Lucia、Clerk、自定义 JWT 或 session）分阶段迁移到 better-auth，适合切换认证库的项目。
主要能力：
- 审计现有认证库、认证方式、数据表结构、ORM 与种子文件。
- 选择目标特性：认证方式（邮箱密码、OAuth 提供商、magic link、passkeys、手机/OTP、匿名）；插件（2FA、组织/多租户、管理员角色、API Key、SSO/OIDC、JWT、HIBP 泄露检测）；会话（默认数据库存储或 Redis）。
- 按阶段规划：安装与脚手架（better-auth、schema、环境变量）、数据库表迁移、服务端配置 auth.ts、路由处理 auth.handler、客户端 authClient hooks、种子数据更新、清理旧库。
- 字段映射与数据迁移：重命名列，将 emailVerified 转为布尔值，补充 createdAt/updatedAt/accountId/providerId。
用法：先按 REFERENCE.md 做字段映射，再结合映射、配置与种子运行 /refactor-codebase。验证方式：
npx tsc --noEmit && npm test curl -X POST http://localhost:3000/api/auth/sign-in/email -H "Content-Type: application/json" -d '{"email":"test@example.com","password":"password"}'
安装参考技能：npx skills add better-auth/skills。
限制与护栏：各阶段验证通过前保留旧库；不要静默把 emailVerified 强转为布尔值；缺少 OAuth 环境变量需标记；没有认证测试时应补一个 Phase 0 冒烟测试。具体迁移细节以 REFERENCE.md 为准。