使用 Clerk 认证时，按 SDK…

当用户询问 Clerk 认证、CLI、各框架集成、组织、计费、Webhook、测试或原生 iOS/Android 时，先检测 SDK 版本，再把任务路由到对应的 Clerk 子技能。

适用场景

解决思路

1. 检查 `package.json` 以确定 Clerk SDK 版本，并用版本决定使用哪套模式。
2. 按包映射版本：`@clerk/nextjs` 的 v5–v6 是 Core 2，v7+ 是 Current；`@clerk/react` 或 `@clerk/clerk-react` 的 v5–v6 是 Core 2，v7+ 是 Current；`@clerk/expo` 或 `@clerk/clerk-expo` 的 v1–v2 是 Core 2，v3+ 是 Current；`@clerk/react-router` 的 v1–v2 是 Core 2，v3+ 是 Current；`@clerk/tanstack-react-start` 的 < v0.26.0 是 Core 2，v0.26.0+ 是 Current。
3. 如果版本不明确或项目是新建的，默认使用 Current。
4. 区分包名：Core 2 包使用 `@clerk/clerk-react` 和 `@clerk/clerk-expo`（带 `clerk-` 前缀）；Current 包使用 `@clerk/react` 和 `@clerk/expo`。
5. 所有技能都按 Current SDK 编写；遇到差异时查看 `> **Core 2 ONLY (skip if current SDK):**` 提示。
6. 例外：`clerk-custom-ui` 为自定义流程 hooks 提供独立的 `core-2/` 和 `core-3/` 目录，因为这些 API 在版本间完全不同。
7. 添加 Clerk 到项目 → 使用 `clerk-setup`：执行框架检测和 quickstart；设置环境、API keys、通过 `clerk init` 获取临时 dev keys；从其他 auth providers 迁移。
8. 从 CLI 操作 Clerk → 使用 `clerk-cli`：处理认证、链接、`doctor` 和环境拉取；管理用户、org、session、app 和 instance；模拟用户（`clerk impersonate`）和本地 Webhook 测试（`clerk webhooks listen`）；功能开关（`clerk enable orgs`、`clerk enable billing`）；通过 `clerk api` 调用 Backend、Platform 和 Frontend API；部署交接和部署状态验证。
9. 自定义登录/注册 UI → 使用 `clerk-custom-ui`：用 `useSignIn` / `useSignUp` hooks 实现自定义认证流程；处理外观和样式（主题、颜色、布局）；使用 `<Show>` 组件做条件渲染。
10. 高级 Next.js 模式 → 使用 `clerk-nextjs-patterns`：区分 Server 与 Client auth APIs；中间件策略；Server Actions、缓存；API route protection。
11. React 模式 → 使用 `clerk-react-patterns`：使用 hooks（`useAuth`、`useUser`、`useClerk`）；受保护路由、auth guards；Router 集成。
12. React Router 模式 → 使用 `clerk-react-router-patterns`：带认证的 loaders 与 actions；路由保护；SSR auth。
13. Vue 模式 → 使用 `clerk-vue-patterns`：composables（`useAuth`、`useUser`、`useClerk`）；Vue Router guards；Pinia auth store 集成。
14. Nuxt 模式 → 使用 `clerk-nuxt-patterns`：Server middleware auth；用 composables 做 SSR auth；Server API routes。
15. Astro 模式 → 使用 `clerk-astro-patterns`：SSR auth 页面；带 React 的 Island components；Middleware 与 API routes。
16. TanStack Start 模式 → 使用 `clerk-tanstack-patterns`：带认证的 Server functions；通过 loaders 做路由保护；Vinxi server 集成。
17. Expo / React Native auth → 使用 `clerk-expo`：预构建原生组件（AuthView、UserButton）；自定义流程：email、password、SMS/phone OTP、MFA；OAuth/SSO 和原生 Google/Apple sign-in；Expo Router 受保护路由、token 存储、推送通知。
18. Chrome Extension 模式 → 使用 `clerk-chrome-extension-patterns`：Background scripts auth；Popup auth flows；带 sync host 的 Content scripts。
19. B2B / Organizations → 使用 `clerk-orgs`：多租户应用；URL 中的 Organization slugs；Roles、permissions、RBAC；成员管理。
20. Billing 与 Subscriptions → 使用 `clerk-billing`：`<PricingTable />` 组件；用 `has()` 做 plan 和 feature gating；与 organizations 结合的 seat-based B2B billing；subscription lifecycle webhooks；free trials、invoicing。
21. Webhooks → 使用 `clerk-webhooks`：实时事件；数据同步；通知与集成。
22. E2E Testing → 使用 `clerk-testing`：Playwright/Cypress 设置；认证流程测试；测试工具。
23. Swift / native iOS auth → 使用 `clerk-swift`：原生 iOS Swift 和 SwiftUI 项目；ClerkKit 和 ClerkKitUI 实现指导；来自 `clerk-ios` 的 source-driven patterns。
24. Android / native mobile auth → 使用 `clerk-android`：原生 Android Kotlin 和 Jetpack Compose 项目；`clerk-android-api` 和 `clerk-android-ui` 实现指导；来自 `clerk-android` 的 source-driven patterns；不要用于 Expo 或 React Native 项目。
25. Backend REST API → 使用 `clerk-backend-api`：浏览 API tags 和 endpoints；检查 endpoint schemas；在 scope enforcement 下执行 API requests。
26. 如果已知任务，可直接访问 `/clerk-setup` - Framework setup。
27. 如果已知任务，可直接访问 `/clerk-cli` - CLI operations and Clerk resource management。
28. 如果已知任务，可直接访问 `/clerk-custom-ui` - Custom flows & appearance。
29. 如果已知任务，可直接访问 `/clerk-nextjs-patterns` - Next.js patterns。
30. 如果已知任务，可直接访问 `/clerk-react-patterns` - React patterns。
31. 如果已知任务，可直接访问 `/clerk-react-router-patterns` - React Router patterns。
32. 如果已知任务，可直接访问 `/clerk-vue-patterns` - Vue patterns。
33. 如果已知任务，可直接访问 `/clerk-nuxt-patterns` - Nuxt patterns。
34. 如果已知任务，可直接访问 `/clerk-astro-patterns` - Astro patterns。
35. 如果已知任务，可直接访问 `/clerk-tanstack-patterns` - TanStack Start patterns。
36. 如果已知任务，可直接访问 `/clerk-expo` - Expo / React Native。
37. 如果已知任务，可直接访问 `/clerk-chrome-extension-patterns` - Chrome Extension patterns。
38. 如果已知任务，可直接访问 `/clerk-orgs` - Organizations。
39. 如果已知任务，可直接访问 `/clerk-billing` - Billing & subscriptions。
40. 如果已知任务，可直接访问 `/clerk-webhooks` - Webhooks。
41. 如果已知任务，可直接访问 `/clerk-testing` - Testing。
42. 如果已知任务，可直接访问 `/clerk-swift` - Swift/native iOS。
43. 如果已知任务，可直接访问 `/clerk-android` - Native Android。
44. 如果已知任务，可直接访问 `/clerk-backend-api` - Backend REST API。
45. 如果不知道具体技能，描述需求并让路由推荐正确的技能。

适用边界 · 注意事项

• 未使用 Clerk 或未安装 Clerk SDK 的项目。
• 问题与 Clerk 无关，或需要通用认证设计/其他认证服务。
• 不要将 `clerk-android` 用于 Expo 或 React Native 项目；这些应使用 `clerk-expo`。