SuperAPI AI 工具集

scout-best-practices-reviewer

编程与开发

查看项目

更新于 10-15 21:37

技能介绍

用途:对 Scout UI 与 API 测试文件(*.spec.ts)做静态 PR 审查,对照 Scout 最佳实践与既有抽象(fixtures、page objects、API helpers),推动复用而非一次性实现。部分解决方案可扩展该技能,先跑通用审查再应用方案专属检查。除非明确要求,不要发布 GitHub 评论。

输入:变更的 *.spec.ts 及导入的 helpers/fixtures;UI 测试用 test/spaceTest(通常在 /test/scout/ui/),API 测试用 apiTest(通常在 /test/scout/api/);同插件/方案内相邻 Scout 代码;迁移时被移除的旧测试;相关 Scout 文档(通用最佳实践必读,UI/API 按类型选读)。

关键检查(按序逐条):1) 自定义服务端配置是否必要,可运行时切换的应改用 apiServices.core.settings(...);2) spec 是否放在选择性测试会执行的位置,驱动其他插件 UI 的应移到归属插件;3) 测试类型是否恰当且充分论证;4) 迁移对等性,重大覆盖缺失按 blocker 处理;5) 是否假设或泄漏共享服务器状态(固定资源名、固定时间窗、未还原设置等)。

范围与清单:不限于 diff,扫描同区域既有 spec、可用 fixtures、page objects 与 API services;清单覆盖复用优先、无用常量、绕过 linter、fixture 边界、正确性断言、UI 范围、page objects、隔离与清理、共享环境、RBAC、flake 陷阱、成本、全局 teardown、标签与环境。跳过 .meta 清单文件。

严重级别:Blocker、Major、Minor、Nit,存疑时取较低级别。迁移对等性分析仅在需要行动时输出。另含 Kibana/EUI 组件模式注意事项(如 QueryStringInput 用 pressSequentially()、EuiBasicTable 空状态断言、EUI 内部 CSS 类选择器、EUI Test Objects 等)。输出格式由调用方决定,本地调用用 OUTPUT.md 默认格式,并可提议生成改进后的代码。