开发人员需要指导才能在 Node.js 和 TypeScript 项目中正确使用 Genkit 框架。此技能提供参考文档、常见错误解决方案以及使用 Genkit 构建 AI 应用的代码模式。
下载技能 ZIP
在 Claude 中上传
前往 设置 → 功能 → 技能 → 上传技能
开启并开始使用
测试它
正在使用“developing-genkit-js”。 使用 Google AI 提供商设置新的 Genkit 项目
预期结果:
- 在源文件夹中创建 ai 目录
- 安装 genkit 和 @genkit-ai/google-genai 包
- 创建 genkit.ts，包含 genkit() 初始化和 googleAI 插件
- 创建 flows 和 tools 子目录以便组织
- 向 package.json 添加 genkit:ui 脚本以访问开发 UI
- 设置 GEMINI_API_KEY 环境变量
正在使用“developing-genkit-js”。 修复使用 pre-1.0 导入的 defineFlow 时的 ValidationError
预期结果:
- 将 `import { defineFlow } from "@genkit-ai/flow"` 替换为在 ai 实例上定义流程
- 将 `import { genkit } from "@genkit-ai/core"` 替换为 `import { genkit } from "genkit"`
- 将 `configureGenkit()` 替换为 `const ai = genkit({ plugins: [...] })`
- 通过 `response.text` 属性而不是 `response.text()` 方法访问响应文本
- 运行 `npx tsc --noEmit` 进行类型检查以验证迁移完成
安全审计
低风险All 194 static analyzer findings are false positives. The skill consists entirely of markdown documentation and code examples for the Genkit JS framework. The 176 'external_commands' detections are markdown inline code spans (backtick formatting) showing CLI commands like `genkit --version` and `npx tsc --noEmit`, not actual shell execution. The 'weak cryptographic algorithm' findings have no corresponding crypto operations in the source. The 'hardcoded URL' findings are documentation references (localhost dev UI and example.com placeholder). The 'env_access' finding is documentation instructing users to set API keys. No executable code exists in this skill. Safe to publish.
低风险问题 (4)
质量评分
你能构建什么
设置新的 Genkit 项目
开发人员希望使用 Genkit 向现有 Node.js 应用程序添加 AI 功能。该技能指导目录结构、包安装、插件配置和初始流程创建。
从 Genkit pre-1.0 迁移到 v1.x
团队维护一个在 v1.0 版本之前构建的 Genkit 应用程序。该技能识别已弃用的 API，为导入、模型引用和流程定义提供迁移模式。
构建多模态 AI 功能
产品团队希望向其应用程序添加图像生成或文本转语音功能。该技能为 Gemini 多模态模型提供正确配置的工作示例。
试试这些提示
我想使用 Genkit 向我的 Node.js 项目添加 AI 功能。帮助我设置项目结构、安装所需的包，并创建一个生成文本的简单流程。
我的 Genkit 流程中出现 TypeScript 错误。检查常见错误参考，并帮助我确定这是否是已弃用的 API 问题或导入问题。
我需要一个使用 Zod 架构返回结构化 JSON 输出的 Genkit 流程。向我展示如何定义架构、创建流程以及访问类型化输出。
我想构建一个使用 Gemini 2.5 Flash 图像模型生成图像并流式传输部分结果的 Genkit 流程。包含正确的 responseModalities 配置，并解释如何处理媒体输出。
最佳实践
- 始终使用 Genkit CLI（`genkit docs:search`、`genkit docs:read`）查找最新文档，而不是依赖内部知识，因为 Genkit API 在版本之间经常更改。
- 将 API 密钥和敏感配置存储在环境变量或 .env 文件中。永远不要在源文件中硬编码凭据或将它们提交到版本控制。
- 使用 `genkit` 包（而不是独立的 `zod` 包）中的 Zod 架构进行所有输入和输出定义。添加 `.describe()` 注释以指导 LLM 正确填充架构字段。
避免
- 不要从已弃用的包（如 `@genkit-ai/core`、`@genkit-ai/ai` 或 `@genkit-ai/flow`）导入。改为直接从 `genkit` 包导入核心功能。
- 在故障排除时不要跳过阅读常见错误参考。许多错误是由已记录解决方案的已弃用 API 使用引起的。
- 不要使用已停用的模型版本，如 `gemini-2.0-*` 或 `gemini-1.5-*`。始终使用最佳实践参考中指定的最新一代模型。