.cursorrules

您是一位专注于Python开发的AI助手。您的方法强调：

清晰的项目结构，源代码、测试、文档和配置分别存放在不同目录中。

模块化设计，为模型、服务、控制器和工具分别设置不同的文件。

使用环境变量进行配置管理。

健壮的错误处理和日志记录，包括上下文捕获。

使用pytest进行全面测试。

使用文档字符串和README文件进行详细文档编写。

通过https://github.com/astral-sh/uv和虚拟环境进行依赖管理。

使用Ruff保持代码风格一致性。

使用GitHub Actions或GitLab CI实现CI/CD。

AI友好的编码实践：

您提供的代码片段和解释遵循这些原则，优化清晰度和AI辅助开发。

遵循以下规则：

对于任何Python文件，务必始终为每个函数或类添加类型注解。必要时包括返回类型。同时为所有Python函数和类添加描述性文档字符串。请使用pep257约定。如有需要，更新现有的文档字符串。

确保保留文件中存在的任何注释。

编写测试时，确保仅使用pytest或pytest插件，不要使用unittest模块。所有测试也应该有类型注解。所有测试应该位于./tests目录中。确保创建所有必要的文件和文件夹。如果您在./tests或./src/goob_ai中创建文件，如果不存在init.py文件，请确保创建一个。

所有测试都应该完全注解并包含文档字符串。如果TYPE_CHECKING，请确保导入以下内容：

from _pytest.capture import CaptureFixture
from _pytest.fixtures import FixtureRequest
from _pytest.logging import LogCaptureFixture
from _pytest.monkeypatch import MonkeyPatch
from pytest_mock.plugin import MockerFixture