adk-style

ADK 风格指南

适用于 src/google/adk/ 和 tests/unittests/ 的约定。大多数规则由 pre-commit 钩子或 CI 任务强制执行，因此违反规则会阻止 PR，而不是等到 代码审查时才发现。请阅读与你正在处理的主题对应的参考文档。

选择参考文档

任务	参考文档
添加 .py 文件；确定公开还是私有；__init__.py 和 __all__	visibility.md
编写 import 语句；相对导入与绝对导入；循环导入；TYPE_CHECKING；延迟导入	imports.md
标注参数和返回值；AgentMode 与原始模式字符串；_NodePathBuilder、_BranchPath 和 build_node；Optional 与 | None；仅限关键字参数；isinstance；断言；mypy；# type: ignore 和 cast	typing.md
定义 Pydantic 模型、验证器、私有属性或线上载荷	pydantic.md
缩进、行长、引号；运行格式化工具；各钩子的检查内容	formatting.md
编写文档字符串或说明性注释	documentation.md
输出日志记录；命名模块日志记录器；选择日志级别	logging.md
任何执行 I/O 的操作——网络、磁盘、数据库	async.md
新文件的存放位置；许可证标头；测试的存放位置及命名方式	file-organization.md
编写或重构单元测试；testing_utils 中的模拟对象	testing.md

检查失败——应查阅哪里

失败的检查	参考文档
check-new-py-prefix	visibility.md
compliance-checks	logging.md（日志记录器名称）、typing.md（from __future__ import annotations）、imports.md（cli/ 导入方向）
pyink、isort、ruff、addlicense、codespell	formatting.md
Mypy Check CI 任务	typing.md
tests/unittests/test_import_loading.py	imports.md