用途:把 Markdown 测试计划转换为 WebdriverIO 测试骨架,可新建 spec 文件,也可向已有 spec 追加套件、测试与钩子。产出真实的 describe/it/hook 块、可读测试名称,以及每步 setup、action、assertion 的伪代码注释。
主要能力:解析计划中的章节与场景,映射为主要 describe 嵌套块,将 setup/teardown 放入最窄的合适 hook,生成句子式命名的 it,并按执行顺序写伪代码。输出为合法 JavaScript/TypeScript 结构,保留已有实现代码;新增脚手架插入合适套件/上下文。伪代码采用祈使动词(如 // Click ...、// Assert ...),每行原子化、实现中立、不写选择器语法,保留计划中的业务术语。
使用方式:需先准备 Markdown 测试计划路径、目标 spec 文件路径(新建或已存在)、已有套件约定(Mocha/Jasmine 风格、命名、hooks)。生成前应读取项目缓存文件:.webdriverio-skills/project-context.md、project-context.json、custom-rules.md,以及 references/website-analysis/<target>/website-analysis.md 与 .json;<target> 用小写站点主机名,未知则用 unknown-target。文件缺失或过期时先运行 managing-project-customizations。测试层级优先选能可靠证明行为的最低层:组件级测独立 UI、UI 集成测带 mock 后端的前端流程、E2E 只覆盖少量高价值业务路径。默认小范围、独立测试,避免顺序依赖;准备前置条件优先用 API/状态而非纯 UI。
适用场景:已有测试计划需要快速一致的脚手架;向已有 spec 追加新测试章节;把结构决策与实现细节分离;作为 writing-webdriverio-code 的交接文件。
限制:本技能不生成具体选择器、WDIO 命令、等待或断言;不修复不稳定运行时行为(应使用 writing-webdriverio-code);不适合对已实现测试逻辑做小修改。常见错误包括在脚手架注释中写 WDIO 命令、覆盖或重构无关已有测试、全局 setup 放入每个测试而非 hooks、使用 should work 等模糊名称、在伪代码中编码选择器细节。资料未提供收费、价格与平台信息。