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-architectAbout 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
| Stack | Ngôn ngữ | Runner | Report | Build Tool |
|---|---|---|---|---|
| Playwright + TypeScript | TypeScript | Playwright Test | HTML Report, Allure | npm |
| Playwright + Java | Java | TestNG / JUnit5 | Allure Report | Maven / Gradle |
| Playwright + Python | Python | Pytest | Allure, pytest-html | pip |
| Selenium + Java | Java | TestNG | Allure, ExtentReports | Maven / Gradle |
| Selenium + Python | Python | Pytest | Allure, pytest-html | pip |
📱 Mobile Automation
| Stack | Ngôn ngữ | Runner | Report | Build Tool |
|---|---|---|---|---|
| Appium + Java | Java | TestNG | Allure, ExtentReports | Maven / Gradle |
| Appium + Python | Python | Pytest | Allure, pytest-html | pip |
🔌 API Automation
| Stack | Ngôn ngữ | Runner | Report |
|---|---|---|---|
| REST Assured | Java | TestNG | Allure |
| Playwright API | TypeScript | Playwright Test | HTML Report |
| Requests + Pytest | Python | Pytest | Allure |
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 ↗