用途:gemskills setup 用于配置 gemskills 的默认提供商,覆盖图像、视频、编辑三类任务。提供商按任务选择,可用 --provider 指定,或根据可用 API 密钥自动挑选。
主要能力:检测已存在的密钥;查看配置路径、合并设置与密钥;查询某任务当前会解析到哪个提供商;设置全局或项目级默认提供商。图像任务支持 gemini(GEMINI_API_KEY)、openai(OPENAI_API_KEY)、xai(XAI_API_KEY);视频任务支持 xai、gemini;编辑任务支持 gemini、openai。
使用方式:所有操作通过 config CLI 完成,解析优先级为 --provider 标志 → GEMSKILLS_<TASK>_PROVIDER 环境变量 → 项目 .gemskills.json → 全局 ~/.config/gemskills/config.json → 能力感知自动挑选。常用命令: bun run --cwd ${CLAUDE_PLUGIN_ROOT} ${CLAUDE_PLUGIN_ROOT}/providers/config.ts detect bun run --cwd ${CLAUDE_PLUGIN_ROOT} ${CLAUDE_PLUGIN_ROOT}/providers/config.ts show bun run --cwd ${CLAUDE_PLUGIN_ROOT} ${CLAUDE_PLUGIN_ROOT}/providers/config.ts get image bun run --cwd ${CLAUDE_PLUGIN_ROOT} ${CLAUDE_PLUGIN_ROOT}/providers/config.ts set image openai bun run --cwd ${CLAUDE_PLUGIN_ROOT} ${CLAUDE_PLUGIN_ROOT}/providers/config.ts set video xai --project 交互式流程可运行 /gemskills:setup 斜杠命令,用 AskUserQuestion 让用户为每个任务选择默认提供商(仅列出有密钥的提供商及 Auto-pick 选项),再用 config set 持久化。
适用场景:需要为图像、视频、编辑任务固定默认提供商,或在非交互环境中由智能体直接调用 CLI 修复配置。
限制:自动挑选是能力感知的,使用风格瓦片或专用负面提示的请求会路由到 Gemini,无论默认配置为何。透明度仅 OpenAI Image 2.5(Flare/Sunburst)与 Gemini 支持。每次调用的 --provider 始终优先于已保存配置。密钥只从各自唯一规范环境变量读取,不会回退到其他名称;规范变量未设置时提供商会明确报错。缺失密钥时需告知用户确切环境变量及获取地址(aistudio.google.com / platform.openai.com / console.x.ai),不得替换为其他密钥名。