SuperAPI AI 工具集

gherkin-authoring

通用与其它

查看项目

更新于 10-15 22:38

技能介绍

用途:编写与优化 Gherkin,把业务行为写成可执行示例,适用于独立 .feature 文件以及 Markdown 或其他文本中嵌入的 Gherkin。若 Gherkin 位于 Markdown 包裹中,只审阅或改写 Gherkin 部分,保留围栏、标题和周围文字,并返回包含原 Markdown 包裹的结果。

主要能力:覆盖 Feature、Rule、Scenario/Example、Background、Scenario Outline 与 Examples、Given/When/Then、And/But、*、@tag、# 注释、Doc String、Data Table 等构造;给出各构造的用途与语法提示;可先识别 Gherkin 区域,再以初始状态、事件、可观察结果澄清行为,选择最小合适结构,最后检查语法与可读性。

使用规则:使用领域专家语言,避免把业务行为翻译为 UI 点击、HTTP 调用、数据库行、队列、mock 或实现细节。Given 描述已知状态,不在其中写用户交互;When 描述一个有意义的单一事件;Then 描述用户或外部系统可见的结果,不轻易断言隐藏数据库状态。And/But 用于改善行文,不用于隐藏新阶段。避免不同步骤关键字下出现相同步骤文本,因为 Cucumber 匹配步骤定义时忽略 Given/When/Then。默认两空格缩进,Background 尽量简短,超过约四行时提升步骤层级或按 Rule/Feature 拆分。仅当示例共享同一行为、仅数据不同时使用 Scenario Outline。Data Table 单元格内需转义 |、换行与反斜杠。

限制:资料未提供具体安装命令、运行工具、价格或平台信息,使用时需结合具体 Cucumber 工具链。常见错误包括保留 Markdown 包裹时误返回纯 Gherkin、Feature 或场景标题缺少或多余冒号、Given 中出现点击操作、Then 断言数据库行、Given 与 Then 复用相同步骤文本、大量 UI 操作脚本化、Background 过大等。