用途:在 Clerk 的 JavaScript SDK 单体仓库中高效工作,覆盖环境搭建、构建、测试、提交与发布前检查。仓库含 25 个包(22 个已发布的 @clerk/* 及私有的 @clerk/msw、@clerk/headless、@clerk/swingset),由 pnpm workspaces 与 Turborepo 管理。
主要能力:给出包地图与依赖关系,说明改动某包时需连带处理哪些包;提供开发循环命令,如 pnpm turbo build --filter=@clerk/nextjs、pnpm dev:fe-libs、pnpm --filter @clerk/backend test;并列出质量门禁 pnpm lint、pnpm format、pnpm changeset status --since=origin/main。
必要用法:按顺序执行——Node >=24.15.0(见 .nvmrc)、corepack enable、在仓库根目录 pnpm install、先 pnpm build 再 pnpm dev。每个 PR 需手写 .changeset/<name>.md(不要用交互式 CLI),提交标题须符合 type(scope): 且 scope 必填。
限制:clerk-js 与 ui 在非大版本发布中必须保持向后兼容;改动 core/clerk.ts 的 Clerk 类公开 API 需大版本与 !allow-major 批准;_internal 或 /experimental 前缀的 API 不受 SemVer 保证。仓库根 AGENTS.md 为规则权威来源,冲突时以其为准。发布流程见 docs/PUBLISH.md,本技能止于开 PR。