SuperAPI AI 工具集

production-readiness-review

编程与开发

查看项目

更新于 10-15 21:35

技能介绍

用途:在实现后端服务层或 API 变更后、提交前,评估其生产就绪程度,覆盖可观测性、可靠性、数据完整性与数据库性能。仅前端变更可豁免。

主要能力:按 12 项标准各打 0-2 分(可观测性 8 分、可靠性 8 分、数据完整性 4 分、数据库性能 4 分,共 24 分),每项评分必须有 file:line 证据,否则记 0。总分 19-24 为 PASS,13-18 为 NEEDS WORK,0-12 为 NOT READY。另设 8 项通过/不通过的 SRE 就绪门禁(发布与回滚、健康检查、告警与运行手册、SLO/错误预算、容量与资源限制、配置与密钥、优雅启停、并发与幂等),门禁不计入 24 分,但未获接受的 CRITICAL/HIGH 失败会阻止 PASS。数据库性能协议为强制项:所有列表查询必须分页,所有过滤字段、外键与排序列必须有索引。

使用方式:先解析范围(参数指定文件,否则用 git diff --name-only 取未提交变更,仅后端服务/API 文件);再逐项评分;然后执行 SRE 门禁;映射结论;若存在 graph.db,则运行 python .claude/scripts/code_graph graph-blast-radius --json、query tests_for <function_name> --json、trace <service-file> --direction downstream --json 做结构影响分析;对发现的问题先经 $why-review --validate-findings 验证,再修复并重新完整审查。部署上下文从 docs/project-config.json 的 infrastructure 段读取。

限制:结论为建议性,但图门禁、修复后完整复审与数据库性能协议不可跳过;批量处理(≥10 文件)时须基于跨批次证据整体重评 12 项标准,不可取平均。若某步骤或工具在当前环境无法运行,应停止并询问用户。技能中未提供具体收费、平台或效果信息。