用途:在任务涉及用户身份、登录或访问控制时主动加载,用于实现登录/注册、会话管理、OAuth 集成、受保护路由与 API、基于中间件的认证、RBAC、令牌刷新、密码重置等完整认证流程。它统一替代针对具体库的技能,适配项目自身技术栈。
主要能力:提供从发现、技术栈检测、实现规划、写配置与核心文件、安装依赖、安全验证、路由保护实现到测试的分步工作流;支持 Next.js(App Router 与 Pages Router)、Remix、Express/Fastify、tRPC、GraphQL 等框架模式;附带 references/decision-tree.md(托管、自托管与无服务器方案对比)和 scripts/auth-checklist.sh 自动化校验脚本。
使用方式:先运行 discover 查询现有认证与中间件模式,再用 detect_stack 检测框架,阅读 decision-tree.md 选择方案,随后按模式创建中间件、认证工具、认证 API 路由、受保护路由包装与客户端钩子;依赖安装示例包含 npm install jsonwebtoken bcryptjs、express-session connect-redis、@clerk/nextjs、next-auth、better-auth 等。验证阶段可运行 scan_for_secrets、env_audit,并执行 bash scripts/auth-checklist.sh .。
限制与注意:资料未提供收费、价格、平台支持范围、效果数据或具体使用步骤之外的保证;实现要求无占位符、完整校验与错误处理、使用 bcrypt/argon2 哈希密码、cookie 设为 httpOnly、secure、sameSite,并配置 CSRF、限流与文档化环境变量。故障排查涵盖会话不持久、JWT 重启失效、OAuth 回调不匹配和受保护路由不跳转等情形。