技能使用指南

cucumber-step-definitions（Cucumber步进定义）Skill 是什么？

Cucumber步进定义技能帮你在 Cucumber.js、Cucumber-JVM、Ruby 中写出可维护、可复用的步进定义，覆盖参数化步骤、正则匹配、数据表、World 上下文与钩子编排，并内置反模式纠错清单。安装后直接描述场景即可生成规范代码，降低 BDD 自动化测试的编写与维护门槛，马上试用提升测试开发效率。

Cucumber步进定义技能Skillcucumber-step-definitions
8 个章节 约 13 分钟阅读 AI 智能生成

Cucumber步进定义技能：让 Gherkin 场景与自动化代码无缝衔接

  • 它是什么：一个专注于「如何写好 Cucumber 步进定义（Step Definitions）」的 AI 技能，把参数化、正则匹配、数据表、World 上下文、钩子、页面对象模式等一整套实践沉淀成可直接复用的知识。
  • 解决什么痛点：很多团队 Gherkin 场景写得漂亮，但步进定义一团糟——步骤过度耦合、断言塞进 When、逻辑重复、维护成本极高。这个技能专门治这些「自动化测试代码腐化」问题。
  • 覆盖技术栈：JavaScript / TypeScript（Cucumber.js）、Java（Cucumber-JVM）、Ruby 三大主流实现，示例可直接对照改造。
  • 怎么用：安装后在对话中描述你的场景或贴出现有步骤定义，让技能按「最佳实践」输出可维护、可复用的实现，并主动指出你代码中的反模式。
  • 适合谁：测试开发工程师、QA、做 BDD 实践的前后端团队，以及需要评审测试代码规范的负责人。

该技能叫什么？如何一键安装 AI 技能提升开发效率？

技能中文名：Cucumber步进定义技能Skill 技能英文名：cucumber-step-definitions 技能ID：13967

这个技能要解决的问题非常具体：BDD（行为驱动开发）里，Gherkin 写的是「人话」，自动化代码写的是「机器话」，而步进定义就是这两者之间的粘合剂。粘合剂写得好，场景可读、代码可维护；写得差，就会出现典型的三种病灶：

  1. 步骤定义过度具体，一个场景配一套步骤，复用率趋近于零；
  2. 动作和断言混在同一个步骤里（比如“我点击登录并看到仪表盘”），失败时完全定位不到问题；
  3. 步骤之间靠全局变量传状态，或者干脆在步骤内部去调用另一个步骤，导致执行顺序敏感到无法维护。

该技能把这些问题的正解与反例都固化成了知识，使用它等于随身带了一位熟悉 Cucumber 体系的测试架构师。

关于「一键安装」的思路：本技能属于知识型／参考型技能（详情中标注为 user-invocable: false，即不直接面向用户主动调用，而是作为能力被引用），因此它的安装与启用更接近于「挂载一份专家知识库」，而不是安装一个带命令行入口的工具。通用流程如下：

  1. 确认前提：你的 AI 助手/开发环境已支持技能（Skill）机制，且当前的对话或项目能够加载技能上下文。
  2. 找到入口：在技能市场或技能管理页面中，按技能英文名 cucumber-step-definitions 或技能ID 13967 检索。具体的安装命令、URL 与入口位置，以官方说明为准。
  3. 执行安装：点击安装/添加，等待技能状态变为「已启用」。
  4. 验证是否生效：在对话中给出一段 Gherkin 场景，并要求「按最佳实践生成步进定义」。如果返回内容使用了 Given/When/Then 的语义分离、参数化占位符（如 {string}、{int}）、并提示避免在 When 中做断言，则说明技能已正常工作。
  5. 日常使用：无需每次手动调用，在编写或评审步进定义时直接描述需求即可，技能会自动以规范化方式输出。

该技能的主要功能和特点

  • 多语言代码生成：同时覆盖 JavaScript/TypeScript（Cucumber.js）、Java（Cucumber-JVM，JUnit 断言）、Ruby（Capybara 风格）三种实现，团队换栈也能快速迁移写法。
  • 参数化步骤：支持从 Gherkin 中捕获值，使用 {string}、{int}、{float} 等占位符把「搜索 Cucumber」「加入 5 件商品」「价格为 $99.99」这类动态值抽出来，一条步骤定义服务多个场景。
  • 正则表达式灵活匹配：针对占位符表达不了的场景，提供 /^I wait (\d+) seconds?$/ 这类写法，并示范用非捕获组 (?:a|an) 做可读性与匹配能力的平衡。
  • 数据表与文档字符串处理：说明 dataTable.hashes()（转对象数组）与 dataTable.raw()（二维数组）的差异与适用场景，以及多行文本参数如何接收。
  • World 上下文管理：演示如何自定义 World 类共享状态（购物车、当前用户），用 this.xxx 替代全局变量，从根上解决步骤间耦合。
  • 钩子（Hooks）编排：BeforeAll / Before / Before({tags}) / After / AfterAll 的职责划分，包含按标签过滤执行、浏览器与服务端的启停时机。
  • 步骤组织范式：页面对象模式（Page Object）与辅助函数抽取，避免步骤定义膨胀成巨型文件。
  • 反模式纠错：明确列出「过度具体的步骤」「在 Given/When 中放断言」「在步骤内部调用步骤」三类典型错误，并给出可组合写法的正确示范。

它比普通工具强在哪：搜索引擎和官方文档给的是零散示例，通用 AI 补全往往只保证「能跑」，而这个技能给的是成体系的规范 + 正反例对照，输出的代码默认就带着可维护性约束。

如何使用该技能？

  1. 描述你的业务场景：用自然语言或直接贴 Gherkin 场景。例如：
    Scenario: 用户使用有效凭证登录
  Given I am on the login page
  When I enter valid credentials
  Then I should be logged in
  2. 声明技术栈：说明是 Cucumber.js（Playwright/Puppeteer）、Cucumber-JVM（Selenium）还是 Ruby（Capybara），技能会输出对应语言的实现。
  3. 获取步进定义：技能会返回语义分离的 Given / When / Then 代码，并提示每一步只做一件事。
  4. 补充动态数据需求：需要传参时直接说「搜索关键词是变量，数量也是变量」，技能会改写成 When('I search for {string} in the search bar', ...) 与 When('I add {int} items to my cart', ...)。
  5. 处理表格数据：场景中带表格时，说明希望按行映射成对象还是取原始二维数组，技能分别给出 hashes() 与 raw().flat() 的写法。
  6. 要求共享状态：需要跨步骤保存登录用户或购物车时，要求「用 World 管理状态」，技能会给出 setWorldConstructor(CustomWorld) 的完整示例。
  7. 要求补充钩子：说明「每个场景前启动浏览器、带 @database 标签的场景清库、场景后关闭浏览器」，技能会输出对应的 Before/After 组合。
  8. 让它做代码评审：把现有步骤文件贴给它，要求「按最佳实践审查」，它会指出断言混入 When、步骤嵌套调用等问题并给出重构方案。
  9. 输出说明：返回内容以代码块 + 简短说明的形式呈现，重点解释「为什么这样写」，便于团队内部分享。

同类型竞品对比分析

方案名称 定位 核心功能 安装/使用门槛 适用场景 优势与不足
Cucumber步进定义技能（本技能） 步进定义编写的规范型 AI 技能 多语言代码生成、参数化、数据表、World、钩子、反模式纠错 需环境支持技能机制，安装入口以官方说明为准；使用零门槛 从零搭建步骤库、重构腐化代码、团队规范对齐 优势：体系化、自带正反例、多语言一致；不足：偏知识与生成，不负责实际执行测试
手写 + 官方文档 传统方式 参考官方示例自行实现 无安装成本，但要投入学习与试错时间 简单项目、步骤量少的团队 优势：完全可控；不足：容易写成过度具体步骤，规范全靠个人经验
通用大模型对话 通用编码助手 生成可运行的步骤代码 直接对话即可 快速产出一次性示例 优势：上手最快；不足：常忽略可维护性约束，断言易混入 When，缺少统一规范
现成步骤库/开源模板 社区资产 提供可复用步骤集合 需适配项目依赖与版本 标准化 Web 操作类步骤 优势：开箱即用；不足：业务语义步骤仍需自写，定制与调试成本不低

该技能的典型应用场景与实际体验情况

场景一：QA 工程师接手腐化的步骤库 某项目积累了 300 多条步骤定义，重复率极高、改一个按钮选择器要动十几处。使用技能时贴入典型文件并说明「按最佳实践重构」，它会指出「点击登录并看到仪表盘」这类动作与断言混合的步骤，拆成 When('I click login') 与 Then('I should see the dashboard')，并建议把公共登录流程抽成 auth-helpers.js 辅助函数。体验：语义拆分这类改造理解成本极低，团队 reviewer 一看就懂，落地阻力小。

场景二：前端团队用 Cucumber.js + Playwright 做 E2E 团队场景里大量出现「搜索某关键词」「加 N 件商品」「价格应为某小数」，手写步骤容易写死常量。技能直接给出 {string}、{int}、{float} 三种占位符的统一写法。体验：参数化改造后步骤数量明显下降，场景文件可读性提升；需要注意 {float} 拿到的是数字类型，断言前不要再做多余转换。

场景三：Java 后端做接口层的 BDD Cucumber-JVM 项目需要按标签区分是否清库，技能给出 Before({ tags: '@database' }, ...) 的精准示例，并提醒 BeforeAll/AfterAll 只跑一次、适合启停测试服务。体验：钩子执行顺序是新手最容易踩的坑，有了明确的职责说明后，环境准备类问题的排查时间大幅缩短。

场景四：测试架构师做规范评审 把技能输出的「最佳实践 8 条」与「反模式 3 条」直接作为团队 Code Review 清单：步骤是否单一职责、是否复用了通用步骤、是否暴露实现细节、是否用 World 而非全局变量。体验：把主观争议变成了可勾选的客观条目，评审效率明显提高。

整体上手难度：低。因为 user-invocable: false 的设计，使用者不需要记忆任何调用语法，正常描述需求即可。注意事项：技能提供的是写法与结构，具体的页面选择器、接口地址、断言值仍需按你的项目填写；同时应保持步骤名与 Gherkin 严格一致，否则运行时会匹配不到。

该技能能为用户带来的价值

  • 写代码更快：一条场景到可运行步进定义的时间从「查文档 + 试错」压缩到「描述需求 + 微调」，参数化、数据表、World 这类模板化程度高的部分几乎可以直接采用。
  • 维护成本更低：默认遵循「一步骤一动作」「复用优于具体」的约束，步骤库不会随着场景增长而线性膨胀，长期看显著降低回归维护投入。
  • 门槛更低：新人不必先啃完 Cucumber 全部文档，跟着示例就能写出符合团队规范的代码，减少「能跑但不敢改」的遗留代码。
  • 隐性收益更大：可读的步进定义本身就是活文档，业务方、产品经理也能读懂场景，BDD 的沟通价值才真正兑现。
  • 跨栈迁移更顺：同一套思路在 JS、Java、Ruby 三种实现间平移，团队换技术栈时测试资产不会推倒重来。

常见问题 FAQ

Q1：这个技能怎么安装？需要付费吗？ A：在技能市场或技能管理页面用英文名 cucumber-step-definitions 或技能ID 13967 检索后安装即可。具体的安装命令、入口位置与是否收费，以官方说明为准，本文不臆测具体条款。安装后在对话中要求「生成符合最佳实践的步进定义」即可验证是否生效。

Q2：它属于 user-invocable: false，那我还能用吗？ A：可以。这个标记表示它不是那种需要你手动敲命令主动调用的技能，而是作为知识能力被引用。你只需正常描述「我要为某场景写步骤定义」，它就会以规范化方式参与输出。

Q3：它支持哪些语言？我只用 Java 可以吗？ A：覆盖 JavaScript/TypeScript（Cucumber.js）、Java（Cucumber-JVM）、Ruby（Capybara）三类主流实现。只用 Java 完全没问题，声明技术栈后它会输出 JUnit 断言风格的实现；其他语言的示例也可作为思路参照。

Q4：它和直接问通用大模型有什么区别？ A：通用模型通常只保证代码「能跑」，容易把断言写进 When、把步骤写成一次性专用。本技能内置了「最佳实践 8 条」与「反模式 3 条」，输出时默认规避这些坑，并且统一了参数化、World、钩子的组织方式，适合团队长期维护。

Q5：那什么情况下不需要它？ A：如果项目只有十几个简单场景、步骤定义几乎不增长，手写即可；如果你需要的是「一键跑通测试并出报告」的执行类能力，那是测试框架与 CI 的职责，本技能聚焦的是「如何写得可维护」，两者互补而非替代。