用途：在 CI/CD 流水线中为使用 Clerk 认证的应用搭建自动化测试，覆盖 GitHub Actions 工作流、Playwright 端到端测试、测试用户管理与 Secrets 配置。
主要能力：提供 GitHub Actions 测试工作流模板，从 Secrets 注入 CLERK_PK_TEST、CLERK_SK_TEST、CLERK_WEBHOOK_SECRET_TEST 等环境变量，依次执行 npm ci、构建、单元测试与 Playwright E2E；给出 Playwright auth.setup.ts 登录脚本，自动填写 Clerk 登录表单并保存 storageState 供后续用例复用；提供带 setup 依赖项目的 playwright.config.ts 配置；示例 E2E 用例覆盖已登录访问仪表盘、未登录重定向到登录页以及受保护 API 返回数据；附带基于 @clerk/backend 的 seed-ci-user.ts 脚本按邮箱查询并创建测试用户；并给出 Vitest 中 mock @clerk/nextjs/server 的鉴权单元测试写法。另附常见错误的排查表。
必要用法：需启用 GitHub Actions 的仓库、Clerk 测试密钥（pk_test_ / sk_test_）以及已配置的 npm/pnpm 项目。在仓库 Settings > Secrets 添加上述密钥后再运行工作流；E2E 登录依赖 CLERK_TEST_USER_EMAIL 与 CLERK_TEST_USER_PASSWORD。
适用场景：为 Clerk 应用建立持续集成测试、验证登录与权限相关页面和接口、在 CI 中复用登录态以减少重复登录。
限制：资料未提供价格、平台支持范围、执行时间或性能数据。所有命令与代码需按原样使用；如遇测试用户登录失败需先运行种子脚本核对凭据，登录页超时需确认 NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY 已设置，认证态过期需删除 .auth/ 目录重跑 setup。