AgentSkillsCN

cucumber-automation-skill

使用Java、JavaScript或Ruby生成Cucumber BDD测试,包含Gherkin特性文件与步骤定义。当用户提及“Cucumber”“Gherkin”“特性/场景”“Given/When/Then”“BDD”时使用此功能。可通过“Cucumber”“Gherkin”“BDD”“特性文件”“Given/When/Then”“步骤定义”等指令触发。

SKILL.md
--- frontmatter
name: cucumber-automation-skill
description: >
  Generates Cucumber BDD tests with Gherkin feature files and step definitions
  in Java, JavaScript, or Ruby. Use when user mentions "Cucumber", "Gherkin",
  "Feature/Scenario", "Given/When/Then", "BDD". Triggers on: "Cucumber",
  "Gherkin", "BDD", "Feature file", "Given/When/Then", "step definitions".
languages:
  - Java
  - JavaScript
  - Ruby
  - TypeScript
category: bdd-testing
license: MIT
metadata:
  author: TestMu AI
  version: "1.0"

Cucumber BDD Skill

Core Patterns

Feature File (Gherkin)

gherkin
Feature: User Login
  As a registered user
  I want to log into the application
  So that I can access my dashboard

  Background:
    Given I am on the login page

  Scenario: Successful login
    When I enter "user@test.com" in the email field
    And I enter "password123" in the password field
    And I click the login button
    Then I should be redirected to the dashboard
    And I should see "Welcome" on the page

  Scenario: Invalid credentials
    When I enter "wrong@test.com" in the email field
    And I enter "wrongpass" in the password field
    And I click the login button
    Then I should see an error message "Invalid credentials"

  Scenario Outline: Login with various users
    When I enter "<email>" in the email field
    And I enter "<password>" in the password field
    And I click the login button
    Then I should see "<result>"

    Examples:
      | email           | password    | result     |
      | admin@test.com  | admin123    | Dashboard  |
      | user@test.com   | password    | Dashboard  |
      | bad@test.com    | wrong       | Error      |

Step Definitions — Java

java
import io.cucumber.java.en.*;
import static org.junit.jupiter.api.Assertions.*;

public class LoginSteps {
    private LoginPage loginPage;
    private DashboardPage dashboardPage;

    @Given("I am on the login page")
    public void iAmOnTheLoginPage() {
        loginPage = new LoginPage(driver);
        loginPage.navigate();
    }

    @When("I enter {string} in the email field")
    public void iEnterEmail(String email) {
        loginPage.enterEmail(email);
    }

    @When("I enter {string} in the password field")
    public void iEnterPassword(String password) {
        loginPage.enterPassword(password);
    }

    @When("I click the login button")
    public void iClickLogin() {
        dashboardPage = loginPage.clickLogin();
    }

    @Then("I should be redirected to the dashboard")
    public void iShouldBeOnDashboard() {
        assertTrue(driver.getCurrentUrl().contains("/dashboard"));
    }

    @Then("I should see {string} on the page")
    public void iShouldSeeText(String text) {
        assertTrue(dashboardPage.getPageSource().contains(text));
    }
}

Step Definitions — JavaScript

javascript
const { Given, When, Then } = require('@cucumber/cucumber');
const { expect } = require('chai');

Given('I am on the login page', async function() {
  await this.page.goto('/login');
});

When('I enter {string} in the email field', async function(email) {
  await this.page.fill('#email', email);
});

When('I click the login button', async function() {
  await this.page.click('button[type="submit"]');
});

Then('I should see {string} on the page', async function(text) {
  const content = await this.page.textContent('body');
  expect(content).to.include(text);
});

Hooks

java
import io.cucumber.java.*;

public class Hooks {
    @Before
    public void setUp(Scenario scenario) {
        driver = new ChromeDriver();
    }

    @After
    public void tearDown(Scenario scenario) {
        if (scenario.isFailed()) {
            byte[] screenshot = ((TakesScreenshot) driver).getScreenshotAs(OutputType.BYTES);
            scenario.attach(screenshot, "image/png", "failure-screenshot");
        }
        driver.quit();
    }
}

Tags

gherkin
@smoke
Feature: Login
  @critical @fast
  Scenario: Quick login
    ...

  @slow @regression
  Scenario: Full login flow
    ...
bash
# Run by tag
mvn test -Dcucumber.filter.tags="@smoke"
mvn test -Dcucumber.filter.tags="@smoke and not @slow"

Anti-Patterns

BadGoodWhy
UI details in GherkinBusiness languageReadability
One step per line of codeMeaningful business stepsAbstraction
No Background for shared stepsUse BackgroundDRY
Imperative stepsDeclarative stepsMaintainable

Cloud Execution on TestMu AI

Set environment variables: LT_USERNAME, LT_ACCESS_KEY

Java:

java
// CucumberHooks.java
ChromeOptions browserOptions = new ChromeOptions();
HashMap<String, Object> ltOptions = new HashMap<>();
ltOptions.put("user", System.getenv("LT_USERNAME"));
ltOptions.put("accessKey", System.getenv("LT_ACCESS_KEY"));
ltOptions.put("build", "Cucumber Build");
ltOptions.put("name", scenario.getName());
ltOptions.put("platformName", "Windows 11");
ltOptions.put("video", true);
browserOptions.setCapability("LT:Options", ltOptions);
driver = new RemoteWebDriver(new URL("https://hub.lambdatest.com/wd/hub"), browserOptions);

JavaScript:

javascript
const driver = new Builder()
  .usingServer(`https://${process.env.LT_USERNAME}:${process.env.LT_ACCESS_KEY}@hub.lambdatest.com/wd/hub`)
  .withCapabilities({ browserName: 'chrome', 'LT:Options': {
    user: process.env.LT_USERNAME, accessKey: process.env.LT_ACCESS_KEY,
    build: 'Cucumber Build', platformName: 'Windows 11', video: true
  }}).build();

Quick Reference

TaskCommand
Run all (Java)mvn test with cucumber-junit-platform-engine
Run all (JS)npx cucumber-js
Run tagged--tags "@smoke"
Dry run--dry-run
Generate snippetsRun undefined steps

Deep Patterns → reference/playbook.md

§SectionLines
1Project Setup & ConfigurationMaven, runner, rerun
2Feature Writing PatternsBackground, outlines, DataTable
3Step DefinitionsTyped steps, DI injection
4Dependency Injection & Shared StatePicoContainer, ScenarioContext
5Hooks (Lifecycle Management)Before/After ordering, screenshots
6Custom Parameter TypesTransformers, DocString
7Parallel ExecutionThread-safe, TestNG parallel
8ReportingAllure, masterthought, JSON
9CI/CD IntegrationGitHub Actions, tag matrix
10Debugging Quick-Reference10 common problems
11Best Practices Checklist13 items