内容
# 🏃 Rode Runner — Playwright 及 GitHub Copilot 智能代理工作坊
> **目标人群：** 具备基本 JavaScript 知识的开发者和 QA 工程师
> **时长：** 约 3–4 小时
> **开始前：** 只需 `src/` 文件夹，包含游戏源代码
---
## 您将构建的内容
从一个空白的游戏源代码 (`src/`) 开始，您将：
1. 从零开始搭建一个 Playwright 项目
2. 配置 **Playwright MCP** 服务器，以便 GitHub Copilot 可以控制真实的浏览器
3. 构建 **自定义 GitHub Copilot 智能代理**，探索应用程序，生成测试场景，并编写完整的测试套件
4. 运行这些测试并查看 HTML 报告
到最后，您将拥有一个完全自动化的测试流程 — 几乎全部由您指导的 AI 智能代理构建。
---
## 工作坊模块
| 模块 | 文件 | 时间 |
|--------|------|------|
| 00 — 前提条件与工具准备 | [00-prerequisites.md](workshops/00-prerequisites.md) | 20 分钟 |
| 01 — 项目设置 | [01-project-setup.md](workshops/01-project-setup.md) | 20 分钟 |
| 02 — 使用 Copilot 智能代理探索应用程序 | [02-explore-with-agent.md](workshops/02-explore-with-agent.md) | 30 分钟 |
| 03 — 使用自定义智能代理生成测试场景 | [03-generate-scenarios.md](workshops/03-generate-scenarios.md) | 40 分钟 |
| 04 — 使用自定义智能代理生成测试套件 | [04-generate-test-suites.md](workshops/04-generate-test-suites.md) | 50 分钟 |
| 05 — 运行与报告 | [05-run-and-report.md](workshops/05-run-and-report.md) | 20 分钟 |
---
## 智能代理提示文件
预建的智能代理提示位于 `workshops/agents/` 目录中。您可以在 Copilot Chat 中粘贴或附加它们。
| 提示 | 目的 |
|--------|---------|
| [01-explore-agent.md](./agents/01-explore-agent.md) | 实时导航游戏并映射所有可测试的行为 |
| [02-scenario-agent.md](./agents/02-scenario-agent.md) | 生成结构化的测试场景文档（暂无代码） |
| [03-test-generator-agent.md](./agents/03-test-generator-agent.md) | 将场景转换为可运行的 Playwright `.spec.js` 文件 |
| [04-report-analyzer-agent.md](./agents/04-report-analyzer-agent.md) | 在测试运行后对失败情况进行分类 |
---
## 您将创建的文件夹结构
```
（项目根目录）
├── src/ ← 已提供 — 游戏源代码（请勿修改）
│ ├── index.html
│ ├── styles.css
│ └── game.js
│
├── tests/ ← 您需要创建此目录
│ ├── helpers/
│ │ └── GamePage.js ← 页面对象模型助手
│ ├── positive.spec.js
│ ├── negative.spec.js
│ ├── edge-cases.spec.js
│ └── agent-generated.spec.js
│
├── .vscode/
│ └── mcp.json ← Playwright MCP 服务器配置
│
├── package.json
└── playwright.config.js
```
---
## 快速开始（经验丰富的用户）
```bash
# 1. 安装依赖项
npm install
npx playwright install chromium
# 2. 启动游戏服务器
npx serve src -p 3000
# 3. 打开 VS Code，附加 Copilot Chat，粘贴 agents/01-explore-agent.md
# 4. 按照模块 02 → 05 进行操作
```
---
*快乐测试！持续运行，持续交付。 🏃*
