SuperAPI AI 工具集

sre-review

编程与开发

查看项目

更新于 10-15 21:35

技能介绍

用途:在实现后端服务层或 API 变更后、提交代码前,评估其生产就绪度。仅前端变更可豁免。

主要能力:按四类共 12 项标准逐项打分(每项 0-2 分,满分 24)。可观测性(8 分):结构化日志、错误上下文、指标意识、关联 ID。可靠性(8 分):重试策略、超时配置、错误处理、降级行为。数据完整性(4 分):种子数据与迁移的区分、种子器幂等性。数据库性能(4 分):分页、数据库索引。评分结论:19-24 为 PASS,13-18 为 NEEDS WORK,0-12 为 NOT READY。

使用方式:参数指定文件或目录则审查这些文件,否则审查未提交变更(git diff --name-only),聚焦 src/Services/ 下的 *.cs、API 控制器与服务类,跳过前端、测试、文档和纯配置变更。每项评分必须给出 file:line 证据,无法证明的评分记 0。若存在 .code-graph/graph.db,需运行图命令辅助分析,例如 python .claude/scripts/code_graph connections <file> --json、graph-blast-radius --json、query tests_for <function_name> --json、trace <service-file> --direction downstream --json。第一轮发现问题后,第二轮须由无第一轮记忆的全新子代理重新审查。输出为固定格式的评分表、待解决缺口与建议。

适用场景:后端服务与 API 变更的提交前审查、跨服务影响与爆炸半径评估、测试覆盖核对。

限制:评分与结论为建议性质,不阻断提交,但图分析、第二轮审查和数据库性能协议等流程步骤为强制项;需先读取项目参考文档(如 docs/project-config.json、docs/project-reference/lessons.md、code-review-rules.md 等);若某步骤或工具在当前环境无法运行,须停止并询问用户。具体收费、平台支持等信息暂未提供。