AI导哈

自动化文档生成框架

一个用于在严格时间限制内自动生成全面测试文档的框架，适用于ISTQB测试杯等竞赛场景。

  • by Slavislav
  • HTML
  • 本地部署
  • 更新于
在 GitHub 查看 Slavislav/Playwright-mcp

使用说明

🏆 ISTQB 测试杯 - 自动化辅助

总决赛文档生成器

📋 竞赛概览

活动： ISTQB测试杯总决赛
日期： 2025年10月20日
地点： 丹麦，哥本哈根
团队： 自动化援助

团队成员

  • 团队负责人： 斯拉夫·阿斯蒂诺夫
  • 测试负责人： 萨瓦·巴巴拉夫

成就

🥇（第一名） 保加利亚ISTQB测试杯获奖者 - 进入总决赛争夺冠军

🎯 项目使命

这个项目提供了 自动化文档生成框架 在紧迫的竞争时间限制内，编制全面的测试文档。

竞赛挑战

  • 分析一个 未知的被测系统（SUT） 在比赛日揭晓
  • 生成专业（的内容/作品） 测试计划、测试分析和测试设计 文件；文献
  • 最大化得分（总分40分 - 每个文档类别20个
  • 提供符合比赛要求的文档 大约3小时

🏗️ 项目结构

Playwright-mcp/
├── 📄 PROJECT-SYSTEM-MESSAGE.md    # Competition instructions & standards
├── 📄 README.md                     # This file
├── 📁 SUT-Overview-Generator/       # SUT analysis & exploration
│   └── SUT-Overview-Generation-Prompt.md
├── 📁 Test-Plan/                    # Test Plan generation resources
│   ├── Test-Plan-Generation-Prompt.md
│   └── test-plan-knowledge-base.md
├── 📁 Test-Analysis/                # Test Analysis generation resources
│   ├── Test-Analysis-Generation-Prompt.md
│   └── test-analysis-knowledge-base.md
├── 📁 Test-Design/                  # Test Design generation resources
│   ├── Test-Design-Generation-Prompt.md
│   └── test-design-knowledge-base.md
├── 📁 Documents/                    # Templates & reference materials
│   ├── template.html               # HTML document template
│   └── exploration.json            # Sample exploration data
├── 📁 k6/                           # Performance load testing toolkit
│   ├── basic-load-test.js          # Simple endpoint testing template
│   ├── spike-test.js               # Traffic surge simulation
│   ├── stress-test.js              # Breaking point finder
│   ├── api-rest-test.js            # Multi-endpoint API testing
│   ├── scenario-based-test.js      # Realistic user behavior scenarios
│   ├── soak-test.js                # Long-term stability testing
│   ├── utils.js                    # Helper functions & data generation
│   ├── config.js                   # Configuration template
│   ├── AI_AGENT_PROMPT.md          # K6 knowledge base for AI agents
│   └── README.md                   # Quick reference guide
├── 📁 playwright-base-project/     # AI-powered test automation framework
│   ├── page-objects/               # Page Object Models (POM)
│   ├── tests/                      # Test specifications
│   ├── test-data/                  # Test data files
│   ├── helpers/                    # Utility functions
│   ├── playwright.config.ts        # Playwright configuration
│   ├── README.md                   # Complete framework documentation
│   ├── QUICK-START.md              # Instant automation template
│   ├── AUTOMATION-TRIGGER-PROMPT.md # AI automation guide
│   └── AUTOMATION-REFERENCE-CARD.md # Quick reference patterns
└── 📁 Archive/                      # Generated competition documents
    ├── CURA-Healthcare-*.html      # Practice documentation
    └── A1-Club-*.md               # Practice documentation

🎭 剧作家测试自动化框架

目的

基于人工智能的测试生成 以便在竞赛期间快速进行系统单元测试（SUT）验证和测试用例执行。

竞争整合

  • SUT探索： 使用 Playwright-MCP 交互式地探索未知的被测系统（SUT）
  • 自动化测试创建： AI从实时应用程序中生成页面对象、测试数据和测试规范
  • 真实选择器捕获： 从浏览器中捕获实际的DOM元素，而非基于假设
  • 测试用例执行： 通过可执行的自动化测试验证测试设计

主要特点

特点 优势
AI驱动的生成 提供URL和凭据 → 获取完整的测试自动化
页面对象模型 可维护、可重用的测试组件
真实浏览器探索 Playwright-MCP 从实时应用中捕获实际选择器
TypeScript + 最佳实践 准生产就绪、类型安全的代码
多浏览器支持 Chromium、Firefox、WebKit
丰富的报告功能 包含追踪信息、截图、视频的HTML报告

竞赛工作流程

# Quick automation for unknown SUT:
1. Receive SUT URL and credentials
2. Use QUICK-START.md template → Paste URL + credentials + test case
3. AI explores SUT with Playwright-MCP browser
4. Auto-generates: Page Objects + Test Data + Test Specs
5. Execute tests to validate Test Design
6. Include test reports as supporting artifacts
# Total time: ~15-30 minutes per test scenario

文档

示例输出结构

在自动化测试用例后，生成：

page-objects/[SUT]/
├── LoginPage.ts              # Login interactions
├── DashboardPage.ts          # Dashboard elements
└── [Feature]Page.ts          # Feature-specific pages

test-data/
├── [sut]-credentials.json    # Login credentials
└── [sut]-testdata.json       # Test data

tests/
└── TC-[ID]-[description].spec.ts  # Executable test case

价值主张

✅ 速度 - 分钟级而非小时级创建可执行测试
✅ 质量 - 来自实际应用的真实选择器
✅ 覆盖范围 - 通过自动化验证测试设计
✅ 证据 - 可交付成果的测试执行报告

见： playwright基础项目/ 以获取完整文档。

🔧 技术栈

核心自动化工具

工具 目的 使用方法
Playwright MCP 可以翻译为“Playwright 最小配置项目”或“Playwright 的 MCP（最小配置）”，具体翻译取决于上下文和MCP在此处的具体含义。如果MCP是特定于某个领域或项目的缩写，可能需要更具体的翻译。但一般情况下，上述翻译应该能够准确传达原文的意思 SUT（系统/软件单元测试）探索与分析 浏览器自动化、用户界面交互、工作流分析
OWASP ZAP（开放Web应用安全项目之Zed Attack Proxy，简称ZAP） 安全测试 漏洞扫描，渗透测试
Google Lighthouse（谷歌灯塔） 可访问性测试 WCAG合规性，可访问性审核
K6 性能测试 负载测试，性能基准测试
光标 + Claude 人工智能辅助文档编写 测试用例生成，智能分析
n8n 工作流自动化 测试执行流水线，报告生成

开发环境

  • 包管理器： pnpm（v8.15.8）
  • 运行时间： Node.js
  • 人工智能助手： 克劳德·莎士比亚十四行诗4.5（通过Cursor访问）
  • VCS：版本控制系统（Version Control System） Git

🚀 快速入门

先决条件

# Ensure pnpm is installed
corepack enable
corepack prepare pnpm@8.15.8 --activate

安装

# Clone the repository
git clone <repository-url>
cd Playwright-mcp

# Install dependencies (if package.json exists)
pnpm install

竞赛日工作流程

第一阶段：系统被测对象（SUT）发现（30分钟）

# 1. Receive SUT URL and credentials from organizers
# 2. Execute SUT exploration using Playwright MCP
# 3. Generate comprehensive SUT Overview document

遵循以下过程 SUT-Overview-Generator/SUT-Overview-Generation-Prompt.md

第二阶段：测试计划制定（45分钟）

# 1. Analyze SUT Overview for risk identification
# 2. Define comprehensive scope and timeline
# 3. Generate Test Plan HTML document

按照以下步骤进行 Test-Plan/Test-Plan-Generation-Prompt.md
参考文献： Test-Plan/test-plan-knowledge-base.md

第三阶段：生成测试分析（45分钟）

# 1. Focus on high-risk features
# 2. Create detailed test conditions
# 3. Generate Test Analysis HTML document

按照以下步骤操作 Test-Analysis/Test-Analysis-Generation-Prompt.md
参考文献： Test-Analysis/test-analysis-knowledge-base.md

第四阶段：测试设计生成（45分钟）

# 1. Design comprehensive test cases
# 2. Apply test design techniques
# 3. Generate Test Design HTML document

遵循以下过程 Test-Design/Test-Design-Generation-Prompt.md
参考： Test-Design/test-design-knowledge-base.md

第五阶段：审阅与润色（15分钟）

# Final quality check and document refinement

📊 评分标准

测试计划质量（20分）

成功因素：

  • ✅ 全面覆盖产品风险
  • ✅ 明确的范围和实际的时间管理
  • ✅ 使用工具的系统化方法
  • ❌ 避免：只关注一种测试类型或不可行的时间安排

测试分析与设计（20分）

成功因素：

  • ✅ 重点关注高风险特征
  • ✅ 明确的测试条件、测试用例和测试章程
  • ✅ 优先级排序和可追溯性
  • ❌ 避免：缺少基本测试或设计超出可执行范围的内容

目标分数： 40/40分（满分）

📝 文件标准

HTML 模板

所有文档均使用位于（指定路径）的专业HTML模板 Documents/template.html

所需文件标题

Team Name: Automation Aid
Competition: ISTQB Testing Cup Grand Finals
Date: October 20th, 2025
Location: Copenhagen, Denmark
Team Lead: Slav Astinov
Test Lead: Sava Barbarov

质量标准

  • 全面覆盖： 满足所有评分标准
  • 基于风险的方法/方法论 优先关注高风险区域
  • 实际实施： 确保可执行性
  • 专业品质： 竞赛级别的标准

🎖️ 竞争优势

自动化援助团队的优势

  1. 系统化方法 - 经验证的快速SUT（系统/软件/服务单元测试）分析方法
  2. 工具精通 - 高级Playwright MCP自动化功能
  3. 知识整合 - 全面的测试知识库
  4. 卓越文档（或：文档卓越） - 专业的HTML模板设计
  5. 风险焦点 - 基于战略风险的测试方法

创新优势

  • 使用Cursor + Claude实现AI辅助文档生成
  • 使用Playwright MCP进行自动化系统UT（被测系统）探索
  • 多工具集成策略（安全性、性能、可访问性）
  • 使用n8n实现工作流自动化

⚡ K6 性能测试集成

竞赛中的目的

K6提供 快速性能基线建立 对于未知的待测系统（SUT），支持测试计划的风险分析和测试设计的性能测试用例。

竞赛工作流程

  1. 端点发现 (通过 Playwright MCP) - 在被测系统（SUT）探索过程中捕获网络请求
  2. 模板选择 选择适当的K6测试类型（API/突增/压力/场景）
  3. 快速定制 - 更新BASE_URL并发现端点（5分钟）
  4. 执行 - 运行负载测试以建立性能基线（2-5分钟）
  5. 报告生成 - 自动生成 summary.html 配备专业指标和图表

K6测试模板已准备好投入竞赛

模板 竞赛用例 执行时间
basic-load-test.js 快速API健康检查 30秒
api-rest-test.js 多终端性能基线 2分钟
spike-test.js 测试计划风险的韧性测试 40秒
stress-test.js 寻找产能规划的突破点 4.5分钟
scenario-based-test.js 真实用户行为模拟 2分钟

绩效报告输出

  • HTML 报告 - 专业的 summary.html 包含图表、指标以及通过/失败阈值
  • 关键指标 - 响应时间（p95、p99）、错误率、吞吐量、并发用户数
  • 阈值 - 可配置的测试计划包含通过/失败标准
  • 证据 - 准备就绪的竞赛级性能测试文档

Playwright MCP + K6 集成

# Competition Day Quick Flow:
1. Playwright MCP → Discover endpoints (5 min)
2. Update K6 template with discovered URLs (2 min)
3. Run: k6 run --vus 10 --duration 2m api-rest-test.js (2 min)
4. Include summary.html in supporting artifacts (instant)
# Total: ~10 minutes for complete performance test evidence

📚 知识库资源

生成提示词

  • SUT-Overview-Generator/SUT-Overview-Generation-Prompt.md - SUT分析方法
  • Test-Plan/Test-Plan-Generation-Prompt.md - 测试计划创建指南
  • Test-Analysis/Test-Analysis-Generation-Prompt.md - 测试分析创建指南
  • Test-Design/Test-Design-Generation-Prompt.md - 测试设计创建指南

知识库

  • Test-Plan/test-plan-knowledge-base.md - 测试规划的最佳实践
  • Test-Analysis/test-analysis-knowledge-base.md - 测试分析技术
  • Test-Design/test-design-knowledge-base.md - 测试设计模式

模板与标准

  • Documents/template.html - 专业的HTML文档模板
  • PROJECT-SYSTEM-MESSAGE.md - 完整的比赛说明

🔄 工作流程概述

graph TD
    A[Competition Day] --> B[Receive Unknown SUT]
    B --> C[SUT Exploration - 30min]
    C --> D[Generate SUT Overview]
    D --> E[Test Plan Generation - 45min]
    E --> F[Test Analysis Generation - 45min]
    F --> G[Test Design Generation - 45min]
    G --> H[Review & Polish - 15min]
    H --> I[Submit Documents]
    I --> J[40/40 Points!]

📦 可交付成果

竞赛成果

  1. SUT概述文档 - 基础分析（Markdown格式）
  2. 测试计划文档 - 战略性测试方法（HTML）
  3. 测试分析报告 - 详细的测试条件（HTML格式）
  4. 测试设计文档 - 全面的测试用例（HTML）

支持性工件（或辅助材料/辅助工具）

  • OWASP ZAP（开源应用程序安全项目 黑客攻击防护工具） 安全测试报告
  • K6 性能测试报告summary.html - 自动生成包含指标、图表和阈值的HTML报告
  • 灯塔 无障碍性报告
  • 剧作家 自动化脚本（GitHub仓库）

🎯 成功指标

目标成果

  • ✅ 测试计划质量： 满分20分
  • ✅ 测试分析与设计： 20/20分
  • ✅ 总分：40/40分（满分）

质量指标

  • ✅ 所有评分标准均已全面覆盖
  • ✅ 一贯采用基于风险的方法
  • ✅ 专业、适用于竞赛的文档
  • ✅ 可执行且实用的建议
  • ✅ 所有文档设计风格一致

🤝 贡献

这是一个竞赛项目，针对的是 自动化辅助 团队。该框架和方法可适应于：

  • ISTQB认证培训
  • 快速生成测试文档
  • 测试方法演示
  • 教育目的

📄 许可证

这个项目由……维护 自动化辅助 参加ISTQB测试杯总决赛的团队。

📞 联系方式

团队： 自动化辅助
团队负责人： 斯拉夫·阿斯蒂诺夫
测试负责人： 萨瓦·巴巴拉夫
竞争： 2025年ISTQB测试杯总决赛
地点： 丹麦，哥本哈根

🏁 使命宣言

“提交卓越的测试文档，展示对ISTQB原则的深刻掌握、创新的自动化方法以及值得参加ISTQB测试杯总决赛的专业卓越水平。”

助力自动化，Go来帮忙！ 🚀

文档版本： 1.0
最后更新时间： 2025年1月
目的： 竞争框架文档
状态： 总决赛准备就绪 ✅

相关 MCP