技能包

Playwright Best Practices:按任务给 TypeScript 测试建议

适合要编写、调试或维护 TypeScript Playwright 测试的人;用官方 npx 安装后直接描述任务,先看建议再改代码。

官方来源 · Playwright Best Practices Skill

安装

npx skills add https://github.com/currents-dev/playwright-best-practices-skill

适合谁

这份指南面向正在用 TypeScript 编写、调试或维护 Playwright 测试,并希望智能体按当前活动给出针对性建议的人。官方把它写成活动驱动:你在做什么,它就指向对应参考,而不是一次装入全部材料。

仓库见

https://github.com/currents-dev/playwright-best-practices-skill

它适合仓库里已经有 Playwright 测试、你要修不稳定用例或补充无障碍测试的时候。材料写明不必说出技能名称或 “Playwright best practices”,把任务讲清楚即可。

它不适合主要写其他语言测试、或没有兼容技能安装机制的环境。现有材料只把指导范围写在 TypeScript 的 Playwright 测试上,不要据此推广到未写明的语言。

3 分钟完成第一次尝试

只走官方推荐的一条路径。

前置条件:本机可运行 npx,当前智能体兼容这种技能安装方式,并且工作区里有一份可讨论的 Playwright 测试。执行安装前,确认你要写入的是正在使用的智能体环境。

安装位置:由 npx skills add 自行处理。材料没有写出目标文件夹,不要手补未出现的路径。

复制并执行:

npx skills add https://github.com/currents-dev/playwright-best-practices-skill 

成功信号:命令正常结束。先做一次只读检查:打开一份登录相关测试,对智能体说「看一下这个不稳定的登录测试,先指出可能原因,不要改文件」。官方例子正是 “fix this flaky login test”。若回复引用了具体等待、定位或断言问题,而不是空泛重写,说明对应参考已被用到。

分析可接受后,你再明确授权它改哪个文件。改测试是有副作用的操作,确认范围之前不要让它直接打补丁。

使用案例

案例一:排查不稳定的登录测试。对应官方示例任务 “fix this flaky login test”。适合测试有时过、有时不过,你希望先得到聚焦建议。先描述现象和失败日志,要求只分析。成功时,回复应落到当前活动相关的参考,而不是把全部 57 篇文档一股脑倒出来。材料没有列出八个分类的名称,因此不要编造分类或文档文件名。真正修改测试前,先确认要动的文件和预期行为。

案例二:补充无障碍测试。对应官方示例 “add accessibility tests”。适合你已有页面流程,想加上无障碍检查。先让智能体根据当前页面测试列出建议断言,仍先不写文件。你确认选择器和覆盖范围后,再让它新增用例。成功信号是建议能对应你指定的页面,而不是通用模板。现有材料只证明可以按这个任务描述触发,没有展开具体 API 或配置项。

使用边界

现有材料只给出一条安装命令,以及「按活动指向参考」的用法。不要改用未出现的市场命令、克隆路径或其他安装器。材料也没有点名必须支持的客户端,不要把某几个智能体写成独家支持。

参考库规模是 57 篇、分成 8 类,但分类名称和单篇路径都没有写出来。不要发明文档路径或技能子目录。

它指导的是 TypeScript 里的 Playwright 测试写作、调试与维护。其他语言、或其他测试框架的步骤不能从现有材料补全。改测试会改仓库;先分析、再授权写入。更多说明以官方仓库为准:

https://github.com/currents-dev/playwright-best-practices-skill