SuperAPI AI 工具集

backend-review

编程与开发

查看项目

更新于 10-15 23:45

技能介绍

用途:在代码构建完成后审查后端实现(diff/分支),对照契约与 LLD 做只读检查,不修改代码,只返回证据与建议,由人工决定修复。

主要能力:按清单覆盖安全(每个端点的授权、输入校验与边界、注入、输出编码、代码/日志中的密钥、PII、安全反序列化、SSRF)、契约一致性(端点/DTO/错误结构/状态码完全匹配,破坏性变更需显式标记)、正确性与并发(事务、竞态/隔离、幂等)、向后兼容(增量式,无版本与迁移不得删除/改类型/收紧校验)、限流与滥用(配额、分页与载荷上限、超时、429 语义)、性能与扩展(避免 N+1 与无界查询、新路径索引、缓存/连接池)、数据与迁移(expand→migrate→contract、可回滚、避免在线长锁、回填)、测试缺口、可观测性。

使用方式:先界定 diff 范围,识别变更文件、新端点、迁移及其影响面;将 diff 与 .maestro/<slug>/openapi.yaml 及 LLD 对齐;逐维度做有证据的深度检查,可在支持时通过 Task 工具启动新的只读子代理(如 Claude Code),否则内联执行;按严重度汇总并判定是否阻塞;写入 .maestro/<slug>/backend/reviews/summary.md 并返回 review_path 与 blocking。发现格式含 severity、area、file、evidence、recommendation、safe_for_ai_fix、blocking。

适用场景:后端功能或分支合并前的审查、契约与迁移风险检查。

限制:只读,绝不编辑代码;授权/权限或契约变更永远不标记为 safe_for_ai_fix,需升级处理;阻塞结果会回到后端实现者,最多 3 次。外部技能通过 skills.config.yaml 的 review.external 配置(默认 requesting-code-review 或 none),不得缩小上述清单。其他细节暂未提供。