关于 clerk-auth
clerk-auth 是用于实现 Clerk 身份验证的技能，涵盖中间件、组织、Webhook 和用户同步。它面向开发身份验证、用户管理或多租户应用的开发者，并提供授权及安全处理 Webhook 的指导。
主要功能
- 01Clerk 身份验证模式
- 02中间件与组织配置指导
- 03Webhook 验证和事件处理
- 04用户同步安全措施
- 05路由与资源授权
适用场景
- 01添加登录和注册
- 02实现基于组织的访问控制
- 03通过 Webhook 同步用户
- 04保护服务端路由和操作
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/clerk-auth确认已加载。
附带文件references/detailed-guide.md
详细介绍
Clerk 身份验证
Clerk 身份验证实现、中间件、组织、Webhook 和用户同步的专家实践
详细指南
执行此技能前，请阅读详细指南。该指南保留了完整流程和参考资料。请将其中的安全要求、前提条件和验证要求视为强制要求。针对特定任务，请加载相关章节；若要端到端完成任务，请通读指南。
适用场景
- 用户提到或暗示：添加身份验证
- 用户提到或暗示：Clerk 身份验证
- 用户提到或暗示：用户身份验证
- 用户提到或暗示：登录
- 用户提到或暗示：注册
- 用户提到或暗示：用户管理
- 用户提到或暗示：多租户
- 用户提到或暗示：组织
- 用户提到或暗示：sso
- 用户提到或暗示：单点登录
限制
- 仅当任务明确符合上述范围时，才使用此技能。
- 不要将输出视为环境特定验证、测试或专家评审的替代品。
- 如果缺少必要的输入、权限、安全边界或成功标准，请停止并请求澄清。
指南中的代码片段彼此独立，是不同的替代方案或文件，并非一个可部署模块；实际项目中必须解决重复的默认导出，以及省略的 Prisma 模型和导入问题。请固定兼容的 Next.js/Clerk 版本，并检查当前使用的中间件/代理文件名。对每个服务端路由/操作进行身份验证，验证输入，并授权组织权限/个人资源；客户端界面和 org:admin 并不授予访问全局用户的权限。先验证 Webhook 原始字节，再使用以 Svix ID 为键的持久化事务事件收件箱，并制定领域事件排序/墓碑策略；仅靠 upsert 无法防止过时事件让已删除用户重新出现，或覆盖较新的状态。硬删除必须遵循应用的保留策略/外键策略。应选择实际的主要电子邮件地址，而非根据数组顺序选择，并允许仅有电话号码的身份。使用合成测试实例，绝不要记录签名密钥/原始私有负载。另请参阅 Clerk 同步指南 和 Svix 原始负载验证。
评论
支持 Markdown