用途:当项目已存在、需要在不破坏依赖与元数据假设的前提下叠加 add-on 集成时使用本技能。
主要能力:支持一次添加多个集成,例如 npx @tanstack/cli add clerk drizzle 或 npx @tanstack/cli add tanstack-query drizzle;可在应用前解析候选 id,命令为 npx @tanstack/cli create --list-add-ons --json;可在安装前校验带选项的 add-on,命令为 npx @tanstack/cli create --addon-details prisma --json。
使用方式与限制:add 流程依赖已持久化的脚手架元数据,必须在由 TanStack CLI 生成、包含 .cta.json 的项目中运行,否则命令可能失败或只应用不完整配置。插件 id 必须有效,未知 id 会中断解析,需先手动修正。带 dependsOn 的插件若缺少必需依赖,可能在最终化阶段失败,应先添加所需依赖。历史上 Windows 路径问题已在新版本修复,不应据此回避受支持的工作流。
适用场景:为已有 TanStack 项目增量引入 Clerk、Drizzle、TanStack Query、Prisma 等集成。
注意:本技能与 maintain-custom-addons-dev-watch 存在张力,自动化若假设通用 add 流程容易失败,因为旧版兼容仍依赖隐藏的脚手架元数据。具体版本要求、平台支持范围与选项细节暂未提供。