用途：为 Agent Framework 的 Python 代码库提供代码质量检查，包括语法格式化、Lint 与类型检查，适用于运行检查、修复 Lint 错误等场景。所有命令需在 python/ 目录下执行。
主要能力与用法：语法格式化与检查使用 uv run poe syntax，可用 -P core 指定包、-F 仅格式化、-C 仅检查、-S 仅示例。类型检查方面，Pyright（strict）负责源码，Pyright（relaxed basic）、mypy、pyrefly、ty、zuban 检查测试，pyright/pyrefly/ty 还检查示例。常用命令：uv run poe pyright、uv run poe test-typing、uv run poe mypy、uv run poe typing；全量检查用 uv run poe check，包级并行检查用 uv run poe check-packages，Markdown 代码块检查用 uv run poe markdown-code-lint。
提交钩子：prek 钩子在提交时自动运行，仅检查变更文件。安装用 uv run poe prek-install，手动运行用 uv run --group tool-hooks prek run -a 或 --last-commit。默认不运行工作区 pyright 或 mypy。
配置与限制：Ruff 行宽 120、目标 Python 3.10+、启用自动修复，规则含 ASYNC、B、CPY、D、E、ERA、F、FIX、I、INP、ISC、Q、RET、RSE、RUF、SIM、T20、TD、W、T100、S，scripts 目录排除检查。Pyright 源码为 strict 模式并启用 reportUnnecessaryTypeIgnoreComment，排除 tests、samples、.venv、packages/devui/frontend。任务运行器 scripts/task_runner.py 使用 ThreadPoolExecutor 并行执行包与任务组合。CI 分为 4 个并行作业：pre-commit 钩子、包检查、示例与 Markdown、测试类型检查。Poe 与 pytest 工具链位于跨版本开发环境，Ruff 与类型检查器使用固定的 tooling/requirements-*.txt 文件。