用途：把伪代码脚手架或已有 WebdriverIO 规范文件，转换为可维护的 WDIO 实现，或为现有测试补充场景、重构、修 bug。不适用于从测试计划搭建整套结构、仅调整 describe/it 层级、或制定整体测试策略。
主要能力：按执行顺序实现伪代码注释；优先复用已有页面对象方法；使用用户可见选择器（button=...、aria/...）、必要时用 data-testid；以自动等待处理交互，以 waitForDisplayed、waitForClickable、waitUntil 等待状态变化，不用 browser.pause 做同步。断言使用 expect-webdriverio 匹配器（toHaveText、toBeDisplayed、toHaveUrlContaining 等）。要求套件启动时重置 cookies、本地存储、会话/认证状态，测试数据通过 API/fixture 确定性创建并清理，测试独立、可并行。
使用方式：实现前读取项目缓存文件 .webdriverio-skills/project-context.md、project-context.json、custom-rules.md、health-recommendations.md，以及 references/website-analysis/<target>/website-analysis.md 与 .json；文件缺失或过期时先运行 managing-project-customizations。以这些文件作为约定、脚本、环境与团队规则的默认来源。常用写法：await browser.url('/path')、await el.click()、await el.setValue(...)、await expect(el).toBeDisplayed()、await el.waitForDisplayed() 或 browser.waitUntil(...)。
适用场景：脚手架转实现、已有测试扩展与修复、不稳定测试排查。
限制：不编造项目约定；不硬编码密钥，输入凭据用 setValue(..., { mask: true })，避免日志泄露；不对第三方依赖内部做断言，应做桩或只验证自身契约；.only/.skip 仅本地调试，提交前移除；重试不能替代根因修复。