跳到正文
阿里雲開發者社區 AI·· 3 天前AI 評分37

基於 Playwright + Skills 實現網站操作手冊自動編寫實戰案例

基于 Playwright + Skills 实现网站操作手册自动编写实战案例

AI 導讀

作者基於 Playwright 封裝「網站操作手冊編寫」Skill,可按網站地址及產品資料規劃功能模組、探索頁面並截圖,再按統一模板輸出 Markdown 操作手冊。該 Skill 目前可覆蓋約 80%~90% 的常見業務場景,並會將未能探索的內容標示為「待補充」。操作手冊仍需人工或 AI 檢查及補充,才能逐步完善。

正文

2026-11-20 3

版权

版权声明:

本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写 侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

简介: 日常工作里,不少公司会把「产品操作手册」派给测试同学来写。 听起来只是文档活,但这个过程特别耗费人力:页面点击、流程步骤都要手动记录,或者产品改个入口,手册又得整章返工。 那么,能不能结合 UI 自动化工具 + AI ,让浏览器自己操作页面,同时同步生成一份结构统一的操作手册? 我这边做了个尝试: 基于 Playwright 封装了一套「网站操作手册编写」Skill 。当前大约能覆盖 80%~90% 的常见业务场景,日常写手册基本够用。今天给大家分享下思路。 * 方案思路介绍 核心能力一句话:给网站地址和产品信息,自动规划模块、浏览器探索截图,再按统一模板输出 Markdown 操作手册(含截

日常工作里,不少公司会把「产品操作手册」派给测试同学来写。

听起来只是文档活,但这个过程特别耗费人力:页面点击、流程步骤都要手动记录,或者产品改个入口,手册又得整章返工。

那么,能不能结合 UI 自动化工具 + AI,让浏览器自己操作页面,同时同步生成一份结构统一的操作手册?

我这边做了个尝试:基于 Playwright 封装了一套「网站操作手册编写」Skill。当前大约能覆盖 80%~90% 的常见业务场景,日常写手册基本够用。今天给大家分享下思路。

*

方案思路介绍

核心能力一句话:给网站地址和产品信息,自动规划模块、浏览器探索截图,再按统一模板输出 Markdown 操作手册(含截图资产)。

整体执行可以串成一条线:

 text
收集输入(网址 / 产品名等)
        ↓
规划探索(导航菜单 → 功能模块 → 截图清单)
        ↓
探索与截图(按需登录并保存状态)
        ↓
生成大纲(可确认,也可「直接生成」跳过)
        ↓
撰写手册(目的 → 操作 → 截图 → 预期结果)
        ↓
润色输出(Markdown + assets/ 截图目录 + 质量检查)

✅ 浏览器自动走页面:少做「边点边记」
✅ 章节结构模板化:目的 / 操作 / 截图 / 预期结果,写法统一
✅ 探索不到的标「待补充」:不硬编,方便人工补漏
✅ 输出可沉淀:Markdown 正文 + assets/ 截图,便于评审和二次排版

*

案例实践

1、Skill 安装

1. 准备好可用的 AI 编程环境(Cursor / Claude Code 等);

2. 安装并可用 Playwright(Skill 会驱动浏览器做探索与截图);

3. 将 Raina 提供的「网站操作手册编写」Skill 包导入到工具的 Skill 目录(如 .cursor/skills);

2、Skill 执行

输入信息:

/operation-manual

网站:xx

其他信息:xx

这里可以将你的网站、账号密码等信息输入给AI,如果担心安全问题的话,也可以只提供网站,然后自己输入帐号密码

3、AI执行过程

使用playwright cli打开界面,抓取快照,确定网站上有什么功能/元素,用于后续的操作网站

在获取可执行元素之后,使用playwtight cli指令,进行点击操作

对相关的页面进行截图,并保存到本地文件夹中,用于后续操作手册的编写

4、输出结果

  • 输出一份结构完整的操作手册 Markdown

分不同模块的大纲,包含功能说明、截图、操作步骤、预期结果

  • 按章节对应的截图资源目录

  • 常见问题统计

整理常见的问题,用于操作手册的讲解等

  • 附录

基本上完成了,当然由于业务信息的不充足,AI只会根据页面中元素做判断,然后写出一份基础的操作手册文档,我们也可以让AI录制视频,但是时间可能会比较长,我这里就不做演示了,大家如果需要的话,可以基于这个skill去做优化,让AI录制视频

小结

AI写的操作手册,不一定能够一次就满足我们想要的需求,可能有一些细节的内容没有进行补充,或者部分功能没有编写,这个时候,就需要我们人工做一些检查,或者可以让AI做检查,检查后,和AI二次对话,让其进行内容的补充,不断完善操作手册说明,达到真正实现效率的提升。

但是本skill也是能够一定的解放我们时间,希望能够帮助到你~

*

以上是今天分享的内容,相关 Skill 与详细教程已整理在【Raina的AI&测试实战圈】知识星球,里面还有很多测试全流程提效skill,附带详细教程,跟着步骤操作就可以上手。感兴趣的小伙伴可以加入了解哦~

來源:阿里雲開發者社區 AI · developer.aliyun.com