开发测试 185.7k 仓库 Star
Webapp Testing
实际点一遍关键页面和流程
网页交互验收是组织本地页面测试的 Skill。它指导 Agent 启动或连接开发服务,先观察页面状态,再用浏览器脚本操作按钮、导航和表单,检查日志并保存截图。适合功能做好后确认用户能否走通关键路径,也可用于复现界面异常。
你需要准备:本地网站启动方式或地址、需要验证的功能,以及测试用数据
一桉AI 整理 · 更新 · 查看 GitHub 来源
粘贴到 Codex,它会先检查安装条件,再引导你使用。
Webapp Testing 能帮你做什么?
准备可访问的测试页面
区分静态 HTML 和动态应用,按需要管理一个或多个本地服务,确认页面已具备操作条件。
观察后执行交互
先获取页面结构与可见元素,再选择定位方式,操作关键路径并等待对应结果。
留下可复查证据
保存失败步骤、截图和浏览器日志,说明哪些行为通过、失败或没有覆盖。
什么时候适合用?
下面是用法示例,可换成你的材料和目标。
检查新做的注册表单
例如分别输入有效与无效资料,核对错误提示、提交状态和跳转结果是否符合需求。
复现菜单无法点击
例如在相同页面尺寸下操作菜单,记录遮挡、控制台报错和触发顺序,方便开发定位。
怎么开始使用?
本地页面与测试任务
准备这些材料网页交互验收
本地网站启动方式或地址、需要验证的功能,以及测试用数据
网页交互验收流程
- 01
启动服务并确认可访问
- 02
操作关键交互并记录
- 03
整理截图和问题证据
准备什么,会得到什么?
- 准备的材料
- 本地网站启动方式或地址、需要验证的功能,以及测试用数据
- 交付的结果
- 覆盖指定页面和交互的测试脚本或执行记录。
- 截图、错误日志、失败复现步骤与覆盖范围说明。
使用前要知道
需要 Python、Playwright、浏览器和完整辅助脚本,目标页面必须可访问。上游面向 Claude,Codex 需映射实际执行工具;检查几个路径不能代表全部业务已验收。
常见问题
和 Playwright CLI 有什么区别?
这里主要提供用 Python 脚本组织网页验收的流程,并有本地服务辅助脚本。CLI 条目主要介绍通过命令行直接操作浏览器。
发现页面问题后会自动修好吗?
默认产物是可复现的问题与证据。修复还需要结合项目源码、需求和当前授权安排,不能把一次页面检查当作修复已经完成。
GitHub 与官方参考
依据项目说明与参考文档整理。页面中的任务与流程示例用于说明用法。
- webapp-testing · SKILL.md ↗2026-10-31 核对
来源与使用条件
- 原始项目
- anthropics/skills ↗
- Skill 名称
webapp-testing- Skill 目录
skills/webapp-testing- 仓库 Star
- 185,700 · 2026-10-31 核对,仅代表仓库关注度。
- 许可说明
- Apache-2.0
- 使用条件
- 需要 Python、Playwright 和浏览器。完整保留 scripts/with_server.py 等辅助资源,用于管理一个或多个本地服务;目标页面必须可访问。
- 注意事项
- 与现有 Playwright CLI 的操作入口互补,此项提供网页测试组织流程。上游面向 Claude,Codex 可执行通用 Python 脚本;不代表所有业务路径已经覆盖,本站未运行实测。
查看安装与使用提示词
请帮我准备并使用 Webapp Testing Skill,完成下面的任务。请实际执行当前环境允许的安装与检查,不要只返回一份安装教程。
【来源与目标】
原始仓库:https://github.com/anthropics/skills
所选目录:skills/webapp-testing
参考分支:main
原始目录 frontmatter name:webapp-testing
安装后的目标调用名:webapp-testing
来源页面:https://github.com/anthropics/skills/tree/main/skills/webapp-testing
安装路线核对日期:2026-11-01
webapp-testing:当前源 SKILL.md:https://github.com/anthropics/skills/blob/main/skills/webapp-testing/SKILL.md
anthropics/skills:当前安装说明:https://github.com/anthropics/skills/blob/main/README.md
OpenAI:Build skills(Skill目录、发现和插件):https://learn.chatgpt.com/docs/build-skills
【先检查环境,再安装】
先识别操作系统、当前 shell、工作目录、同名 Skill 和已有工具;命令须适配实际平台并正确处理带空格的路径。默认安装到当前项目的 .agents/skills;如果没有可用项目目录,再使用用户目录的 .agents/skills。遵循当前 Codex 实际支持的位置;上游 CLI 或插件有专用目录时使用其正式方案。检查现有安装来源与完整性,能复用就复用,不重复注册相同来源、不覆盖用户修改。系统内置与所选第三方来源同名时保留系统版,明确区分来源和实际目录,不能只凭名称认定装过或选对了。
下文 ~/.agents/skills 是用户级路径示例;已选项目范围时,使用项目的 .agents/skills 并保持相同子目录层级。<SKILL_DIR>、<项目根目录> 等占位符须先换成核对过的真实路径再执行。依赖仓库的存放目录与 Codex 发现入口分别处理,不把缓存目录当作已注册入口。
这是完整目录安装路线。优先使用当前 Codex 自带的 $skill-installer,明确传入仓库 anthropics/skills、目录 skills/webapp-testing、分支 main、安装名 webapp-testing,并把 --dest 设为已解析的目标 .agents/skills 绝对路径。目录为“.”时表示仓库根目录,仍要传入安装名。不要猜测安装器在本机的固定路径。如果没有内置安装器,按下列项目说明从原仓库获取完整目录,保留全部配套文件。
所选 Skill 的具体安装步骤:
1. 先定位用户要使用的项目根目录,并检查项目与用户目录中是否已有同名 Skill;发现已有版本先比较来源和内容,不覆盖,也不删除系统或插件缓存。
2. 调用系统 skill-installer 的 scripts/install-skill-from-github.py,参数明确为 --repo anthropics/skills --path skills/webapp-testing --ref main --name webapp-testing --dest <项目根目录>/.agents/skills。--dest 是所有 Skill 的父目录,不是 SKILL.md 文件路径。
3. 安装整个所选目录,保留以下 resources 列出的脚本、参考资料和资产;检查相对路径引用,不只下载一份 SKILL.md。
4. 在该项目中查看 Skill 列表,并用 $webapp-testing 显式选择;Codex 会自动检测目录变化,尚未出现时再开新聊天或重新加载。
必须保留的资源:
- skills/webapp-testing/SKILL.md 与 LICENSE.txt
- skills/webapp-testing/scripts/(尤其 with_server.py)
- skills/webapp-testing/examples/(element_discovery.py、static_html_automation.py、console_logging.py 等)
已知依赖:需要 Python、Playwright 和浏览器。完整保留 scripts/with_server.py 等辅助资源,用于管理一个或多个本地服务;目标页面必须可访问。
原项目许可:Apache-2.0
特别条件:与现有 Playwright CLI 的操作入口互补,此项提供网页测试组织流程。上游面向 Claude,Codex 可执行通用 Python 脚本;不代表所有业务路径已经覆盖,本站未运行实测。
需要账号、密钥或服务时先检查现有可用连接;让用户在官方授权或本地配置入口完成,不要求把密钥粘贴到聊天。缺少付费服务或不支持的客户端能力时,明确剩余条件与可完成的范围。
【安装后验收】
读取实际安装位置的 SKILL.md,核对真实 name,并检查它引用的脚本、模板、共享文件与工具是否存在。若上游已迁移路径或更名,先核对正式说明再调整;找不到则报告实际错误,不猜路径或宣称成功。
1. 核对 scripts/with_server.py、examples/ 与许可证文件存在。
2. 检查 python --version,以 importlib.util.find_spec('playwright') 等方式只读确认 Python Playwright 包;浏览器二进制另检查已有安装路径,不自动下载。
3. 可运行 python <安装目录>/scripts/with_server.py --help 查看参数;不启动用户服务、不打开浏览器或提交表单来验收安装。
Codex 通常自动发现变更;只有未出现时才引导新建聊天或重载。若本轮尚未出现在可用列表,可在允许的范围内读取已安装的完整文件继续准备任务,同时说明自动识别尚待确认。插件依赖的工具未连接时,不能用读取文件代替连接成功。
分别报告“文件已安装”“Codex 已识别”“任务所需能力已就绪”的实际状态和证据;失败时给出卡住的步骤、错误与下一步,不反复执行相同的失败命令。
【接着引导我使用】
请使用实际可用的 $webapp-testing;若实际名称发生变化,以刚核对的本地 name 为准。存在不同来源同名项时,明确选择所选来源与实际文件路径,避免调用成系统版或另一版本。对于必须由用户显式调用的 Skill,直接给我下一条可复制的调用语句。
- 提供已授权页面 URL,或本地启动命令/端口,以及希望检查的真实流程和可用测试数据。
- 实际测试时使用当前 Python Playwright 环境与 with_server.py 管理所需服务,先观察渲染后页面再交互;记录真正执行过的检查和截图。
我想完成的任务:
检查我指定的本地网页及关键交互。确认服务可访问后,使用测试数据操作导航、按钮和表单,查看控制台与失败请求,并截图记录发现的问题。先复现并给出步骤和证据,区分已验证、失败和没有覆盖的功能。
需要我提供的材料:
本地网站启动方式或地址、需要验证的功能,以及测试用数据
期望得到:
一份网页验收记录,包含检查过的地址、操作步骤、截图、错误和覆盖范围。
先查看我在当前聊天中已经提供的目标与材料,只问缺少的关键内容;没有材料时,告诉我第一步提供什么,可给一个简短示例。条件满足后从一个小任务开始,检查输出,再说明怎样继续使用。示例仅用于演示,不充当我的真实数据;没有执行过的步骤、测试或交付物不要写成已经完成。需要发送、发布或修改外部账号内容时,先让我核对具体对象和内容。