genkit-js-google-skills

1. 基本信息

项目	内容
名称	Genkit JS（`developing-genkit-js`）
作者/维护者	Google（Genkit 团队；技能原始发布于独立仓库 `genkit-ai/skills`，2026-08-25 被官方 `google/skills` 仓库整体导入收录）
来源链接	https://github.com/google/skills/tree/main/skills/cloud/genkit-js
许可证	Apache-2.0（数据来源：GitHub API + 仓库根目录 `LICENSE` 文件确认）
GitHub Stars	18,709（数据来源：GitHub API；该数字属整个 `google/skills` 合集仓库，不代表本技能自身热度）
Forks	1,503（同上，合集整体数据）
最新版本	仓库不发布正式 release，持续滚动更新；本技能目录最近一次提交为 2026-08-25（数据来源：GitHub API 提交记录）
安装方式	`npx skills add google/skills` 交互式勾选安装，或手动复制 `skills/cloud/genkit-js/` 目录到 agent 的 skills 目录

2. 功能介绍与亮点

Genkit 是 Google 开源的 AI 应用开发框架，覆盖生成、结构化输出、工具调用、流程编排与多轮 Agent 会话，跨 JS/TS、Go、Python、Dart 四种语言提供一致 API。本技能是 Node.js/TypeScript 实现的编码参考指南：

主文档 + 18 篇专题参考文档：正文（11.6KB）给出可运行的 Hello World 示例后，按需索引到 Dotprompt、9 篇 Agent（会话存储、人工审批中断、分支、后台执行、多 Agent 委派等）、中间件、常见报错、CLI 用法等参考文件，体量在 Genkit 四语言版本中最大。
强制“先查文档再动手”的报错协议：正文明确要求 agent 遇到任何 Genkit 报错时必须先读 common-errors.md，并特别提醒“Genkit 近期经历破坏性 API 变更，模型自身预训练知识可能已过时”，要求通过 genkit docs:read/docs:search 而非记忆作答。
CLI 调试链路完整：给出 genkit start（带 trace 采集）、genkit flow:run（一次性运行并退出）、genkit trace:get --format json 等命令的适用场景区分，避免 agent 误用阻塞式命令。
官方持续维护：所属独立仓库 genkit-ai/skills 近三个月有数十次合并记录；2026-08-25 被完整导入 google/skills 官方合集。
获第三方技能评测机构审查：Tessl（技能评测工具厂商，github.com/tesslio）贡献者 yogesh-tessl 于 2026-05-19 提交改进提案，详见第 8 节。

3. 适用场景

固定分类：工程效率与代码质量。

适用于用 Node.js/TypeScript 构建 AI 应用（生成式功能、工具调用 Agent、多轮对话系统）的工程师：从零搭建 Genkit 项目、给已有服务接入模型生成/工具调用能力、排查 Genkit 相关的类型错误或运行时报错、或需要理解 Agent（Beta）会话编排、中间件用法时均可触发。不涉及非 JS/TS 技术栈。

4. 跨 Agent 兼容性

Claude Code：原生支持——npx skills add（skills.sh/vercel-labs/skills 分发器）官方支持列表明确列出 Claude Code 专用安装路径（.claude/skills/）。
Codex：原生支持——同一分发器列出 Codex 专用路径（.agents/skills/，用户目录 ~/.codex/skills/）。
OpenClaw：原生支持——分发器列出 OpenClaw 专用路径（skills/，用户目录 ~/.openclaw/skills/）。
Hermes Agent：原生支持——分发器列出 Hermes Agent 专用路径（.hermes/skills/）。
判断依据：技能遵循通用 Agent Skills 规范，SKILL.md frontmatter 仅含 name/description/metadata，未使用任何单一 agent 专有字段（如 allowed-tools），故四端均可直接使用。

5. 推荐理由

JS/TS 工程师想用 Genkit 构建 AI 功能时，常见卡点是“框架概念多、API 面广，不知道该读哪份文档”——本技能把整套知识拆成一份 Hello World 起步示例 + 18 份按需加载的专题参考（Agent 会话就细分成 9 篇子专题），agent 可以只读当前任务相关的那一份，兼顾覆盖深度与上下文效率。技能还内置了针对“Genkit 近期破坏性升级”的应对协议，强制查证而非凭旧知识作答，减少了 agent 因框架版本变化给出过时代码的风险。经第三方技能评测机构实测验证后仍表现良好，是 Node.js/TypeScript 团队使用 Genkit 的权威参考。

6. 评分

维度	分数	说明
受欢迎程度	7	发布方 Google 为 Genkit 框架的所有者，属官方出品；`google/skills` 合集仓库 18,709 星不计入单个子技能；技能原始仓库 `genkit-ai/skills` 自身仅 26 星，独立热度证据有限
可用性	9	`npx skills add` 一条命令即可选装；18 篇参考文档结构完整、体量为同族四语言版本中最大；2026-08-25 有实质更新，维护活跃；无付费依赖
安全性	9	纯文本 Markdown 指令，全文核实无隐藏 shell 命令或混淆代码；仅指导用户运行标准 npm/genkit CLI 命令；技能本身不索取或存储任何凭据；License 明确（Apache-2.0）

安全检查清单：

检查项	结果
① Shell 命令执行范围	指导用户运行标准 `npm install`、官方 `genkit` CLI（`genkit start`/`genkit flow:run` 等），用途逐条说明，无越权范围
② 运行时联网外发	由用户自行配置的模型插件（如 `googleAI()`）连接对应 AI 服务商 API，行为透明，未发现隐蔽外发
③ API key/凭据	由用户通过各模型插件自行配置与保管，技能本身不接触或存储凭据
④ 可疑指令/注入迹象	亲自抓取 SKILL.md 全文核实，未发现 prompt injection 或与任务无关的夹带内容
⑤ 作者/组织信誉	Google 官方仓库；技能经第三方评测机构 Tessl 审查，无造假迹象
⑥ License	Apache-2.0，明确（技能原始独立仓库 `genkit-ai/skills` 本身未附 LICENSE 文件，但本技能实际来源与安装渠道 `google/skills` 已在仓库根目录附完整 Apache-2.0 授权，适用于本技能）
⑦ 最近维护时间	技能目录最近提交 2026-08-25，持续维护中

7. 跟同类 Skills 相比的优势

项目	定位	与本技能的差异
Genkit Go/Python/Dart（同仓库其他语言版本）	同一 Genkit 框架在 Go、Python、Dart 下的编码指南	覆盖不同语言生态；Python、Dart 版本为单文件 SKILL.md（无独立 references 目录），内容体量小于 JS 版本
Gemini_Api_Google_Skills	Google Cloud/Vertex AI 场景下直接调用 Gemini 模型 API 的指南	聚焦底层模型调用本身（鉴权、请求格式），不提供 Flow 编排、工具调用、多轮 Agent 会话等应用层抽象；Genkit 可基于 Gemini API 构建，两者互补而非替代
LangChain.js	社区维护的通用 LLM 应用开发框架，覆盖链式调用、Agent、工具集成	非官方出品、依赖某一模型供应商生态较分散；缺少 Genkit 内置的 Dev UI 追踪（trace）与 Google Cloud/Firebase 原生部署路径

8. 用户评价

Tessl（技能评测工具厂商）贡献者 yogesh-tessl 于 2026-05-19 在 genkit-ai/skills 仓库提交 Pull Request #19（标题“feat: improve developing-genkit-js skill score (86% → 100%)”，目前仍为开放状态未合并），内容为其“tessl skill review”工具对本技能的自动化评审报告：列出描述精简、参考文档索引表、报错处理统一等具体改进点，并写明“also stress-tested your developing-genkit-js skill against a few real-world task evals… it held up really well on multi-provider flow configuration with schema validation”（用真实任务用例压力测试后，在多模型供应商 Flow 配置与 schema 校验方面表现良好）。除此之外，该技能在 Reddit、Hacker News 等公开渠道尚无独立具名用户评价。

9. 其他补充

Google 开发者官方博客 2026-07-31 发布专文《Enable on-demand expertise with Agent Skills in Genkit Go》（作者 Daniela Petruzalek，Google 开发者关系工程师），明确说明 Agent Skills 能力已同时覆盖 TypeScript、Go、Dart、Python 四门语言，是 Genkit 团队官方发起的统一倡议而非个别语言分支的自发产物。

10. 安装使用方式

一键安装：npx skills add google/skills，安装过程中勾选 “Genkit JS”。
插件市场（Claude Code）：claude plugin marketplace add google/skills，再执行 claude plugin install <plugin>@google-plugins。
插件市场（Codex）：codex plugin marketplace add google/skills，再从 /plugins 浏览器中选择安装。
手动安装：将仓库 skills/cloud/genkit-js/（含 SKILL.md 与 references/ 目录共 19 个文件）复制到本地 agent 的 skills 目录。
安装后需先确认本地 genkit CLI 版本 ≥1.29.0（genkit --version，不满足则 npm install -g genkit-cli@^1.29.0）；首次对话时表达“帮我用 Genkit 写一个 Node.js 的 AI Flow”或“这段 Genkit 代码报错了帮我看看”即可触发。

11. 注意事项

技能正文标注的 Agent（多轮会话）能力目前处于 Beta 阶段，需要 genkit >= 1.39.0，API 可能随框架版本迭代变化。
技能不包含 Genkit CLI 本身，需用户额外执行 npm install -g genkit-cli 安装命令行工具后才能使用 genkit start 等追踪调试功能。
跨 Agent 兼容性结论基于 npx skills add（skills.sh）分发器的官方支持声明，未在四个平台逐一实机验证安装效果。