メニュー
Set up a local development environment for the ADK Python project. Use when the user wants to get started developing, set up their environment, install dependencies, or prepare for contributing.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | adk-setup |
| description | Set up a local development environment for the ADK Python project. Use when the user wants to get started developing, set up their environment, install dependencies, or prepare for contributing. |
| disable-model-invocation | true |
Set up the local development environment for ADK Python 2.x.
Before selecting versions or commands, read ../../docs/python-adk-2.md.
Check the following before proceeding:
Python 3.10+
python3 --version
uv package manager (required — do not use pip/venv directly)
uv --version
If not installed:
curl -LsSf https://astral.sh/uv/install.sh | sh
Run these commands from the project root:
Create and activate a virtual environment:
uv venv --python "python3.12" ".venv"
source .venv/bin/activate
Install all dependencies for development:
uv sync --all-extras
For a new ADK app without a checked-in pyproject.toml, start from the current ADK 2.x package:
uv add "google-adk>=2.3.0,<3"
Install development tools:
uv tool install pre-commit
uv tool install tox --with tox-uv
Install addlicense (requires Go):
go version && go install github.com/google/addlicense@latest
[!NOTE] If Go is not installed, tell the user: "Go is required for the addlicense tool. Please install Go from https://go.dev/dl/ and then re-run the
adk-setupskill to complete the setup."
Set up pre-commit hooks:
pre-commit install
Verify everything works by running tests locally:
pytest tests/unittests -n auto
| Task | Command |
|---|---|
| Run unit tests (Fast) | pytest tests/unittests |
| Run tests across all Python versions | tox |
| Format codebase | pre-commit run --all-files |
| Run tests in parallel | pytest tests/unittests -n auto |
| Run specific test file | pytest tests/unittests/agents/test_llm_agent.py |
| Launch web UI | adk web path/to/agents_dir |
| Run agent via CLI | adk run path/to/my_agent |
| Build wheel | uv build |
ADK Agent-to-Agent (A2A) protocol expert covering remote agent communication, agent cards, HTTP-based delegation, and distributed agent systems. Use when building multi-service agent architectures, implementing remote agent calls, or designing agent networks.
ADK memory + embeddings across databases. Generate multimodal embeddings with gemini-embedding-2, persist agent sessions/memory to Cloud SQL, Postgres, Firestore, or SQLite, and store/retrieve vectors for RAG (pgvector, Firestore vector). Use when choosing a session/memory backend, wiring a database SessionService or MemoryService, generating embeddings, or building a vector store for retrieval on an ADK agent.
Migrate ADK agents from 1.x to 2.3. Covers breaking API changes (graph Workflow vs GraphAgent, McpToolset, BuiltInCodeExecutor, ctx.resume_inputs, agent modes), renamed imports, deploy CLI changes, model/thinking/embedding updates, and session/state incompatibility. Use when upgrading an ADK 1.x codebase to 2.3, auditing code for deprecated 1.x APIs, or resolving 2.3 import/attribute errors.
ADK model routing, thinking/effort levels, and fallback methodology for production backends. Covers the current Gemini 3.x model catalog (gemini-3.5-flash, gemini-3.1-flash-lite, gemini-3.1-pro-preview, gemini-3.1-flash-live-preview, gemini-embedding-2), thinking_level effort tiers (minimal/low/medium/high), deprecation of thinking_budget and sampling params, and primary→fallback chains. Use when selecting a model, tuning thinking/effort, routing by task complexity/cost, or designing model fallback for an ADK agent.
Central hub for building, testing, and iterating on ADK agents. Trigger this skill when the user wants to create a new agent, configure modes (task, single-turn), or build graph-based workflows.
DAG-based ADK workflow in Go using graph pattern. Use for Go backends needing multi-step agent pipelines.