clerk-claude-skill
为Astro/Next.js应用集成Clerk身份验证的Claude技能
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：clerk-claude-skill。 它的用途是：为Astro/Next.js应用集成Clerk身份验证的Claude技能 完整的 Skill 内容见：https://321skill.com/skills/clerk-claude-skill/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我正在用Astro开发一个需要用户登录的应用，想集成Clerk，帮我规划一下认证架构和中间件。”，它会基于此技能，为你提供Clerk在Astro SSR中的工作原理、路由保护模式以及如何编写角色访问控制中间件的具体指导。
对AI说：“我的Clerk E2E测试失败了，能帮我看看可能是什么问题吗？”，它会提醒你检查测试邮箱格式是否正确，必须包含“+clerk_test”，并引导你查看技能中的故障排查章节。
介绍
本技能旨在帮助开发者快速、规范地在Astro或Next.js应用中集成Clerk身份验证服务。它解决了手动配置Clerk时可能遇到的架构理解、测试困难、中间件编写和CI/CD集成等痛点。
使用方式非常简单，只需通过git clone命令将技能安装到本地Claude技能目录，即可在开发过程中获得关于Clerk集成的智能指导。技能提供了从架构解析到部署上线的完整知识支持。
该技能非常适合正在或计划使用Clerk进行用户认证的前端、全栈及智能体开发者，尤其适合那些希望提升认证模块开发效率和代码质量的团队。
使用建议：在开始集成Clerk前先通过此技能了解其与Astro SSR的配合方式；特别注意测试用户的邮箱必须包含“+clerk_test”后缀，这是自动化测试能正常工作的关键。
核心特点
该技能不仅提供代码片段，更包含了完整的端到端测试方案（使用Playwright和Clerk测试邮箱）以及CI/CD工作流配置，确保认证功能在开发、测试和部署各环节都可靠。它特别强调了与Astro SSR架构的集成模式，这是同类技能中较少深入涉及的。
注意事项
该技能主要针对Astro和Next.js框架，且深度绑定Clerk服务，不适用于其他身份验证提供商（如Auth0、Supabase Auth）或其他前端框架（如Vue、Svelte）。
常见问题
如何用这个技能测试Clerk认证？
技能指导使用Playwright进行E2E测试，并规定测试用户邮箱必须包含“+clerk_test”后缀（如user+clerk_test@example.com），Clerk会将其识别为测试邮箱。
这个技能支持哪些框架？
目前主要支持Astro（含SSR）和Next.js应用程序。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/clerk-claude-skill/raw/index.md 读取 clerk-claude-skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/clerk-claude-skill/raw/index.md（查看排版版本）