用途:按照项目 AGENTS.md 中的约定,对代码改动进行合规审查,主要面向后端 Python 代码。
主要能力:先确定审查范围,然后逐文件对照检查清单。范围判定方式:在功能分支上使用 git diff main...HEAD 查看相对 main 的全部改动;审查已暂存改动使用 git diff --cached;用户指定文件则直接审查;仅列出改动文件路径使用 git diff main...HEAD --name-only。检查项包括 Pydantic v2 语法、仓储与服务的分层、类型注解、导入位置与错误处理。发现违规时按指定格式报告文件路径、行号、问题描述、当前代码与应改写法,并对符合规范的模式给出简短肯定。最后汇总违规总数、按类别分布和总体结论(PASS / NEEDS FIXES)。
后端检查要点:Pydantic 使用 v2 写法,如 model_config = ConfigDict(...)、from_attributes=True、field_validator、model_validator、json_schema_extra、model_dump、model_dump_json、model_validate、model_validate_json、Field(pattern=...)。仓储层 app/repositories/ 只做数据库操作,输入输出仅用 SQLAlchemy 模型,不写业务逻辑、校验或外部 API 调用。服务层 app/services/ 承载全部业务逻辑,不直接操作数据库,而是调用仓储,并协调外部 API 与其他服务。类型注解为必填项,使用 Python 3.10+ 写法,如 X | None、list[X]、dict[K, V]。导入必须位于模块顶部,不允许函数内惰性导入。错误处理建议在服务方法中使用 raise_404=True,让异常传播到全局处理器,后台任务中捕获异常使用 log_and_capture_error。
适用场景:提交前或评审功能分支、暂存改动、指定文件时,快速检查项目约定合规性。
限制:资料仅给出上述规则,未提供安装方式、运行命令、适用语言以外的平台信息或收费说明。