用途:当用户要求评审、分析或改进 src/backend/ 下的后端代码(如 .py)时使用。支持三种模式——待提交变更评审(查看暂存区/工作区文件)、代码片段评审(粘贴函数/类/模块片段)、指定文件评审(一个或少量明确文件)。不适用场景:前端代码或 UI(如 .tsx、.ts、.js、src/frontend/);非评审类请求;范围不在 src/backend/ 下(除非用户明确要求评审 src/backend/ 之外的后端相关变更)。
主要能力:按 Checklist 规则评审,无匹配规则时回退到通用评审规则。Checklist 覆盖数据库 schema 设计(models 目录与 Alembic 迁移)、架构(路由/服务/模型分层、依赖方向、职责划分)、服务抽象(表/模型操作应位于 services 下的 service 中)、SQLAlchemy 模式(会话/查询、事务/CRUD、session_scope()、原生 SQL)。通用规则检查安全(SQL 注入、SSRF、命令注入、不安全反序列化、硬编码密钥、认证授权缺失、越权、路径遍历)、性能(N+1 查询、缺失索引、内存泄漏、异步中阻塞操作、缓存、大结果集分页)、代码质量(Python 3.10-3.13 兼容、重复、函数过大、深层嵌套、魔法值、命名、错误处理、类型覆盖、联合类型语法、TYPE_CHECKING、FastAPI 依赖注解、Google 风格 docstring、SOLID/YAGNI、行宽 120)、文件结构(生产文件约 500 行、测试文件约 1000 行上限、单一职责、禁止 utils.py 等通用命名)、测试(覆盖率目标 80%、最低 75%、异步测试标记、反模式、边界与错误用例)、可观测性(使用 lfx 异步 logger 的 a 前缀方法、日志级别、禁止 print、零 PII)、提交前验证(make format_backend、make lint、make unit_tests)。
使用方式:先判断评审模式,保持范围紧凑,仅评审用户提供或明确引用的内容;按 Checklist 规则执行,无匹配规则时使用通用评审规则;输出严格遵循 Required Output Format 模板 A(有发现,分 Critical/Suggestions/Nits/What's Good,超过 10 条则汇总并只输出前 10 条)或模板 B(无问题,输出 至 No issues found)。始终给出可操作修复建议(可含代码片段);有文件路径与行号时用 File:Line 引用,否则使用最具体的标识。
限制:仅面向 Langflow 仓库的后端目录结构;引用规则文件(references 下的 md)与项目工具链(Ruff、MyPy、pytest、Makefile)属特定仓库约定;需代码变更时在结构化输出后追加一条简短追问,询问是否应用建议修复。其余功能细节资料未提供。