playwright-pom-agent-skills
一个基于Playwright和TypeScript的UI与API自动化测试框架，集成了AI助手指导。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：playwright-pom-agent-skills。 它的用途是：一个基于Playwright和TypeScript的UI与API自动化测试框架，集成了AI助手指导。 完整的 Skill 内容见：https://321skill.com/skills/playwright-pom-agent-skills/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我为登录页面写一个Playwright测试用例。”，它会引导你遵循框架的Page Object Model规范，在`ui/pages/`下创建页面对象，并在`ui/specs/`下编写结构清晰的测试文件。或者，
对AI说：“我的API测试报错了，如何调试？”，它可以参考AGENTS.md中的框架规则，建议你检查共享夹具中的认证状态或服务类的请求构造方式。
介绍
这个仓库提供了一个结构化的自动化测试框架，旨在解决UI和API测试中代码重复、维护困难以及团队协作标准不统一的问题。它通过Page Object Model（POM）模式管理UI元素，通过服务类封装API调用，并提供了共享的测试夹具（fixtures）来管理浏览器会话和API认证状态，从而提升测试代码的可读性和复用性。
使用方式非常直接：克隆仓库、安装依赖后，即可运行预设的测试脚本。框架内置了丰富的npm脚本，支持分别运行UI测试、API测试、调试模式，以及代码质量检查（如linting、typechecking）和格式化。用户只需确保被测应用已启动，并在配置文件中正确设置URL即可开始测试。
该框架非常适合需要建立或优化自动化测试流程的测试工程师、全栈开发者和DevOps工程师。它提供了清晰的代码结构和规范，有助于团队快速上手并保持代码风格一致。对于希望将AI助手（如Hermes Agent）集成到开发工作流中，以获取框架特定指导的开发者来说，此仓库也提供了原生支持。
使用建议是，在修改测试代码后运行npm test进行验证；如果更改了配置文件（如URL或凭证），建议重新运行npm run test:list和npm test以确保配置生效。需要注意的是，框架本身不包含被测应用，运行前需自行部署并配置好对应的测试环境。
核心特点
与同类测试框架相比，它原生集成了AI助手指导（通过AGENTS.md和本地skills），为框架的使用、规则和变更提供了智能化的上下文支持；同时，它严格实施了基于角色的共享夹具设计和统一的代码质量工具链，确保了从测试编写到维护的全流程规范性。
注意事项
该框架本身不包含被测应用程序，需要用户自行准备并运行待测系统。
常见问题
运行测试前需要准备什么？
需要确保目标应用程序已经启动，并且config/test-config.json中的URL配置正确。
如何集成Hermes Agent来获得AI指导？
安装Hermes Agent后，在项目根目录运行`hermes`命令，它会自动加载AGENTS.md；还可以配置外部skills目录来加载更详细的框架技能。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/playwright-pom-agent-skills/raw/index.md 读取 playwright-pom-agent-skills 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/playwright-pom-agent-skills/raw/index.md（查看排版版本）