用途：在已初始化 shadcn 的渲染器项目中批量添加 shadcn/ui 组件，并把生成代码里的 shadcn 调色板类名统一改写为 Scaffa 的 Tailwind v4 主题令牌，保证 UI 风格一致。
主要能力：按 /add-shadcn-component <component...> 用法一次添加多个组件；识别新增或修改的文件；按默认映射表替换背景、文字、边框、焦点环等颜色类（如 bg-background→bg-surface-app、text-foreground→text-fg、border-border→border-default、ring-ring→ring-focus）；运行 pnpm build 验证 TypeScript 与 CSS 编译；最后按仓库流程提交、同步并推送。
使用方式：先进入 src/renderer 目录，执行 pnpm dlx shadcn@latest add <component...>，再返回仓库根目录用 git status --porcelain 查看变更；随后在改动文件中搜索并替换 shadcn 调色板令牌，优先使用 surface 角色令牌而非数字层级；完成后执行 pnpm build，再 git add、git commit、git pull --rebase、bd sync、git push。
适用场景：使用 Scaffa 主题与 Tailwind v4 @theme 令牌的前端项目，需要引入 shadcn/ui 组件并保持设计系统一致时。
限制：假定 shadcn 已初始化且 src/renderer/components.json 存在，未初始化需先运行 init；仅替换颜色令牌，不重设间距、尺寸或布局；若组件需要主题中不存在的令牌，应提交工单而非自造颜色；提交时不应包含 .beads/issues.jsonl，明确为 no beads 的会话可跳过 bd sync。其他细节暂未提供。