genkit-dart-google-skills

1. 基本信息

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

2. 功能介绍与亮点

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

主文档 + 21 篇专题参考文档：正文（9.8KB）给出核心用法索引后，按需展开到 Dotprompt、9 篇 Agent 子专题（会话存储、人工审批中断、分支、后台执行、多 Agent 委派等）、6 个模型/中间件插件、CLI 用法等参考文件，体量为 Genkit 现有四语言版本中最大。
点出 Dart 特有实现差异：正文专门提醒 Dart 版本与其他语言的不同之处——中断（interrupt）通过工具调用 ctx.interrupt() 实现而非 defineInterrupt，子 Agent 委派要用 genkit_middleware 包的 agents() 中间件，尚无 artifacts() 中间件（需直接定义 artifact 工具），并强制要求 schema 定义统一使用 schemantic 库。
CLI 调试链路完整：区分 genkit start（带追踪采集，阻塞式）、genkit flow:run（一次性运行后退出，适合非交互场景）、genkit trace:get --format json 等命令的适用场景，并明确警告不要把 genkit start 当作自动化流程里的阻塞步骤。
获 Dart 官方团队公开背书：Dart 官方博客 2026-03-10 发文宣布 Genkit Dart 时，明确建议开发者安装本 Agent Skill 辅助编码。

3. 适用场景

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

适用于用 Dart/Flutter 构建 AI 应用（生成式功能、工具调用 Agent、多轮对话系统）的工程师：从零搭建 Genkit 项目、给已有 Flutter/Dart 服务接入模型生成或工具调用能力、排查 Genkit Dart 特有的类型或运行时报错、需要理解 Agent 会话编排与多 Agent 委派用法时均可触发。不涉及非 Dart 技术栈。

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 专有字段，故四端均可直接使用。

5. 推荐理由

Dart/Flutter 工程师想用 Genkit 构建 AI 功能时，真正卡手的往往不是“有没有入门教程”，而是 Dart 版本与 JS/Go 版本在细节 API 上的差异（中断机制、多 Agent 委派中间件、schema 定义方式）——这些差异官方博客的入门文章不会展开，本技能把它们连同 21 篇专题参考文档一起组织成可按需加载的索引，agent 能直接查到 Dart 特有写法而不是套用其他语言的记忆。技能同时被 Dart 官方博客点名推荐安装，属于官方认可的编码辅助工具，是 Dart/Flutter 团队使用 Genkit 的权威参考。

6. 评分

维度	分数	说明
受欢迎程度	7	发布方 Google 为 Genkit 框架的所有者，属官方出品；`google/skills` 合集仓库 18,711 星不计入单个子技能；技能原始独立仓库 `genkit-ai/skills` 自身仅 26 星，独立热度证据有限
可用性	9	`npx skills add` 一条命令即可选装；21 篇参考文档结构完整，体量为 Genkit 现有四语言版本中最大；2026-08-25 有实质提交，维护活跃；无付费依赖
安全性	9	纯文本 Markdown 指令，全文核实无隐藏 shell 命令或混淆代码；仅指导用户运行标准 `dart`/`genkit` CLI 命令；正文自带“切勿把 API key 嵌入已发布应用”的安全实践提示；License 明确（Apache-2.0）

安全检查清单：

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

7. 跟同类 Skills 相比的优势

项目	定位	与本技能的差异
Genkit Go/JS/Python（同仓库其他语言版本）	同一 Genkit 框架在 Go、JS、Python 下的编码指南	覆盖不同语言生态；此前体量最大的 JS 版本为 18 篇参考文档，本 Dart 版本以 21 篇成为现有四语言中体量最大者
Firebase AI Logic	Google 面向 Flutter 的另一 AI 方案，客户端 SDK 直连 Gemini 模型，内置 App Check/Firebase Auth 安全机制	面向简单文本/图像生成、快速上线等轻量场景；Genkit Dart 面向需要后端工具调用、持久记忆、敏感逻辑保护的生产级复杂场景，二者互补而非替代
Gemini_Api_Google_Skills	Google Cloud/Vertex AI 场景下直接调用 Gemini 模型 API 的指南	聚焦底层模型调用本身（鉴权、请求格式），不提供 Flow 编排、工具调用、多轮 Agent 会话等应用层抽象

8. 用户评价

独立技术博主 Samuel Adekunle（笔名 Tech With Sam）2026-04-07 在 dev.to 发表《Genkit Dart for Flutter Developers》，称该框架“production-ready”、“Built and used in production by Google”，并总结核心优势为“You own the entire AI flow (client + backend)”；同一作者另发表《Genkit Dart vs Firebase AI Logic》一文，建议生产级、需要后端保护敏感逻辑的场景选择 Genkit Dart。以上评价针对 Genkit Dart 框架本身，本技能（编码参考文档）目前在第三方平台尚无独立具名评价。

9. 其他补充

Genkit Dart 于 2026-03-10 由 Dart 官方博客正式宣布，当时明确标注为“早期预览”（early preview）版本；Google 开发者关系团队 2026-07-31 另发文说明 Agent Skills 能力已统一覆盖 TypeScript、Go、Dart、Python 四门语言，是 Genkit 团队官方发起的整体倡议。

10. 安装使用方式

一键安装：npx skills add google/skills，安装过程中勾选 “Genkit Dart”。
插件市场（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-dart/（含 SKILL.md 与 references/ 目录共 22 个文件）复制到本地 agent 的 skills 目录。
安装后需先确认本地已安装 genkit CLI（genkit --version，未安装可用 curl -sL cli.genkit.dev | bash 或 npm install -g genkit-cli）；首次对话时表达“帮我用 Genkit 写一个 Flutter 的 AI Flow”或“这段 Genkit Dart 代码报错了帮我看看”即可触发。

11. 注意事项

技能所依托的 Genkit Dart 框架本身于 2026-03-10 以“早期预览”身份发布，官方公开说明会持续迭代改进，API 可能随版本更新而变化。
技能不包含 Genkit CLI 本身，需用户额外安装命令行工具后才能使用 genkit start 等追踪调试功能。
跨 Agent 兼容性结论基于 npx skills add（skills.sh）分发器的官方支持声明，未在四个平台逐一实机验证安装效果。