adk-skill

为使用 Google ADK 开发智能体提供深度知识与最佳实践

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:adk-skill。
它的用途是:为使用 Google ADK 开发智能体提供深度知识与最佳实践
完整的 Skill 内容见:https://321skill.com/skills/adk-skill/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“我正在用 ADK 的 Python SDK 构建一个客服协调智能体,需要实现一个图形工作流,在用户查询复杂时能自动路由给不同的专业子代理处理,并保存对话历史。” 它会引导你设计基于 `Workflow` 的图结构,使用 `@node` 装饰器定义处理节点,集成 Memory Service 来保存对话,并参考 `a2a-protocol.md` 来配置子代理间的远程调用。

介绍

这个 Skill 旨在解决开发者在构建基于 Google Agent Development Kit (ADK) 的单智能体或多智能体系统时,面临的架构理解、模式选择、跨语言实现等核心难题。它通过一个核心指令文件和一系列按需加载的参考文档,提供了从基础工作流(如图形化、动态、协作式)到高级功能(如内存服务、工件管理、A2A协议)的全面指导。

开发者可以通过在编码代理中加载此 Skill,使其获得关于 ADK 的深度知识。当代理在项目中遇到 ADK 相关任务时,它能自动调用这些知识,提供符合最佳实践的代码示例、设计模式解释和问题排查思路,覆盖 Python、Java、Go、Kotlin 和 TypeScript 等多种语言。

它非常适合正在或计划使用 Google ADK 框架的智能体开发者、全栈开发者和后端开发者,特别是那些需要构建复杂、可扩展且需跨团队协作的智能体系统的团队。对于从 ADK 1.x 迁移到 2.0+ 的开发者来说,其中的迁移指南和新增功能详解也极具价值。

建议将此 Skill 作为开发者的“ADK 专家副驾驶”来使用。在项目初期用于搭建架构,在编码过程中用于查询具体 API 和模式,在调试时用于排查常见错误。注意,其知识深度与 ADK 官方文档和版本紧密绑定,对于框架外的通用编程问题,可能需要结合其他 Skill 使用。

核心特点

这是目前唯一深度覆盖 Google ADK 2.0+ 所有核心特性(如图形化工作流、动态工作流、A2A协议、内存与工件服务)及多语言(Python/Java/Go/Kotlin/TS)实现细节的 Skill,提供了从设计模式到部署评估的端到端指导,而非零散的代码片段。

注意事项

此 Skill 专精于 Google ADK 生态,不适合用于开发基于其他智能体框架(如 LangChain, AutoGen)的应用。

常见问题

ADK 2.0 和 1.x 的主要区别是什么?

ADK 2.0 引入了强大的图形化工作流引擎、动态工作流、改进的 A2A 协议、统一的内存与工件服务,架构更模块化,支持更复杂的多智能体协作场景。

这个 Skill 支持用 Java 或 Go 开发 ADK 智能体吗?

完全支持。Skill 中的 `multi-language.md` 等参考文件专门提供了 Java、Go、Kotlin 和 TypeScript 的特定模式、代码示例和与 Python 的对比。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/adk-skill/raw/index.md 读取 adk-skill 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。