1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | developing-genkit-js-google-skills |
| 作者/维护者 | Google(官方) |
| 来源链接 | https://github.com/google/skills/tree/main/skills/cloud/developing-genkit-js |
| 许可证 | Apache-2.0 |
| GitHub Stars / Forks | 21,805 / 1,861(所属仓库整体数字,不代表本技能自身热度;GitHub API,2026-11-10 读取) |
| 最新版本 | 技能内标注 1.0.0;仓库主分支最近一次提交 2026-11-06 |
| 安装方式 | 把技能目录复制进 agent 的 skills 目录;另需 Genkit CLI(≥ 1.29.0)与 Node 环境 |
数据来源:上述数字取自 GitHub API;功能与评分依据来自技能正文与官方文档。
2. 功能介绍与亮点
一句话:在 Node/TypeScript 里用 Genkit 搭 AI 应用时的贴身顾问——从 CLI 版本、flow、tool 到类型错误与校验问题都有对应解法。
- 先卡版本:要求 Genkit CLI ≥ 1.29.0,命令与升级方式写清楚,避免用旧 CLI 踩坑。
- 新项目引导:给出 setup 指南,按官方推荐结构起步。
- 概念到位:flow、tool、agent 在 JS/TS 语境里的写法与边界。
- 错误对症:校验失败、类型报错、API 调用问题的定位顺序。
- 边界明确:只管 JS/TS,Python、Go、Dart 各有独立技能。
3. 适用场景
所属分类:工程效率与代码质量。
- 用 Genkit 在 Node/TS 里搭 AI 应用或 agent 的前端与全栈工程师;
- 被 Genkit 的类型错误、schema 校验或 CLI 版本问题卡住的人;
- 想按官方推荐结构初始化新项目的团队;
- 从其他 AI SDK 迁到 Genkit、需要对照概念的开发者。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 技能目录安装,按描述触发 |
| Codex | 需适配 | 技能正文通用,CLI 与 Node 环境需按平台配置 |
| OpenClaw | 需适配 | 需要平台支持技能目录并允许执行本地命令 |
| Hermes Agent | 未验证 | 未找到该平台的接入示例 |
5. 推荐理由
Genkit 的坑集中在版本与类型上:CLI 低于门槛时行为不一致、schema 校验报错信息不直观。这份技能把版本要求、初始化路径与常见报错放在一起,对新上手的人能省掉一轮「为什么跑不起来」的排查。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Google 官方出品;所属仓库 21,805 stars 是整个合集热度,不代表本技能自身热度 |
| 可用性 | 8 | 版本门槛、初始化与报错对策完整;前置是 Node 与 Genkit CLI |
| 安全性 | 9 | 见下方清单;纯指引与本地 CLI,不外发数据 |
安全性检查清单:
| 项 | 结果 |
|---|---|
| ① 执行 shell 与权限 | 执行 genkit --version 等本地命令,作用域限于项目 |
| ② 联网外发 | 不主动外发;npm 安装由用户自行执行 |
| ③ 凭据 | 不需要 API key(模型调用凭据由项目自备) |
| ④ 可疑指令 | 未见注入或夹带推广 |
| ⑤ 作者信誉 | Google 官方仓库,Apache-2.0 |
| ⑥ License | Apache-2.0,全文可查 |
| ⑦ 维护时间 | 2026-11-06 仍在更新 |
扣分点:只覆盖 JS/TS;Genkit 版本迭代快,示例需按当前版本文档核对。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| developing-genkit-python-google-skills | Python 版 Genkit | 语言不同;概念一致但 API 与示例不同 |
| developing-genkit-go-google-skills | Go 版 Genkit | 同上 |
| firebase-basics-google-skills | Firebase 基础 | 管后端平台;本技能管 AI 应用框架本身 |
核心差异:同类是同一框架的其他语言版本或周边平台,它是 Node/TS 这条线的完整指引。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价(2026-11-10)。
9. 其他补充
- 技能内标注 1.0.0,随官方仓库更新。
- 属于
google/skills合集(180 个技能),可按需只装这一条。
10. 安装使用方式
git clone https://github.com/google/skills
mkdir -p ~/.claude/skills
cp -r skills/skills/cloud/developing-genkit-js ~/.claude/skills/
genkit --version # 需 >= 1.29.0
装好后说「用 Genkit 在 TS 里搭一个带工具的问答 flow」,它会按官方结构给代码。
11. 注意事项
- 先确认 CLI 版本,低于 1.29.0 先升级。
- 只适用于 JS/TS;其他语言用对应技能。
- 模型调用凭据由项目自己配置,技能不代管。
- Genkit 版本更新快,示例以当前官方文档为准。