メニュー
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.
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.11" ".venv"
source .venv/bin/activate
Install all dependencies for development:
uv sync --all-extras
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 |
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.
Author new samples for the ADK Python repository. Use this skill when the user wants to create a new sample demonstrating a feature or agent pattern (e.g., dynamic nodes, standalone agents, fan-out/fan-in) or when adding examples to subdirectories under `contributing/`.
Creates or updates code unit design documents for source code documentation.
Creates detailed code unit guides for source code documentation.
Reviews all local changes in the repository for errors, styling compliance, unintended outcomes, and necessary documentation/test/sample updates. Generates a report and assists in fixing identified issues on-demand. Triggers on "adk-review", "review changes", "pr review", "check code style", "verify changes".
ADK development style guide for routine nits — Python idioms, codebase conventions, imports, typing, Pydantic patterns, formatting, logging, async/concurrency, and file organization. Use this skill whenever writing code, tests, or reviewing PRs for the ADK project to ensure compliance with styling and coding conventions. Triggers on "code style", "how should I format", "naming convention", "lint", "nit", "imports", "typing", "Pydantic patterns", "testing rules", "async", "io".