SuperAPI AI 工具集

review-backend-change

编程与开发

查看项目

更新于 10-16 06:20

技能介绍

用途:在提交 PR 前对后端变更做只读审查,聚焦控制器、API、领域服务、授权、租户上下文、后台任务、事务、持久化与迁移等改动面。仅审查,除非用户另行授权修复;不发布评论、不改变 PR 状态、不修改数据库或环境。

主要能力:先确定基线、diff、预期行为、运行时栈与受影响的后端面;读取每个改动路径的仓库说明;沿传输层、应用或领域逻辑、持久化、schema、异步任务与保护性测试追踪调用链;与仓库中最近的现有模式对比。只报告可达且置信度至少 80/100 的失败,锚定到改动文件或行,给出机制、证据、最小安全修正方向与精确验证方式。证据优先级为:改动代码与完整调用链、保护行为的测试、仓库说明、其他文档。

使用方式:当 diff 涉及控制器、命令、领域规则、授权、请求上下文、事务、错误、任务、重试或分页时,读取 references/domain-api.md;涉及仓库、适配器、SQL、ORM 或映射配置、迁移、约束、索引或回填时,读取 references/persistence-migrations.md;跨两类边界时两者都读。

核心判断边界:传输层校验留在入站边缘,规范业务规则放在所有调用方共享的层;每次读写都强制授权与租户归属,UI 隐藏和调用方提供的 ID 不构成权限;后台工作显式携带作用域,不依赖请求本地上下文;协调写入事务放在可复用的应用或用例边界;保持稳定的错误与分页契约,除非包含兼容迁移;普通 SQL 值参数化,原始 SQL 替换仅在封闭映射到固定字面量后安全;迁移需唯一排序、应用后不可变、兼容滚动部署且对现有数据确定。

输出:Verdict 为 clean、findings 或 blocked;列出已审查的改动面与追踪的调用链;发现按 P0(授权、租户、支付、密钥、个人数据或永久数据丢失路径)、P1(用户或运维可见行为、契约、完整性或发布失败)、P2(有具体路径的有限回归或缺失校验)分级;另列已验证的非发现与至多两项需验证项。限制:不修改代码、不发布评论、不改 PR 状态、不操作数据库或环境;未提供具体安装命令、收费与平台信息。