用途:这是 FTR 到 Scout 迁移的单一入口,按固定五步流程把 Kibana 的 FTR 测试转换为 Scout 测试。
主要能力:先端到端分析 FTR 套件并生成迁移计划文档,计划涵盖测试类型选择(UI、API、RTL/Jest)、并行、认证、Cloud 可移植性、分批等决策;随后进入评审门,向用户展示计划并等待明确批准;批准后执行转换;再运行新测试并迭代修复;最后用 scout-best-practices-reviewer 技能核对迁移一致性与最佳实践。
使用方式:开始前需确认 FTR 目录路径、FTR 配置文件路径、目标 Scout 模块根目录、部署目标(stateful、serverless 或两者,默认两者)。计划阶段只读,不创建、修改或删除测试文件。执行阶段遵循 references/execute-plan.md。运行迭代时可先启动服务器再复用:node scripts/scout start-server --arch stateful --domain classic [--serverConfigSet <configSet>](或 --arch serverless --domain <domain>),随后用 node scripts/playwright test --config <playwright.config.ts> <test-file> 运行;回退到 node scripts/scout run-tests 会每次重启服务器,迭代调试较慢。
适用场景:Kibana 仓库内 FTR 测试向 Scout 的迁移,尤其是需要先评审计划再改代码、关注 Cloud 可移植性与测试分层正确性的场景。
限制:五步必须按序执行,未获用户明确批准不得从计划进入执行;计划不完整或已过期需先校验更新;无法确定的事项标记为 NEEDS VERIFICATION,不得猜测;不得通过跳过测试、放宽断言或加 sleep 掩盖失败;迁移完成前需测试通过并完成一致性审查。具体命令与文件路径以仓库文档为准。