Community生产力与协作github.com

google/adk-dev-guide

始终激活——在任何ADK智能体开发会话开始时阅读。涵盖ADK开发生命周期和强制性编码指南——规范驱动的工作流、代码保留规则、模型选择及故障排除。

adk-dev-guide 是什么?

此技能为使用Google ADK(Agent Development Kit)进行智能体开发的开发者提供强制性指南和最佳实践。它定义了一个规范驱动的开发工作流,要求开发者首先编写详细的功能规范(spec-driven workflow),然后实现步骤(如每15行代码后运行测试),并严格执行代码保留规则——禁止重写、删除未测试的代码、重构或重排代码,除非任务明确要求。该技能还指导模型选择(建议使用Gemini 2.5 Pro或Claude 3.5 Sonnet v2以提升ADK开发效率),提供详细的故障排除指南(包括Python环境、库路径、导入错误等常见问题的解决方案),并强制在每次代码更改后运行测试或构建以确保可靠性。它适用于Claude Code、Cursor、Codex等AI编码助手环境,确保开发过程可预测、避免破坏性修改。该技能的关键规则包括:始终在变更前运行测试、在迭代前更新规范文档、并彻底调试错误。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/google/adk-docs/tree/main/skills/adk-dev-guide

Installed? Explore more 生产力与协作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

adk-dev-guide 是做什么的?

始终激活——在任何ADK智能体开发会话开始时阅读。涵盖ADK开发生命周期和强制性编码指南——规范驱动的工作流、代码保留规则、模型选择及故障排除。

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

google/adk-cheatsheet

MUST READ before writing or modifying ADK agent code. ADK API quick reference for Python — agent types, tool definitions, orchestration patterns, callbacks, and state management. Includes an index of all ADK documentation pages. Do NOT use for creating new projects (use adk-scaffold).

google/adk-deploy-guide

MUST READ before deploying any ADK agent. ADK deployment guide — Agent Engine, Cloud Run, GKE, CI/CD pipelines, secrets, observability, and production workflows. Use when deploying agents to Google Cloud or troubleshooting deployments. Do NOT use for API code patterns (use adk-cheatsheet), evaluation (use adk-eval-guide), or project scaffolding (use adk-scaffold).

google/adk-eval-guide

MUST READ before running any ADK evaluation. ADK evaluation methodology — eval metrics, evalset schema, LLM-as-judge, tool trajectory scoring, and common failure causes. Use when evaluating agent quality, running adk eval, or debugging eval results. Do NOT use for API code patterns (use adk-cheatsheet), deployment (use adk-deploy-guide), or project scaffolding (use adk-scaffold).

google/adk-observability-guide

MUST READ before setting up observability for ADK agents or when analyzing production traffic, debugging agent behavior, or improving agent performance. ADK observability guide — Cloud Trace, prompt-response logging, BigQuery Agent Analytics, third-party integrations, and troubleshooting. Use when configuring monitoring, tracing, or logging for agents, or when understanding how a deployed agent handles real traffic.

google/adk-scaffold

MUST READ before creating or enhancing any ADK agent project. Use when the user wants to build a new agent (e.g. "build me a search agent") or enhance an existing project (e.g. "add CI/CD to my project", "add RAG").

相关技能