clerk-webhooks

feat(clerk-cli)：记录 impersonate、webhooks tunnel、功能开关和 FAPI CLI 附带了它自己的 skill 都不知道的命令。补齐这些缺口： - clerk impersonate / imp / imp revoke：使用 actor-token 模拟，并带有 cli: 审计标记；recipes 现在将模拟路由到这里，并将 /sign_in_tokens 重新定位为它实际所属的自定义 token 流程工具 - clerk webhooks token/listen/verify：第一方本地 webhook 隧道 （stripe-listen 风格）+ 离线 HMAC 验证；添加了完整流程 recipe - clerk enable/disable orgs|billing：命令表中的指针行， 深度内容保留在 clerk-orgs / clerk-billing（单一事实来源） - clerk api --fapi：心智模型中的第三个 API 表面 + 示例； 修正无参数行为（人类：交互式构建器，agent：usage 退出码 0） - agent-mode 参考：impersonate（JSON 输出，捕获 revoke id）和 webhooks listen（NDJSON，长时间运行）的矩阵行；表格重新对齐 - clerk-webhooks Testing 部分：优先教授 clerk webhooks listen（特别指出 Dashboard relay-URL 注册——不注册事件就不会流动），ngrok 降级为无 CLI 时的回退方案 - clerk router + clerk-cli 描述：新增触发分支（模拟、 本地 webhook 测试、功能开关） 通过 subagent 场景验证 RED->GREEN：没有这些编辑时，agent 会建议安装 ngrok，并使用原始 /sign_in_tokens 进行模拟； 有了这些编辑后，它会使用 clerk webhooks listen 和 clerk imp --print，确认 生产环境，并捕获 revoke handle。webhooks 部分的仅示例变体 经过微测试后被否决：agent 会模式匹配 stripe listen 的 自动订阅并跳过 Dashboard 注册，因此该步骤保持内联。 有意排除：switch-env（仅内部）、toggles/（注册器， 无逻辑）、deploy copy.ts（展示辅助）、隐藏的 deploy run。

refactor(webhooks)：现代化 handlers + 框架覆盖 - 将所有示例切换为各框架包中的 verifyWebhook；移除原始 svix 路径 - 更新 Core 3 中间件语法（async clerkMiddleware 配合 await auth.protect()） - 一致使用 CLERK_WEBHOOK_SIGNING_SECRET 环境变量 - 收紧事件目录以匹配 SDK 导出 - 在 references/frameworks.md 中添加 Astro、Fastify、Nuxt、React Router、TanStack Start 适配器 - 为 WebhookEvent 可辨识联合添加类型收窄模式 - 添加何时使用 webhooks 部分（最终一致性、同步与异步流程） - 添加隧道替代方案（ngrok、localtunnel、Cloudflare Tunnel） - 将 evals 从 expectations 迁移到 assertions schema；使 eval 3 与现代化 Express 路径保持一致

fix：最终审查润色 - W1：改写 clerk-setup 跨 skill 引用，避免反引号路径语法 - W3：为 9 个缺少 See Also 的 skill 添加该部分（orgs、webhooks、backend-api、 custom-ui、vue、astro、expo、chrome-extension、react-router） - W4：在 README Ask Your Agent 表中添加 Android 行 - N4：测试演示仓库 URL → 改为 main 分支，而不是固定 commit

fix：解决最终审查问题 - backend-api evals：修复不存在的脚手架（node-backend、nextjs-admin → nextjs-basic-auth） - clerk-setup：修复决策树中最后一个过时的 custom-ui/ 路径 - clerk-setup：澄清 nextjs-patterns 的交叉引用格式 - clerk-webhooks：middleware.ts → proxy.ts（Next.js 16+ 一致性） - chrome-extension：pnpm create plasmo → npx create-plasmo - README：在 Ask Your Agent 表中添加 Nuxt、Expo、Astro 示例

fix：处理审查阻塞项和警告 - Router skill 现在路由到所有 9 个框架 skill（之前只有 nextjs） - README 树与实际文件夹名称匹配（clerk- 前缀） - 从 README 中移除过时的 commands/ 部分 - 将 clerk-vue-patterns 范围限定为仅 Vue，移除 nuxt 重叠 - 修复 CLAUDE.md 贡献指南（文件夹保留 clerk- 前缀） - 从 nextjs-patterns 中移除过时的 .claude-plugin/plugin.json - 为 clerk 和 clerk-backend-api SKILL.md 添加 license: MIT - 在所有 skill 中统一 bun add → npm install - 清理 clerk-webhooks：移除 stop/read 部分，将提示合并到描述中

fix：根据 eval 改进更新 clerk-webhooks SKILL.md

chore：为重构后的 skill 提升版本

fix：使所有 18 个 skill 通过 skills-ref 验证 - 将 inputs/references 移到 metadata 下（非规范顶层字段） - 从 backend-api 中移除 argument-hint - 为带冒号的描述加引号（YAML 解析修复） - 重命名文件夹以匹配 skill 名称（规范要求 clerk- 前缀） - 为 6 个有额外要求的 skill 添加 compatibility 字段 - 更新 marketplace.json 和文档路径 所有 18 个 skill 现在都通过：npx skills-ref validate 属于 AIE-750 的一部分