workos-authkit-base

WorkOS AuthKit 集成

步骤 1：获取 AuthKit 文档（阻塞）

停止。完成前请勿继续。

WebFetch：https://workos.com/docs/user-management/authkit

此页面是了解 AuthKit 概念、支持的框架和设置要求的权威来源。如果此技能与文档冲突，请以文档为准。

步骤 2：检测用户使用的框架

运行以下命令来识别项目的框架。按顺序逐项检查；使用第一个匹配项。

# Next.js
grep -q '"next"' package.json 2>/dev/null && echo "DETECTED: nextjs"

# React Router / Remix
grep -qE '"react-router"|"@remix-run"' package.json 2>/dev/null && echo "DETECTED: react-router"

# TanStack Start
grep -q '"@tanstack/start"' package.json 2>/dev/null && echo "DETECTED: tanstack-start"

# React (standalone SPA — check AFTER framework-specific entries)
grep -q '"react"' package.json 2>/dev/null && echo "DETECTED: react"

如果均未匹配，请检查是否为纯 HTML/JS 项目：

# Vanilla JS — no package.json or no framework dependency
[ ! -f package.json ] && echo "DETECTED: vanilla-js"
ls index.html 2>/dev/null && echo "DETECTED: vanilla-js"

步骤 3：转到框架专用技能

使用步骤 2 的检测结果来选择正确的技能。如果已匹配框架，请勿继续执行后续步骤——立即切换到匹配的技能。

Detection result         -->  Skill to invoke
─────────────────────────────────────────────
nextjs                   -->  workos-authkit-nextjs
react-router             -->  workos-authkit-react-router
tanstack-start           -->  workos-authkit-tanstack-start
react                    -->  workos-authkit-react
vanilla-js               -->  workos-authkit-vanilla-js

**如果检测到框架：**在此处停止。框架专用技能会负责从安装到验证的所有事项。

**如果未检测到框架：**询问用户：“你使用的是哪个框架？（Next.js、React、React Router、TanStack Start 或 vanilla JS）”。如果用户提到列表中没有的框架（例如 Astro、Remix、SvelteKit），请使用 workos-authkit-vanilla-js 作为最接近的起点，并使用 WebFetch https://workos.com/docs/user-management/authkit 获取框架专用指南。

相关技能

• workos-authkit-nextjs — Next.js App Router（13+），服务器端渲染
• workos-authkit-react — 使用客户端 AuthKit 的 React SPA
• workos-authkit-react-router — React Router / Remix 集成
• workos-authkit-tanstack-start — TanStack Start 框架
• workos-authkit-vanilla-js — 不使用框架的纯 HTML/JS