Skill 安装
多 Agent 安装npx skills add https://github.com/clerk/skills --skill clerk-setup
使用 npx skills 快速安装,支持将 Skill 添加到多个兼容的 AI Agent。
Skill 调研报告
clerk/skills#clerk-setup
Skill 更新日志
版本列表
无版本号
分离现有的 Clerk 回退逻辑并明确 Step 1a 标题
Co-Authored-By: Claude Opus 5.5
无版本号
保护现有 Clerk 设置并明确检查器范围
无版本号
更新 skills/core/clerk-setup/SKILL.md
Co-authored-by: Michael Novotny
无版本号
在 intro init 示例中跳过隐式技能安装
Co-Authored-By: Claude Opus 5.5
无版本号
对提示命令进行分词并跳过隐式技能安装
无版本号
整合 CI 检查并提高 clerk-setup 的准确性
将检查器移入 scripts/,置于根 package.json 之后,用 Test 和 Check 工作流替换
逐项检查工作流和复合操作,
并使用 concurrently 运行所有检查。
修正 clerk-setup 中关于脚手架和引导支持的声明,按平台对
auth-controls 步骤进行门控,将 Core 2 检测移到设置之前,并
全程使用 Markdown 链接。在不变式检查器中于 init 之前捕获内联代码登录。
重新指向过时的 README 和同级技能引用。
Co-Authored-By: Claude Opus 5.5
无版本号
修复规范设置提示验证缺口
无版本号
将 clerk-setup 设为规范设置提示
无版本号
合并远程分支 'origin/main' 到 codex/readme-clerk-init-quick-start
# 冲突:
# skills/core/clerk-setup/SKILL.md
无版本号
处理 Clerk Skills README 审查
无版本号
fix: 保留 Core 2 设置指南
无版本号
同步无账户 Clerk 设置提示
无版本号
docs(clerk-cli): 在认证参考中采用无账户命名
将无账户部分重命名为 'Accountless: operating without an
account',并将 clerk init 描述为铸造一个可认领的、无账户的
应用(它会保存临时开发密钥)。更新四个
指向重命名锚点的交叉链接。
无版本号
docs(skills): 移除 keyless 品牌和已失效的 SDK keyless 流程
对应 clerk/clerk#3209:描述行为(临时开发
密钥,无需账户)而非 keyless 品牌,并从设置文案中
移除框架列表。
- clerk-setup:将 SDK 'Keyless (Automatic)' 密钥路径(在 @clerk/nextjs 7.8.0 中已移除)
替换为 clerk init 流程;修正 frontmatter
兼容性行;将版本提升至 2.5.0
- clerk-setup 评估:按 'clerk init temporary development keys'
评分,而非 'keyless dev mode'
- clerk-cli + references:重命名 Keyless 部分/锚点,改写
文字;字面 CLI 表面(--keyless、.clerk/keyless.json、whoami 的
keyless 对象)有意保留
- clerk router、clerk-orgs、clerk-billing:单行改写
无版本号
docs(clerk-cli): 精简 keyless 文档
相同事实,减少约 600 词。枚举原本是散文;现在它们是一张
表格,集中在一处而非五处。
- auth.md 以两列表格加两条脚注的形式承载 keyless/account 划分;
SKILL.md、agent-mode.md 和 clerk-setup 链接到它
- 将 sk_live_ 警告从 3 份减少到 1 份
- 拆分 176 词的 init 项目符号;排他性标记移至表格行
- 压缩配置块引用、whoami 行、故障排除行
Co-Authored-By: Claude Opus 5.5
无版本号
fix(clerk-cli): 修正 keyless 定向、标志和认领声明
针对本 PR 引入的声明进行审查跟进。已对照
cli@84a924a 验证。
- keyless 分支是密钥导向的,而非应用导向的:没有未认领检查,
没有环境检查,接受 sk_live_(keyless-target.ts:221)
- `users open` / `open users` 在认领前拒绝;`open` 返回
等同于凭据的认领 URL,而非仪表盘深层链接
- `whoami` 优先使用活动会话并丢弃 keyless 对象
(whoami/index.ts:68)
- `--keyless` 还会覆盖已链接的配置文件,而不仅仅是会话
- `--template`/`--fresh` 在 keyless 路径之外是用法错误;
`--fresh` 具有破坏性
- 自动认领仅覆盖 .clerk/keyless.json,而非 SDK 铸造的 .tmp
- 删除 agent-mode.md 中第 4 个有分歧的命令列表;链接到 auth.md
Co-Authored-By: Claude Opus 5.5
无版本号
docs(skills): keyless 是默认值——无需登录
CLI PR clerk/cli#395 使 keyless 成为未认证
clerk init 的默认值,并允许无需账户配置 keyless 实例。
更新那些仍声称 --keyless 是可选加入或
auth login 是前置条件的技能。
Co-Authored-By: Claude Fable 5
无版本号
feat(expo): 重建 clerk-expo 技能,吸收 clerk-expo-patterns
将两个重叠的 Expo 技能合并为一个意图驱动的
skills/mobile/clerk-expo,并已对照 @clerk/expo 3.6.x 验证:
- 针对当前基于方法的 API 重写自定义流程
(signIn.password/phoneCode/finalize)——旧参考教授的是
已不存在的旧版 prepareFirstFactor/setActive API 和钩子
- 将 "add auth" 默认设为预构建原生组件(AuthView/UserButton),
并附 beta + 开发构建注意事项;为 Expo Go/web/自定义 UI 提供自定义流程
- 添加 SMS OTP、MFA、Native API 仪表盘前置条件、主题 JSON、
captcha 挂载点,以及 Expo Go / 开发构建 / web 能力矩阵
- 统一使用 EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY(解决
两个旧技能之间直接 prop 与环境变量的矛盾)
- 添加可持续性机制:版本新鲜度门控、每个代码片段部分的规范文档
URL、构建并修复验证循环,以及 8 个能
捕获旧版 API 回归的评估
- 删除 skills/frameworks/clerk-expo-patterns;在
router、clerk-setup、README、CLAUDE.md 和插件清单中注册 clerk-expo
无版本号
feat(setup): 添加 agent-first CLI 侧边栏
- 新增 'Agent-first: Provision via CLI' 部分,涵盖 3 个设置场景 + 日常运维 + 通过原始 clerk api 轮换密钥
- 记录 clerk init、auth login、apps list/create、link、env pull、doctor 流程
- 注明 agent-mode 的 --app 要求(无交互式选择器)
- 在 Common Pitfalls 前添加 'Run clerk doctor first' 提示
- 为沙盒环境保留 Dashboard 回退
Closes AIE-929
无版本号
refactor(setup): 移除 Remix,现代化 Dashboard URL + Keyless 措辞
- 添加顶层兼容性字段,列出环境变量和 Node.js 要求
- 从框架检测表中移除已弃用的 Remix 条目;重定向到 React Router v7
- 将 Dashboard URL 从 last-active?path= 现代化为 ~/ 规范格式
- 将 Keyless 措辞更新为当前快速入门 UX(Configure your application 按钮)
- 从 Common Pitfalls 表中移除严重性标签列;保留症状 + 解决方案
无版本号
fix: 最终审查润色
- W1:改写 clerk-setup 跨技能引用,避免反引号路径语法
- W3:为 9 个缺少 See Also 的技能添加该部分(orgs、webhooks、backend-api、
custom-ui、vue、astro、expo、chrome-extension、react-router)
- W4:在 README Ask Your Agent 表中添加 Android 行
- N4:测试演示仓库 URL → 使用 main 分支而非固定提交
无版本号
fix: 解决最终审查问题
- backend-api 评估:修复不存在的脚手架(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: 解决审查阻塞项并清理一致性
- 修复损坏的 node-jwt-verify 评估脚手架 → 使用 nextjs-basic-auth
- 将 3 个 Nuxt 评估从 vue-patterns 移到 nuxt-patterns(错误的技能)
- 修复过时的交叉引用(setup/、custom-ui/ → 技能名称)
- 从 4 个框架参考表中移除影响列
- 从 custom-ui 标题中移除 (HIGH PRIORITY) 标签
- 从 vue composables.md 中移除 Nuxt 自动导入提及
无版本号
fix(setup): 将所有 16 个技能添加到 See Also 部分
Setup 是初始认证后的入口——用户需要从这里发现
框架模式、功能、移动端和 backend-api。
无版本号
fix: 更新交叉引用以使用技能名称而非路径
- 移动端技能:修复损坏的 ../clerk/ 和 ../setup/ 相对路径
- clerk-setup:更新 See Also 以使用技能名称(clerk-custom-ui 等)
- clerk-setup:修复对 nextjs-patterns 和 custom-ui 的内联引用
- clerk-nextjs-patterns:更新 See Also 为技能名称
- clerk-custom-ui:修复 setup/ 前置条件引用
- clerk-vue-patterns:从陷阱表中移除 @clerk/nuxt 提及
无版本号
chore: 为重构后的技能提升版本
无版本号
fix: 使所有 18 个技能通过 skills-ref 验证
- 将 inputs/references 移到 metadata 下(非规范顶层字段)
- 从 backend-api 中移除 argument-hint
- 为带冒号的描述加引号(YAML 解析修复)
- 重命名文件夹以匹配技能名称(规范要求 clerk- 前缀)
- 为 6 个有额外要求的技能添加 compatibility 字段
- 更新 marketplace.json 和文档路径
所有 18 个技能现在均通过:npx skills-ref validate
Part of AIE-750
暂无评论...