本文基于《https://en.wikipedia.org/wiki/Easy_Approach_to_Requirements_Syntax》与当前流行 AI 编程工具（Kiro / GitHub Spec Kit / OpenSpec）的实践整理而成。

---

## 一、为什么需求语法突然又火了？

在 AI 编程助手（Cursor、Claude Code、GitHub Copilot）爆发的今天，开发者发现了一个反直觉的事实：

**AI 生成的代码质量，不取决于模型多强，而取决于你给的 Spec 多清晰。**

模糊的 prompt 得到模糊的代码，结构化的需求得到结构化的实现。于是，两种经典需求语法重新回到舞台中央：

| 语法 | 全称 | 核心思想 |
|------|------|----------|
| **EARS** | Easy Approach to Requirements Syntax | 用 5 种固定句式写需求，机器可读、人类易懂 |
| **Gherkin** | — | 用 `Given-When-Then` 行为驱动（BDD）描述场景，Cucumber 系标准 |

---

## 二、EARS：五种句式覆盖所有需求场景

根据 https://en.wikipedia.org/wiki/Easy_Approach_to_Requirements_Syntax，EARS 将需求分为五类句式：

### 1. Ubiquitous（普适需求）
> 系统**应**始终执行 X。

```
THE SYSTEM SHALL display the user's full name on the dashboard.
```

### 2. Event-driven（事件驱动）
> **当** X 发生时，系统**应**执行 Y。

```
WHEN a user clicks "Submit", THE SYSTEM SHALL validate the form.
```

### 3. State-driven（状态驱动）
> **在** X 状态下，**当** Y 发生时，系统**应**执行 Z。

```
WHILE in "maintenance mode", WHEN an admin logs in, THE SYSTEM SHALL grant full access.
```

### 4. Optional（可选需求）
> **若** X 为 true，系统**应**执行 Y。

```
IF the user selects "Remember me", THE SYSTEM SHALL persist the session for 30 days.
```

### 5. Unwanted behaviour（异常/负面需求）
> **若** X 发生（异常），系统**应**执行 Y。

```
IF the database connection fails, THE SYSTEM SHALL display an error message and retry after 5 seconds.
```

### 为什么 EARS 适合 AI 编程？

- **结构固定**：AI 不需要猜你的意图，句式本身就是约束
- **无歧义**：`SHALL` 是强制性要求，不是 `should` 或 `may`
- **可测试**：每个句式天然对应一个验收条件

---

## 三、Gherkin：BDD 的通用语言

Gherkin 是 Cucumber 生态发明的自然语言格式，核心关键字：

```
Feature / Scenario / Background / Given / When / Then / And / But / Scenario Outline / Examples
```

一个完整 Gherkin 文件示例：

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

  Background:
    Given a user exists with email "alice@example.com" and password "secret123"

  Scenario: Successful login
    Given the user is on the login page
    When they enter valid credentials
    And they click "Sign In"
    Then they should see the dashboard
    And a JWT token should be stored in localStorage

  Scenario Outline: Invalid login attempts
    Given the user is on the login page
    When they enter email "<email>" and password "<password>"
    And they click "Sign In"
    Then they should see error message "<error>"

    Examples:
      | email               | password    | error                 |
      | alice@example.com   | wrongpass   | Invalid credentials   |
      | invalid@email       | secret123   | Invalid email format  |
      |                     | secret123   | Email is required     |
```

**Gherkin 的核心价值**：业务人员能读懂，自动化测试能直接执行。

---

## 四、三大 AI Spec 工具对 EARS 与 Gherkin 的态度

现在进入重点。当 `Feature / Scenario / Background / Given / When / Then / And / But / Scenario Outline / Examples` 这套完整 Gherkin 文件格式，遇到当前最热门的三个 AI 编程规范工具时，**三者的态度截然不同**。

### 1. Kiro（AWS）—— EARS 的坚定拥趸

| 维度 | 说明 |
|------|------|
| **主格式** | **EARS** |
| **需求文件** | `requirements.md` 里写 `WHEN … THE SYSTEM SHALL …` |
| **Gherkin** | ❌ 不是一等公民 |
| **风格** | EARS + User Story + Tasks |

Kiro **不主打** `Feature: / Scenario: / Examples:` 这种 `.feature` 文件。你可以用 Given-When-Then 思路，但 Kiro 默认**不生成** Cucumber 风格文件。它更像是一个"EARS + 用户故事 + 任务拆解"的工作流。

```markdown

## Requirement 1: User Authentication
WHEN a user submits valid credentials, THE SYSTEM SHALL issue a JWT token.
WHILE the token is valid, THE SYSTEM SHALL allow access to protected endpoints.
IF the token expires, THE SYSTEM SHALL return 401 Unauthorized.
```

✅ **Kiro 定位**：不用 Gherkin 文件格式做主 spec，用 EARS。

---

### 2. GitHub Spec Kit —— Markdown 为主，Gherkin 是 BDD 扩展

| 维度 | 说明 |
|------|------|
| **主格式** | **Markdown spec**（`spec.md` / `proposal.md` / `design.md` / `tasks.md`） |
| **Gherkin** | 🟡 可选/扩展，BDD skill 可导出 `.feature` 文件 |
| **特色命令** | `speckit-bdd-scenarios` → 把 Spec Kit 的 spec 转成 Cucumber 风格 |

Spec Kit 生态里**明确有 Gherkin 用法**。你可以把 spec 写成 Gherkin story：

```gherkin
Feature: Shopping Cart
  Scenario: Add item to cart
    Given a user has an empty cart
    When they add "Laptop" priced at $999
    Then the cart should contain 1 item
    And the total should be $999
```

还可以通过 `speckit-bdd-scenarios` 命令，将 Markdown spec **自动生成**包含 `Background / Scenario Outline / Examples` 的 `.feature` 文件。

✅ **Spec Kit 定位**：Markdown 为主，Gherkin 是 BDD 扩展/导出格式。

---

### 3. OpenSpec —— Given-When-Then 思维，不强制 Gherkin 语法

| 维度 | 说明 |
|------|------|
| **主格式** | **`spec.md` 里写 Requirements + Scenarios** |
| **Scenario 写法** | Given/When/Then 作为 **Markdown 列表** |
| **Gherkin 文件** | ❌ 不强制 `Feature:` / `Scenario:` / `Examples:` 关键字块 |
| **核心概念** | `specs/` / `changes/` / `ADDED/MODIFIED/REMOVED` / `proposal/design/tasks` |

OpenSpec 关心的是**变更驱动的规格管理**，Given-When-Then 只是"场景表达法"，不是 Cucumber 语法载体：

```markdown
#### Scenario: Valid login
- GIVEN a user with valid credentials
- WHEN the user submits the login form
- THEN a JWT token is returned
```

✅ **OpenSpec 定位**：Given-When-Then 思维，不强制 Gherkin 文件格式。

---

## 五、全景对比：谁真的在用 Gherkin 完整格式？

| 工具 | 用 `Feature/Scenario/Background/Scenario Outline/Examples` 吗 |
|------|----------------------------------------|
| **Cucumber / SpecFlow / Behave** | ✅ 原生用，这就是 Gherkin |
| **Kiro** | ❌ 主要用 EARS |
| **GitHub Spec Kit** | 🟡 主格式不是，但 BDD skill / 命令会生成 Gherkin |
| **OpenSpec** | 🟡 用 Given-When-Then，但不强求 Gherkin 关键字块 |

本文基于《https://en.wikipedia.org/wiki/Easy_Approach_to_Requirements_Syntax》与当前流行 AI 编程工具（Kiro  GitHub Spec Kit  OpenSpec）的实践整理而成。

【SDD04】从 EARS 到 Gherkin：AI 时代需求语法的演进

悟透SDD系列。无论规格驱动开发（SDD）是否普及、是否已是事实标准，都不影响我鼓吹它的合理性。

开发工具

编程语言

架构设计

EARS与Gherkin两种需求语法在AI编程中重获重视，Kiro、GitHub SpecKit、OpenSpec三大工具对其支持各异：Kiro坚定使用EARS句式，SpecKit以Markdown为主并可选导出Gherkin，OpenSpec采用Given-When-Then思维但不强制语法格式。

代码解释

AI编程

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

【SDD04】从 EARS 到 Gherkin：AI 时代需求语法的演进-腾讯云开发者社区-腾讯云

【SDD04】从 EARS 到 Gherkin：AI 时代需求语法的演进

【SDD04】从 EARS 到 Gherkin：AI 时代需求语法的演进

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐