chore: import upstream snapshot with attribution

2026-07-13 13:25:13 +08:00
commit ec2b666284
2231 changed files with 491535 additions and 0 deletions
@@ -0,0 +1,28 @@
+## Project Overview
+
+The Agent Development Kit (ADK) is an open-source, code-first Python toolkit for building, evaluating, and deploying sophisticated AI agents.
+
+### Key Components
+
+- **Agent**: Blueprint defining identity, instructions, and tools.
+- **Runner**: Stateless execution engine that orchestrates agent execution.
+- **Tool**: Functions/capabilities agents can call.
+- **Session**: Conversation state management.
+- **Memory**: Long-term recall across sessions.
+- **Workflow** (ADK 2.0): Graph-based orchestration of complex, multi-step agent interactions.
+- **BaseNode** (ADK 2.0): Contract for all nodes, supporting output streaming and human-in-the-loop steps.
+- **Context** (ADK 2.0): Holds execution state and telemetry context mapped 1:1 to nodes.
+
+For details on how the Runner works and the invocation lifecycle, please refer to the `adk-architecture` skill and the referenced documentation therein.
+
+## ADK Knowledge, Architecture, and Style
+
+Skills related to ADK development are in `.agents/skills/`.
+
+## Project Architecture
+
+For detailed architecture patterns, component descriptions, and core interfaces, please refer to the **`adk-architecture`** skill at `.agents/skills/adk-architecture/SKILL.md`.
+
+## Development Setup
+
+The project uses `uv` for package management and Python 3.10+. Please refer to the **`adk-setup`** skill at `.agents/skills/adk-setup/SKILL.md` for detailed instructions.