需要接入、修复、审计或配置 Auth0…

当应用需要 Auth0 登录/登出、会话/token、MFA、SSO、Organizations、RBAC、自定义域名、Universal Portals、品牌、审计、迁移或 Vercel 集成时，用本流程定位意图、框架和工具链，再加载正确参考文件。

适用场景

解决思路

1. 按顺序执行：检测意图 → 检测框架 → 检测工具链 → 加载 2–3 个参考文件；按 Step 4 匹配意图标题读取引用文件。
2. 意图检测：把请求与「开发者想要什么」列匹配，用平实语言而非仅 Auth0 术语；选取 Intent 作为 Step 4 的查找键，并在 Step 4 匹配同名标题（如 ### feature:mfa）确定要读的参考文件。
3. 意图映射：添加登录/注册/sign-in/让用户创建账户，或在应用/脚本中添加并使用 Auth0 SDK -> integrate。
4. 意图映射：密码后要求第二步（一次性验证码、SMS/email code、authenticator app、passkey、指纹/人脸、security key），或在敏感操作前重新确认身份；Auth0 术语 MFA/2FA/two-step/step-up -> feature:mfa。
5. 意图映射：让不同公司/团队/工作区/租户各自拥有用户、成员、角色和登录，通常是卖给企业的产品；Auth0 Organizations/multi-org/B2B SaaS -> feature:organizations。
6. 意图映射：部署托管自助门户用于 profile、passkeys、MFA 或组织详情，而不是自建 My Account / My Organization UI；Auth0 Universal Portals -> feature:universal-portals。
7. 意图映射：用自有 web 地址（如 login.example.com、auth.company.com）提供登录页，而不是默认 Auth0 URL；Auth0 custom domain -> feature:custom-domains。
8. 意图映射：用自有代码或框架构建完全自定义登录/注册屏幕，超出主题设置能力；Auth0 ACUL -> feature:acul。
9. 意图映射：更改登录页外观——logo、颜色、字体、背景、整体主题；Auth0 branding/Universal Login customization -> feature:branding。
10. 意图映射：把 token 绑定到客户端，使被盗/泄露 token 不能从另一台机器重用/重放；Auth0 DPoP/sender-constrained tokens -> feature:dpop。
11. 意图映射：审计租户的安全/配置问题，报告，然后可选修复发现；Auth0 tenant audit/CheckMate -> audit。
12. 意图映射：检查租户是否健康并处于正确套餐——两个分数 + 推荐；Auth0 health check -> healthcheck。
13. 意图映射：询问最佳实践、是否安全、如何安全处理 token、应该如何做 X；Auth0 guidance/security -> guidance。
14. 意图映射：遇到错误 401 Unauthorized、403 Forbidden、CORS、callback URL mismatch、redirect loop；Auth0 debugging -> debug。
15. 意图映射：遇到限流 429 Too Many Requests、quota exceeded；Auth0 rate limits -> debug:rate-limit。
16. 意图映射：把现有应用从 Clerk、NextAuth.js、Firebase、Cognito、Okta、Supabase、Passport.js 或其他认证提供商迁移；Auth0 provider migration -> migrate。
17. 意图映射：升级 Auth0 SDK 本身到新主版本（如 Auth0.swift v2→v3、Auth0.Android v3→v4）——破坏性变更、废弃 API、更新到最新 SDK；Auth0 SDK major-version upgrade -> upgrade-sdk。
18. 意图映射：安装 Auth0 的 Vercel Marketplace 集成、连接 Auth0 到 Vercel 项目，或同步 Auth0 配置到 Vercel 托管的 Next.js 应用；Auth0 Vercel native integration -> integrate。
19. 意图映射：直接使用 Auth0 CLI——用 auth0 CLI 创建 app/API、脚本化租户设置，或在 CI 中自动化 Auth0 配置——且没有应用框架参与；Auth0 CLI/tooling-only -> tooling。
20. 如果没有任何明确匹配：选择最接近的目标；如果目标确实不清楚，询问开发者想完成什么，不要猜意图。
21. 框架检测跳过规则：对 tooling intent 跳过 Step 2——CLI-first 请求没有框架；转到 Step 3 加载 tooling reference；仅在开发者后来转向把认证集成到应用时再询问框架。
22. 框架检测顺序：从上到下；停在第一个产出框架的 tier。
23. Tier 1 总体：检查已安装 Auth0 SDK（最强信号）。
24. Node.js/JS/TS Tier 1：检查 package.json → dependencies；按最具体优先，Ionic/Capacitor 项目也带基础 SDK，所以先检查 @capacitor/browser 行。映射：@capacitor/browser + @auth0/auth0-angular -> ionic-angular；@capacitor/browser + @auth0/auth0-react -> ionic-react；@capacitor/browser + @auth0/auth0-vue -> ionic-vue；@auth0/nextjs-auth0 -> nextjs；@auth0/auth0-nuxt -> nuxt；@auth0/auth0-react -> react；@auth0/auth0-vue -> vue；@auth0/auth0-angular -> angular；@auth0/auth0-spa-js -> spa-js；express-openid-connect -> express；@auth0/auth0-fastify -> fastify；@auth0/auth0-fastify-api -> fastify-api；express-oauth2-jwt-bearer -> express-jwt；react-native-auth0 + app.json 或 app.config.js 存在 -> expo；react-native-auth0（无 Expo 文件）-> react-native；@auth0/auth0-api-js -> auth0-api-js；@auth0/auth0-server-js -> auth0-server-js；@auth0/auth0-auth-js -> auth0-auth-js；auth0（裸包，不是 @auth0/*）-> node-auth0。
25. Python Tier 1：检查 requirements.txt 或 pyproject.toml；按最具体优先，auth0-server-python 是框架无关服务器核心，所以先检查共同安装的 web 框架，再退回裸 SDK 行。映射：auth0-server-python + flask -> flask；auth0-server-python（无 Flask web framework）-> server-python；auth0-fastapi-api -> fastapi-api。
26. Java/Kotlin Tier 1：检查 build.gradle 或 pom.xml。映射：mvc-auth-commons (com.auth0:mvc-auth-commons) -> java-mvc；spring-security-oauth2-resource-server -> springboot-api。
27. .NET Tier 1：检查 *.csproj 或 NuGet.Config。映射：Auth0.AspNetCore.Authentication（无 .Api 后缀）-> aspnetcore-auth；Auth0.AspNetCore.Authentication.Api -> aspnetcore-api；Auth0.OidcClient.MAUI -> maui；Auth0.OidcClient.AndroidX -> net-android；Auth0.OidcClient.iOS -> net-ios；Auth0.OidcClient.WinForms -> winforms；Auth0.OidcClient.WPF -> wpf。
28. PHP Tier 1：检查 composer.json；auth0/auth0-php 通过 SdkConfiguration 的 strategy 同时支持 PHP web apps 和 APIs；STRATEGY_API 行更具体，先检查。映射：auth0/auth0-php + SdkConfiguration::STRATEGY_API（或 strategy: 'api'）-> php-api；auth0/auth0-php（无 STRATEGY_API / STRATEGY_REGULAR 或 strategy: 'webapp'）-> php；auth0/login（laravel，无 AuthorizationGuard）-> laravel；auth0/login + AuthorizationGuard -> laravel-api。若已安装 auth0/auth0-php 但尚未设置 SdkConfiguration strategy（新项目），转到下方 variant disambiguation。
29. Go Tier 1：检查 go.mod。映射：github.com/auth0/go-jwt-middleware -> go。
30. Mobile Tier 1：build.gradle(.kts) + com.auth0.kmp:auth0 (KMP module) -> kmp；Package.swift 或 .xcodeproj + Auth0.swift -> swift；build.gradle + com.auth0.android:auth0 -> android；pubspec.yaml + auth0_flutter + developer names/targets Windows desktop -> flutter-windows；pubspec.yaml + auth0_flutter + flutter.web: false -> flutter-native；pubspec.yaml + auth0_flutter + web enabled -> flutter-web。
31. Tier 2 总体：如果无 Auth0 SDK 匹配，则从非 Auth0 工作区依赖检测框架；停在第一个匹配；这确定基础框架；web-vs-API variant 在 Variant disambiguation 中解决；同 Tier 1，先检查 @ionic/* 行再检查基础框架。
32. Tier 2 映射：next in package.json -> nextjs；nuxt in package.json -> nuxt；@ionic/* + @angular/core -> ionic-angular；@ionic/* + react -> ionic-react；@ionic/* + vue -> ionic-vue；@angular/core in package.json -> angular；vue in package.json（无 nuxt）-> vue；expo in package.json -> expo；react-native（无 expo）-> react-native；react（无上面的 meta-framework）-> react (SPA) — see note；express in package.json -> express（variant below）；fastify in package.json -> fastify（variant below）；flask in requirements.txt/pyproject.toml -> flask；fastapi in requirements.txt/pyproject.toml -> fastapi-api（variant below）；spring-boot in pom.xml/build.gradle -> springboot-api；laravel/framework in composer.json -> laravel（variant below）；composer.json present（无 Laravel）-> php（variant below）；go.mod present + HTTP server/router -> go；org.jetbrains.kotlin.multiplatform plugin + commonMain source set（共享 Android+iOS module）-> kmp；Package.swift 或 .xcodeproj -> swift；pubspec.yaml (Flutter) + developer names/targets Windows desktop -> flutter-windows；pubspec.yaml (Flutter, web disabled) -> flutter-native；pubspec.yaml (Flutter, web enabled) -> flutter-web；*.csproj referencing MAUI -> maui；*.csproj (WinForms) -> winforms；*.csproj (WPF) -> wpf；*.csproj ASP.NET (web app or API) -> aspnetcore（variant below）。
33. React note：普通 React 项目映射到 react 用于使用 React SDK 的 SPA，或 spa-js 如果应用是框架无关 vanilla JS；如果不清楚，先询问再加载。
34. Tier 3 总体：如果无工作区信号匹配，则映射请求中提到的框架或语言；停在第一个匹配。
35. Tier 3 映射：Next.js / next -> nextjs；Nuxt -> nuxt；Angular（非 Ionic）-> angular；Vue（非 Nuxt/Ionic）-> vue；React SPA（非 Next.js）-> react；vanilla JS / plain JS / 无框架 SPA -> spa-js；node-auth0 / auth0 npm package -> node-auth0；@auth0/auth0-api-js / auth0-api-js / low-level resource-server SDK -> auth0-api-js；@auth0/auth0-server-js / auth0-server-js / server-side Auth0 session SDK -> auth0-server-js；@auth0/auth0-auth-js / auth0-auth-js / AuthClient / low-level OAuth OIDC -> auth0-auth-js；Express (web app / server-rendered) -> express；Express API / protect API routes -> express-jwt；Fastify (web) / Fastify API -> fastify / fastify-api；Flask -> flask；FastAPI (web app) / FastAPI API -> server-python / fastapi-api；auth0-server-python / framework-agnostic Python server SDK / Python OIDC web server with no dedicated reference (Django、Starlette、Sanic、Quart、aiohttp) -> server-python；Spring Boot -> springboot-api；Java MVC / servlet -> java-mvc；ASP.NET Core web app / API -> aspnetcore-auth / aspnetcore-api；MAUI / WinForms / WPF -> maui / winforms / wpf；PHP web app / PHP API -> php / php-api；Laravel web app / Laravel API -> laravel / laravel-api；Go / Golang API -> go；Kotlin Multiplatform / KMP / shared Android+iOS auth code / com.auth0.kmp -> kmp；Swift / iOS -> swift；Android / Kotlin -> android；Flutter (native / web / Windows) -> flutter-native / flutter-web / flutter-windows；React Native / Expo -> react-native / expo；Ionic (Angular/React/Vue) -> ionic-angular / ionic-react / ionic-vue。
36. Variant disambiguation 总体：有些框架有独立 web-app 和 API 参考；当 Tier 1 未 pin variant 时，按 intent-first 选择。
37. Variant 表：express -> web-app express，API express-jwt，选择 API 当保护 API 路由 / 验证 JWTs，无 server-rendered UI；fastify -> fastify，fastify-api，resource server / JWT validation only；fastapi -> server-python，fastapi-api，resource server / JWT validation only；带 login/logout UI 的 web app 用 server-python；php -> php，php-api，构建/保护 PHP API，无 web UI；laravel -> laravel，laravel-api，API-only (token guard)，无 Blade UI；aspnetcore -> aspnetcore-auth，aspnetcore-api，Web API / JWT bearer，无 cookie login UI。
38. 如果 variant 意图仍模糊（同时有 UI 和受保护端点，或不清楚），说明检测到的内容并询问开发者 web app vs API，再加载。
39. 如果框架无匹配：询问开发者使用的框架/语言。不要猜。
40. 冲突处理：如果 Tier 2（workspace）和 Tier 3（prompt）实质性不一致（例如 prompt 说 Next.js 但 package.json 无 next），说明冲突并询问，而不是静默选择；当两者都存在且一致时，工作区信号优先于 prompt。
41. Step 3 工具链检测：读取项目文件树和请求——这是项目上下文决策，不是产品偏好。
42. 工具链映射：项目有 terraform/ 目录或任意 *.tf 文件 -> 加载 tooling-terraform/index.md；当前 agent session 中 Auth0 MCP server 活跃 -> 加载 tooling-mcp/index.md；请求 Auth0 Vercel Marketplace/native integration，或连接 Auth0 到 Vercel 项目 -> 加载 tooling-vercel/index.md；其他情况（默认）-> 加载 tooling-cli/index.md。
43. Step 4 总体：找到标题匹配 Step 1 所选 Intent 的段落，然后读取其列出的参考文件。
44. integrate 加载：Read references/framework-{framework}/index.md；Read references/tooling-{tooling}/index.md；遵循 references/framework-{framework}/index.md 中的集成工作流；使用 references/tooling-{tooling}/index.md 执行所有 Auth0 租户配置步骤。
45. feature:mfa 加载：Read references/feature-mfa/index.md；Read references/tooling-{tooling}/index.md。
46. feature:organizations 加载：Read references/feature-organizations/index.md；Read references/tooling-{tooling}/index.md；如果检测到框架：Read references/framework-{framework}/index.md；如果多租户架构 / B2B SaaS 设计问题：还 Read references/pattern-multi-tenant/index.md。
47. feature:universal-portals 加载：Read references/feature-universal-portals/index.md；Read references/tooling-{tooling}/index.md。
48. feature:custom-domains 加载：Read references/feature-custom-domains/index.md；Read references/tooling-{tooling}/index.md。
49. feature:acul 加载：Read references/feature-acul/index.md；Read references/tooling-{tooling}/index.md。
50. feature:branding 加载：Read references/feature-branding/index.md；Read references/tooling-{tooling}/index.md。
51. feature:dpop 加载：Read references/feature-dpop/index.md；Read references/tooling-{tooling}/index.md；如果检测到 SPA 框架（vue/react/angular/spa-js）：Read references/framework-{framework}/index.md；DPoP 是 SPA-only（无 SSR：Next.js/Nuxt）——feature-dpop/index.md 说明该排除项。
52. guidance 加载：Read references/pattern-security/index.md；如果检测到框架：Read references/framework-{framework}/index.md（用于 SDK 特定指导——token 存储、session 处理、路由保护）；如果 token 处理 / JWT vs opaque / 存储：Read references/pattern-token-handling/index.md；如果多租户 / B2B 架构：Read references/pattern-multi-tenant/index.md + references/feature-organizations/index.md。
53. debug 加载：Read references/pattern-common-errors/index.md；如果检测到框架：Read references/framework-{framework}/index.md。
54. debug:rate-limit 加载：Read references/pattern-rate-limiting/index.md。
55. migrate 加载：Read references/feature-migration/index.md；Read references/tooling-{tooling}/index.md；如果检测到框架：Read references/framework-{framework}/index.md。
56. audit 加载：Read references/feature-audit/index.md；Read references/feature-audit-pricing/index.md；Read references/feature-audit-remediation/index.md；Read references/tooling-{tooling}/index.md；仅在每条命令确认后应用发现；通过重新 fetch 验证每个更改。
57. healthcheck 加载：Read references/feature-healthcheck/index.md；Read references/feature-audit/index.md；Read references/feature-audit-pricing/index.md；Read references/feature-audit-remediation/index.md；Read references/tooling-{tooling}/index.md；如果可以运行扫描，先执行 audit workflow，然后评分并推荐套餐；如果不能，评分 capability fit 并仍然推荐；绝不要引用 Enterprise pricing。
58. upgrade-sdk 加载：Read references/framework-{framework}/index.md；遵循其 「Major Version Migration」 章节（例如 Auth0.swift v3、Auth0.Android v4）；这是 Auth0 SDK 版本升级——不是 provider migration；不要加载 feature-migration/index.md；如果未检测到框架：询问开发者要升级哪个 Auth0 SDK。
59. tooling 加载：Read references/tooling-{tooling}/index.md；没有 framework 文件——这是 CLI/tooling-only 任务（创建 apps/APIs、脚本化租户设置、在 CI 中自动化配置）；如果开发者随后要把 auth 集成到应用，回到 Step 1 并使用 integrate intent。
60. 安装/可用性：metadata 要求 bins: auth0；OS: darwin/linux；可通过 brew 安装 formula auth0，bins [auth0]，label Install Auth0 CLI (brew)。

适用边界 · 注意事项

• 不适用于非 Auth0 项目，或没有 Auth0 租户/CLI/工具的认证集成；应使用其他认证方案或先配置 Auth0。
• 纯 tooling/CLI 意图不要检测框架；若没有应用框架，不要强行加载 framework reference。
• DPoP 仅 SPA，不适用于 SSR（Next.js/Nuxt）；意图、框架或信号冲突且不清楚时不要猜测，先询问。