技能 developing-genkit-js

📦

developing-genkit-js

Name: developing-genkit-js
Author: firebase

低风险

JavaScriptでGenkitを使ったAIアプリ開発

也可从以下获取: genkit-ai

開発者がNode.jsおよびTypeScriptプロジェクトでGenkitフレームワークを正しく活用するためのガイダンスを提供します。このスキルは、Genkitを使用したAIアプリケーション構築のためのリファレンスドキュメント、一般的なエラーの解決策、コードパターンを提供します。

支持: Claude Codex Code(CC)

📊 70 充足

下载技能 ZIP

在 Claude 中上传

前往设置 → 功能 → 技能 → 上传技能

开启并开始使用

测试它

正在使用“developing-genkit-js”。 Set up a new Genkit project with Google AI provider

预期结果:

ソースフォルダー内にaiディレクトリを作成
genkitと@genkit-ai/google-genaiパッケージをインストール
genkit()の初期化とgoogleAIプラグインを含むgenkit.tsを作成
整理のためにflowsおよびtoolsサブディレクトリを作成
Dev UIにアクセスできるようpackage.jsonにgenkit:uiスクリプトを追加
GEMINI_API_KEY環境変数を設定

正在使用“developing-genkit-js”。 Fix ValidationError when using defineFlow with pre-1.0 imports

预期结果:

`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`で型チェックを実行し、移行が完了したことを確認

安全审计

低风险

v1 • 4/13/2026

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.

已扫描文件

545

分析行数

发现项

审计总数

低风险问题 (4)

SKILL.md:1-113 references/best-practices.md:1-32 references/common-errors.md:1-133 references/docs-and-cli.md:1-62 references/examples.md:1-158 references/setup.md:1-47

False Positive: Markdown Backtick Code Examples

Static analyzer flagged 176 instances of 'Ruby/shell backtick execution' across all markdown files. These are all markdown inline code formatting (e.g., `genkit --version`, `npx tsc --noEmit`, `npm install -g genkit-cli`). No actual shell execution or code injection exists. The skill contains only documentation text.

references/docs-and-cli.md:21 references/examples.md:128

False Positive: Hardcoded URLs in Documentation

Static analyzer flagged hardcoded URLs at references/docs-and-cli.md:21 (http://localhost:4000, the Genkit Dev UI localhost address) and references/examples.md:128 (https://example.com/photo.jpg, a placeholder example URL). These are documentation references, not actual network requests.

references/setup.md:40

False Positive: Environment Variable Documentation

Static analyzer flagged 'Generic API/secret keys' at references/setup.md:40. This line instructs users to set environment variables like GEMINI_API_KEY. It is documentation guidance, not actual credential access or exfiltration.

SKILL.md:3 references/best-practices.md:20-22 references/common-errors.md:110 references/examples.md:32-33

False Positive: Weak Cryptographic Algorithm

Static analyzer flagged 'weak cryptographic algorithm' at multiple locations in SKILL.md, references/best-practices.md, references/common-errors.md, and references/examples.md. No cryptographic operations exist in any file. These are likely false matches on model names or configuration strings in documentation text.

审计者: claude

质量评分

架构

100

可维护性

内容

社区

安全

规范符合性

你能构建什么

新しいGenkitプロジェクトのセットアップ

開発者が既存のNode.jsアプリケーションにGenkitを使用してAI機能を追加したい場合、このスキルはディレクトリ構造、パッケージインストール、プラグイン設定、初期フローの作成をガイドします。

Genkit pre-1.0からv1.xへの移行

v1.0リリース前に構築されたGenkitアプリケーションをメンテナンスしているチーム向けに、このスキルは非推奨のAPIを特定し、インポート、モデル参照、フロー定義の移行パターンを提供します。

マルチモーダルAI機能の構築

アプリケーションに画像生成やテキスト読み上げ機能を追加したい製品チーム向けに、このスキルは正しい設定を含むGeminiマルチモーダルモデルの動作例を提供します。

试试这些提示

新しいプロジェクトでGenkitをセットアップ

Node.jsプロジェクトにGenkitを使ってAI機能を追加したいです。プロジェクト構造のセットアップ、必要なパッケージのインストール、テキストを生成するシンプルなフローの作成をサポートしてください。

Genkitの型エラーを修正

GenkitフローでTypeScriptエラーが発生しています。一般的なエラーリファレンスを確認し、これが非推奨APIの問題なのか、インポートの問題なのかを特定してください。

構造化出力フローの作成

Zodスキーマを使用して構造化されたJSON出力を返すGenkitフローが必要です。スキーマの定義方法、フローの作成方法、型付けされた出力へのアクセス方法を示してください。

ストリーミングによる画像生成の追加

Gemini 2.5 Flash Imageモデルを使用して画像を生成し、部分的な結果をストリーミングするGenkitフローを構築したいです。正しいresponseModalities設定を含め、メディア出力の処理方法についても説明してください。

最佳实践

Genkit APIはバージョン間で頻繁に変更されるため、内部知識に依存せず、常にGenkit CLI（`genkit docs:search`、`genkit docs:read`）を使用して最新のドキュメントを参照してください。
APIキーや機密設定は環境変数または.envファイルに保管してください。資格情報をソースファイルにハードコードしたり、バージョン管理システムにコミットしたりしないでください。
すべての入出力定義には、スタンドアロンの`zod`パッケージではなく`genkit`パッケージのZodスキーマを使用してください。LLMがスキーマフィールドを正しく設定できるよう、`.describe()`アノテーションを追加してください。

避免

`@genkit-ai/core`、`@genkit-ai/ai`、`@genkit-ai/flow`などの非推奨パッケージからインポートしないでください。コア機能は直接`genkit`パッケージからインポートしてください。
トラブルシューティング時に一般的なエラーリファレンスの確認をスキップしないでください。多くのエラーは文書化された解決策がある非推奨APIの使用が原因です。
`gemini-2.0-*`や`gemini-1.5-*`などの廃止されたモデルバージョンを使用しないでください。必ずベストプラクティスリファレンスで指定されている最新世代のモデルを使用してください。

常见问题

Genkitとは何ですか？また、このスキルは何をするものですか？

Genkitは、JavaScriptおよびTypeScriptでAI駆動のアプリケーションを構築するためのフレームワークです。このスキルは、Genkitを正しく開発できるよう、リファレンスドキュメント、一般的なエラーの解決策、コードパターンを提供します。

GenkitはどのAIモデルプロバイダーをサポートしていますか？

GenkitはGoogle AI、OpenAI、Anthropic、Ollamaなど、複数のプロバイダーをサポートしています。このスキルはGoogle AIの例をデフォルトとしていますが、`genkit docs:search plugins`でドキュメントを検索し、他のプロバイダーの設定を見つけることができます。

Genkit CLIの最小必須バージョンは何ですか？

必要な最小CLIバージョンは1.29.0です。`genkit --version`でバージョンを確認し、`npm install -g genkit-cli@^1.29.0`でインストールまたはアップグレードできます。

Genkitのエラーをトラブルシューティングするにはどうすればよいですか？

まず常に一般的なエラーリファレンスを参照してください。ほとんどのエラーは非推奨のpre-1.0 APIの使用が原因です。エラーを文書化されたパターンに照らし合わせ、外部ソースを検索する前に解決策を適用してください。

Genkit Developer UIを有効にするにはどうすればよいですか？

`genkit start -- <your-start-command>`でアプリケーションを実行してください。これによりDeveloper UIが有効になり、通常http://localhost:4000でアクセスでき、フローのテストや実行のモニタリングが可能です。

Next.jsやFirebaseプロジェクトでこのスキルを使用できますか？

はい。GenkitはNext.js（@genkit-ai/next経由）およびFirebase（@genkit-ai/firebase経由）と統合されています。このスキルはpackage.jsonからフレームワークを検出し、それに応じてガイダンスを調整します。