google-agents-cli-adk-code
GitHub提供 Google ADK 构建 Agent 的代码参考，涵盖 Python/Go 的 Agent 定义、工具、回调、状态管理及工作流模式。用于在脚手架完成后编写和实现 Agent 逻辑。
Trigger Scenarios
Install
npx skills add google/agents-cli --skill google-agents-cli-adk-code -g -y
SKILL.md
Frontmatter
{
"name": "google-agents-cli-adk-code",
"metadata": {
"author": "Google",
"license": "Apache-2.0",
"version": "1.6.1",
"requires": {
"bins": [
"agents-cli"
],
"install": "uv tool install google-agents-cli"
}
},
"description": "This skill should be used when the user wants to \"write agent code\", \"build an agent with ADK\", \"add a tool\", \"create a callback\", \"define an agent\", \"use state management\" — in a project that needs ADK (Agent Development Kit) API patterns and code examples. It provides a quick reference for agent types, tool definitions, orchestration patterns, callbacks, state management, the graph Workflow API, and reference recipes to study. Do NOT use for scaffolding (use google-agents-cli-scaffold) or deployment (use google-agents-cli-deploy).\n"
}
ADK Code Reference
Activate /google-agents-cli-workflow first for required development phases and scaffolding steps.
1. Study Recipes (No Project Needed)
Python — read the topic index in references/samples.md before answering "how do I build X".
Worked implementations exist for: sandboxed/per-user code execution, agent-loadable SKILL.md
skills, cross-session memory, approval gates before risky actions, tool guardrails, per-user
credentials, and scheduled/event-driven runs.
Go — read the upstream examples/.
clone the repo and read the one matching the capability you need before implementing it.
2. Prerequisites for Writing Code
Do NOT write agent code until a project is scaffolded.
- Verify project: run
agents-cli info(proceed if config exists). - New project: run
agents-cli scaffold create <name>— add--agent adk_gofor Go. - Existing code: run
agents-cli scaffold enhance ..
Quick Reference — Most Common Patterns
See references/adk-python.md and references/adk-go.md for Python and Go code examples, respectively.
References
Use the cheatsheets for common patterns. For deep knowledge, fetch the docs index or inspect the installed package.
| Reference | Language | When to read |
|---|---|---|
references/samples.md |
Python | Topic-indexed catalog of ADK reference recipes. Read in workflow Phase 1 — before scaffolding and before writing code — maps a capability to the recipe that implements it. |
references/adk-python.md |
Python | Core ADK API: Agent, tools, callbacks, plugins, state, artifacts, multi-agent systems, SequentialAgent / ParallelAgent / LoopAgent, custom BaseAgent, ManagedAgent (server-hosted first-party agents), A2A protocol, A2UI. Default for most agents. |
references/adk-python-workflows.md |
Python | Graph-based Workflow API (ADK Python 2.0): nodes, edges, fan-out/fan-in, HITL, parallel processing. Use when you need explicit graph topology. |
references/adk-go.md |
Go | Core ADK Go API: llmagent, tools, callbacks, plugins, state, artifacts, multi-agent systems, sequential/parallel/loop agents, custom agents, the runner, serving over HTTP, A2A protocol, and ambient triggers. Default for most agents. |
references/adk-go-workflows.md |
Go | Graph-based Workflow API: nodes, edges, fan-out/fan-in, HITL, parallel processing. Use when you need explicit graph topology. |
examples/ |
Go | Runnable upstream programs — the closest thing to a recipe catalog for Go. |
curl https://adk.dev/llms.txt |
Python | Docs index (every page title + URL). Fetch it, then WebFetch the specific page for anything beyond the cheatsheets. |
| Installed ADK package | Python | Exact signatures and symbols — inspect the source (see "Inspecting ADK Source Code" in references/adk-python.md). |
Related Skills
/google-agents-cli-workflow— Development workflow, coding guidelines, and operational rules/google-agents-cli-scaffold— Project creation and enhancement withagents-cli scaffold create/scaffold enhance/google-agents-cli-eval— Evaluation methodology, dataset schema, and the eval-fix loop/google-agents-cli-deploy— Deployment targets, CI/CD pipelines, and production workflows
Version History
- 91a20c1 Current 2026-09-22 09:41
- 5597738 2026-09-03 05:30
-
048578a
2026-08-27 18:24
模型配置示例从 gemini-3.6-flash 更新为 gemini-3.7-flash
- 66976f5 2026-08-19 20:40
- 5a306f8 2026-08-16 08:06
- c7a375f 2026-07-24 16:59
