Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Browser & automation

skills-framework-architect

Skill thiết kế và scaffold automation framework hoàn chỉnh cho Playwright, Selenium, và Appium — bao gồm project structure, base classes, config management, reporting, và CI/CD integration.

anhtester · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add anhtester/claude-testing-kit --skill skills-framework-architect

About this skill


name: skills-framework-architect description: Skill thiết kế và scaffold automation framework hoàn chỉnh cho Playwright, Selenium, và Appium — bao gồm project structure, base classes, config management, reporting, và CI/CD integration.

Framework Architect

Description

Skill chuyên biệt giúp agent thiết kế, scaffold và triển khai automation framework từ đầu. Hỗ trợ đa nền tảng (Web, Mobile, API) với các framework phổ biến nhất.

Agent có thể:

  • Thiết kế project structure theo best practices
  • Sinh base classes, config management, driver/browser management
  • Tích hợp reporting (Allure, HTML Report, Playwright Report)
  • Cấu hình CI/CD pipeline (GitHub Actions, GitLab CI, Jenkins)
  • Sinh template Page Object Model, fixtures, helpers
  • Tạo file cấu hình (package.json, pom.xml, build.gradle, playwright.config.ts)

When to Use

Sử dụng skill này khi:

  • User yêu cầu tạo/thiết kế automation framework mới
  • User cần scaffold project structure cho test automation
  • User muốn chuẩn hóa framework hiện tại
  • User cần tích hợp reporting hoặc CI/CD vào framework
  • User hỏi về best practices cho framework design

Trigger keywords: "create framework", "design framework", "scaffold project", "thiết kế framework", "tạo project mới"


Supported Stacks

🌐 Web Automation

StackNgôn ngữRunnerReportBuild Tool
Playwright + TypeScriptTypeScriptPlaywright TestHTML Report, Allurenpm
Playwright + JavaJavaTestNG / JUnit5Allure ReportMaven / Gradle
Playwright + PythonPythonPytestAllure, pytest-htmlpip
Selenium + JavaJavaTestNGAllure, ExtentReportsMaven / Gradle
Selenium + PythonPythonPytestAllure, pytest-htmlpip

📱 Mobile Automation

StackNgôn ngữRunnerReportBuild Tool
Appium + JavaJavaTestNGAllure, ExtentReportsMaven / Gradle
Appium + PythonPythonPytestAllure, pytest-htmlpip

🔌 API Automation

StackNgôn ngữRunnerReport
REST AssuredJavaTestNGAllure
Playwright APITypeScriptPlaywright TestHTML Report
Requests + PytestPythonPytestAllure

Framework Components

Mỗi framework PHẢI bao gồm các thành phần sau (tùy chỉnh theo stack):

1. Project Structure (Mandatory)

  • Cấu trúc thư mục rõ ràng, phân tách pages/tests/utils/config
  • File README.md hướng dẫn setup + chạy test
  • File .gitignore phù hợp

2. Configuration Management (Mandatory)

  • Quản lý environment (dev/staging/prod) qua config file hoặc .env
  • Centralized config — không hardcode giá trị trong test
  • Sensitive data (credentials) qua environment variables, KHÔNG commit vào repo

3. Browser / Driver Management (Mandatory)

  • Playwright: playwright.config.ts / conftest.py với browser setup
  • Selenium: WebDriverManager hoặc Driver Factory pattern
  • Appium: Desired Capabilities factory, Appium server config

4. Base Classes (Mandatory)

  • Base Page — chứa common methods (wait, click, type, screenshot)
  • Base Test — chứa setup/teardown, test lifecycle hooks
  • Không hardcode waits — chỉ dùng smart waits

5. Page Object Model (Mandatory)

  • Mỗi page/screen → 1 Page class
  • Locators khai báo ở đầu class, không inline trong test
  • Methods mô tả hành vi người dùng (không phải thao tác DOM)

6. Test Data Management (Mandatory)

  • Data factory / builder pattern cho test data
  • Data external (JSON/YAML/CSV) cho data-driven tests
  • Data unique + traceable (timestamp/random prefix)

7. Utilities (Mandatory)

  • Wait helpers (smart waits, custom conditions)
  • Screenshot utilities (capture cuối MỌI test — cả PASS lẫn FAIL)
  • Logger (structured logging, không dùng print/console.log)
  • Date/Time helpers, String generators

8. Reporting (Mandatory)

  • Tích hợp ít nhất 1 reporting tool (Allure ưu tiên)
  • Metadata mỗi test: tên Tiếng Việt · Description · Severity · Tags · label testId
  • Test Body có step Arrange: / Act: / Assert: — Base Page dùng step API để sinh sub-step
  • Screenshot attach cuối MỌI test — cả PASS lẫn FAIL, không chỉ khi fail
  • KHÔNG attachment stdout / stderr
  • Test execution summary (pass/fail/skip counts)

Chi tiết bắt buộc: .claude/rules/reporting_rules.md

9. CI/CD Pipeline (Optional — nhưng khuyến khích)

  • GitHub Actions / GitLab CI / Jenkins pipeline template
  • Parallel execution config
  • Artifact upload (reports, screenshots)

Project Structure Templates

Playwright + TypeScript

project-root/
├── playwright.config.ts        # Playwright configuration
├── package.json                # Dependencies + scripts
├── .env.example                # Environment template
├── .gitignore
├── README.md
├── src/
│   ├── pages/                  # Page Object classes
│   │   ├── base.page.ts        # Base page (common methods)
│   │   ├── login.page.ts
│   │   └── dashboard.page.ts
│   ├── fixtures/               # Custom fixtures
│   │   ├── auth.fixture.ts     # Authentication fixture
│   │   └── base.fixture.ts     # Extended test with all fixtures
│   ├── utils/                  # Helpers & utilities
│   │   ├── test-data.ts        # Data generators
│   │   ├── env.config.ts       # Environment config reader
│   │   └── helpers.ts          # Common helper functions
│   └── tests/                  # Test specs
│       ├── auth/
│       │   └── login.spec.ts
│       └── dashboard/
│           └── dashboard.spec.ts
├── test-data/                  # External test data (JSON/YAML)
│   └── users.json
└── .github/
    └── workflows/
        └── playwright.yml      # CI pipeline

Selenium + Java (Maven + TestNG)

project-root/
├── pom.xml                     # Maven config + dependencies
├── testng.xml                  # TestNG suite config
├── .env.example
├── .gitignore
├── README.md
├── src/
│   ├── m
Read the complete source ↗