| name | QA Automation Engineer |
| description | Skill hỗ trợ agent thực hiện các tác vụ QA automation testing bao gồm generate test cases, automation scripts, API tests, locators, phân tích flaky tests, và tạo test data. |
QA Automation Engineer
Description
This skill enables the agent to assist with software testing and automation tasks.
The agent can:
- Generate manual test cases from requirements
- Generate test automation scripts from test cases or UI flows
- Generate API tests from Swagger/OpenAPI specifications
- Explore applications and discover test scenarios
- Generate automation frameworks
- Generate test data
- Analyze flaky tests
- Generate stable locators
- Generate requirements from website analysis
This skill is designed for modern QA workflows and automation development.
When to Use
Use this skill when the user asks about:
- Test automation
- Manual testing
- Automation frameworks
- API testing
- UI testing
- Test data generation
- Flaky test debugging
- Locator generation
- Requirements analysis from website
- Jira integration (fetch requirements, push test results)
- Xray test management
Typical prompts include:
- Generate test cases from requirement
- Generate Selenium automation from test case
- Generate automation from UI steps
- Generate API tests from Swagger
- Generate regression suite → (redirect sang
generate_application_test_plan hoặc generate_manual_testcases_rbt)
- Generate test data
- Analyze flaky test
- Generate locator for element
- Generate requirements from website
Workflow Routing
When the user request matches a specific task, select the appropriate workflow file from .agent/workflows/.
Generate test cases from requirements
Delegate: Tác vụ này thuộc skill rbt_manual_testing — không phải qa_automation_engineer.
Use workflow: generate_testcases_from_requirements (QUICK mode) hoặc generate_manual_testcases_rbt (FULL RBT mode).
Triggers when user asks:
- generate test cases → delegate to
rbt_manual_testing (QUICK mode)
- write manual test cases → delegate to
rbt_manual_testing (QUICK mode)
- test scenarios from requirement → delegate to
rbt_manual_testing (QUICK mode)
- sinh test cases đầy đủ / quy trình 6 bước → delegate to
rbt_manual_testing (FULL RBT mode)
Generate automation from manual test case
Use workflow: generate_automation_from_testcases
Triggers when user asks:
- convert test case to automation
- generate Selenium automation
- generate Playwright automation from test case
Generate automation from UI steps
Use workflow: generate_automation_from_ui_flow
Triggers when user asks:
- automate this UI flow
- generate automation from steps
- run UI steps and generate Selenium script
Generate API tests
Use workflow: generate_api_tests_from_swagger
Triggers when user provides:
- Swagger URL
- OpenAPI specification
Generate test data
Use workflow: generate_test_data
Triggers when user asks:
- generate test data
- generate boundary test data
Analyze cross-module feature & generate combinatorial matrix
Use workflow: generate_cross_module_test_plan
Workflow dành cho tính năng phức tạp đi qua nhiều modules nối tiếp. Sinh Data Flow Map + Ma trận kết hợp đa chiều (Pairwise / Business-critical / Full Cartesian).
Triggers when user asks:
- phân tích tính năng cross-module
- test nhiều module liên kết
- sinh ma trận kết hợp / combinatorial matrix
- test tính năng có nhiều điều kiện kết hợp
- analyze multi-module feature
- pairwise testing
- decision table đa chiều / nhiều chiều
Generate combinatorial test data (multi-module pipeline)
Use workflow: generate_combinatorial_test_data
Sinh test data cho ma trận kết hợp. Hỗ trợ 2 modes: GENERATE (sinh offline) và PIPELINE (chạy thật trên browser qua N modules).
Triggers when user asks:
- sinh data cho ma trận kết hợp
- tạo test data cho combinatorial matrix
- chạy pipeline tạo data qua nhiều module
- generate combinatorial test data
- setup data cho cross-module test
Generate regression suite
Không có workflow riêng. Dùng generate_application_test_plan (Mode PLAN) hoặc generate_manual_testcases_rbt (FULL RBT) tùy theo input.
Triggers when user asks:
- create regression test suite
- generate regression scenarios
Generate automation framework
Delegate: Tác vụ này sử dụng skill framework_architect để thiết kế framework.
Use workflow: generate_automation_framework
Triggers when user asks:
- create automation framework
- design Selenium framework
- design Playwright framework
- design Appium framework
- scaffold automation project
- thiết kế framework mới
Explore application and generate test plan
Use workflow: generate_application_test_plan
Workflow này có 2 modes: PLAN (mặc định — chỉ test plan) và FULL (test plan + automation skeleton).
Khi user yêu cầu "full automation suite" hoặc "bootstrap automation" → tự động chọn Mode FULL.
Triggers when user asks:
- explore application
- discover test scenarios
- generate test plan
- generate full automation suite
- bootstrap automation for project
Analyze flaky tests
Use workflow: analyze_flaky_tests
Triggers when user asks:
- why is this test flaky
- analyze unstable automation
Generate stable locators
Use workflow: generate_locator
Triggers when user asks:
- generate locator for this element
- find stable selector
- create automation locator
Generate requirements from website
Use workflow: generate_requirements_from_website
Triggers when user asks:
- generate requirements from website
- analyze website module and create requirements
- extract user stories from web page
Analyze requirement document
Delegate: Tác vụ này sử dụng skill requirements_analyzer để phân tích requirement documents.
Use workflow: analyze_requirement_document
Workflow chỉ phân tích requirement — KHÔNG sinh test cases. Output là tài liệu phân tích chi tiết gồm: AC breakdown, dependencies, ambiguities, risks.
Triggers when user asks:
- phân tích requirement document
- review yêu cầu / analyze this ticket
- phân tích Jira ticket / requirement
- tìm điểm mơ hồ trong requirement
- analyze requirement / review requirement document
Fetch requirements from Jira
Use workflow: fetch_jira_requirements
Triggers when user asks:
- fetch jira requirements
- lấy requirement từ jira
- get jira ticket
- import user stories from jira
Import test results to Xray
Use workflow: import_test_results_xray
Triggers when user asks:
- push test results to xray
- đẩy kết quả test lên xray
- import test execution to jira
- upload playwright results to xray
Automation Framework
Default automation stack:
- Language: Java
- UI automation: Selenium WebDriver or Playwright
- Test framework: TestNG
- API automation: REST Assured
- Mobile automation: Appium
- Design pattern: Page Object Model (POM)
Locator Strategy
Selenium Locator Priority
iddata-testidnamecss selectorxpath (last resort)
Avoid fragile locators such as auto-generated class names or positional xpaths.
Playwright Locator Priority
getByRole()getByLabel()getByPlaceholder()getByText()getByTestId()css selectorxpath (last resort)
Avoid fragile selectors such as dynamic class names.
Note: For detailed locator rules, refer to .agent/rules/locator_strategy.md.
Rules References
The agent MUST also follow the detailed rules defined in .agent/rules/:
References
The agent may consult additional documentation in the references/ folder:
PROJECT_CONTEXT.md — Project domain, tech stack, key modulesTEST_STRATEGY.md — Testing objectives, scope, execution planPROMPT_TEMPLATES.md — Reusable prompt templates for common QA tasks
External references (thay thế cho các file đã gộp):
plans/automation/project_architecture/README.md — Repository structure & project architecture (thay thế REPOSITORY_MAP.md)GEMINI.md > "Cleanup & Delivery" — Quality checklist / Definition of Done (thay thế SELF_CHECK.md)
Output
Depending on the request, the agent may return:
- Manual test cases (structured format)
- Automation scripts (Java/TypeScript)
- API tests (REST Assured)
- Locator recommendations
- Test data (structured, randomized, traceable)
- Automation framework design
- Requirements documents
Automation outputs should include:
- Page Object classes
- Test classes
- Assertions validating expected behavior
- Clean, readable, maintainable code (no debug logs, no commented code)
