本文へスキップ
hdknr blog
戻る

EARS 記法とは? 6 つのパターンと日本語での書き方・Kiro での使い方

EARS(Easy Approach to Requirements Syntax) は、自然言語で書く要件を、いくつかの決まった型に当てはめて書くための記法です。たとえば次のような形をしています。

When "mute" is selected, the laptop shall suppress all audio output.

Kiro が requirements.md の受け入れ基準に採用しました。そのため、仕様駆動開発(SDD)の文脈で名前を見かけることが増えています。

この記事では、EARS の成り立ちと 6 つのパターンを、考案者の公式ガイドに沿って整理します。そのうえで、日本語で書くときの工夫と、AI コーディングエージェントに渡す要件として使うときのポイント、Gherkin のテストへのつなげ方をまとめます。

SDD の全体像は「仕様駆動開発(SDD)とは? 3 つのアプローチ・EARS 記法・Kiro / Spec Kit・TDD との違い」で扱っています。

EARS の成り立ち

EARS は、Rolls-Royce の Alistair Mavin 氏らが考案した記法です。ジェットエンジン制御システムの耐空性(航空機が安全に飛行できる状態)に関する規則を分析する中で生まれました。論文は 2009 年の国際会議 RE’09(17th IEEE International Requirements Engineering Conference)で発表されています(Mavin, Wilkinson, Harwood, Novak「Easy Approach to Requirements Syntax (EARS)」)。

公式ガイド(alistairmavin.com/ears)では、Airbus・Bosch・Dyson・Honeywell・Intel・NASA・Siemens などが利用している組織として挙げられています。特徴として強調されているのは次の点です。

形式手法(数学的な記法で仕様を厳密に書く手法)のように厳密な文法を持つわけではありません。あくまで「自然言語のまま、文の骨組みだけを揃える」記法です。だからこそ、レビューする人も、受け取る AI も、特別な知識なしで読めます。

EARS の基本構文

どの要件も、次の骨組みから必要な部分だけを取り出した形になります。

While <省略可能な事前条件>, when <省略可能なトリガー>, the <システム名> shall <システムの応答>

要素ごとの個数のルールは次のとおりです。

要素個数
事前条件(While)0 個以上
トリガー(When)0 個または 1 個
システム名ちょうど 1 個
システムの応答(shall の後)1 個以上

節の順番はいつも同じで、時間の流れに沿っています。「どんな状態のときに」→「何が起きたら」→「どのシステムが」→「何をするか」の順です。

EARS の 6 つのパターン(While / When / Where / If-Then)

公式ガイドの定義と例文を、日本語訳とあわせて示します。

1. 常時(Ubiquitous)— キーワードなし

条件なしに、常に成り立つ要件です。

The <システム名> shall <システムの応答>

The mobile phone shall have a mass of less than XX grams. (携帯電話の質量は XX グラム未満でなければならない)

2. 状態駆動(State-driven)— While

ある状態が続いている間、成り立つ要件です。

While <事前条件>, the <システム名> shall <システムの応答>

While there is no card in the ATM, the ATM shall display “insert card to begin”. (ATM にカードが入っていない間、ATM は「カードを挿入してください」と表示しなければならない)

3. イベント駆動(Event-driven)— When

あるイベント(トリガー)が起きたときの応答を定める要件です。ユーザーの操作や外部からの通知など、多くの場面で使います。

When <トリガー>, the <システム名> shall <システムの応答>

When “mute” is selected, the laptop shall suppress all audio output. (「ミュート」が選ばれたとき、ノート PC はすべての音声出力を止めなければならない)

4. オプション機能(Optional feature)— Where

その機能や構成を持つ製品だけに当てはまる要件です。製品ラインや、プランによって機能が変わるサービスで使います。

Where <機能が含まれる>, the <システム名> shall <システムの応答>

Where the car has a sunroof, the car shall have a sunroof control panel on the driver door. (サンルーフを備える車では、運転席のドアにサンルーフの操作パネルがなければならない)

5. 望ましくない振る舞い(Unwanted behaviour)— If / Then

エラー、故障、不正な入力など、起きてほしくない状況への応答を定める要件です。

If <トリガー>, then the <システム名> shall <システムの応答>

If an invalid credit card number is entered, then the website shall display “please re-enter credit card details”. (無効なクレジットカード番号が入力された場合、Web サイトは「カード情報を再入力してください」と表示しなければならない)

正常系の When と、異常系の If / Then を分けて書けるのが、このパターンの大事なところです。キーワードで区別しておけば、異常系の要件がいくつ書かれているかを文面から数えられます。

6. 複合(Complex)— While + When など

複数のキーワードを組み合わせた要件です。

While <事前条件>, when <トリガー>, the <システム名> shall <システムの応答>

While the aircraft is on ground, when reverse thrust is commanded, the engine control system shall enable reverse thrust. (航空機が地上にある間に逆推力が指令されたとき、エンジン制御システムは逆推力を有効にしなければならない)

異常系を含む複合の要件は、If / Then を使って書きます。

While <事前条件>, if <トリガー>, then the <システム名> shall <システムの応答>

EARS のパターンを選ぶ早見表

書きたいことパターンキーワード
いつでも成り立つ性質・制約常時なし
ある状態の間だけ成り立つ振る舞い状態駆動While
何かが起きたときの応答イベント駆動When
特定の構成・プランにだけある機能オプション機能Where
エラー・故障・不正入力への対処望ましくない振る舞いIf / Then
状態とイベントの組み合わせ複合While + When など

日本語で書くときの工夫

EARS は英語の文型を前提にしていますが、日本語でも骨組みはそのまま使えます。コツは、キーワードに当たる言い回しを決めておくことです。

パターン日本語の型の例
常時〈システム名〉は〈応答〉しなければならない
状態駆動〈事前条件〉の間、〈システム名〉は〈応答〉しなければならない
イベント駆動〈トリガー〉とき、〈システム名〉は〈応答〉しなければならない
オプション機能〈機能〉がある場合、〈システム名〉は〈応答〉しなければならない
望ましくない振る舞いもし〈トリガー〉ならば、〈システム名〉は〈応答〉しなければならない
複合〈事前条件〉の間に〈トリガー〉とき、〈システム名〉は〈応答〉しなければならない

日本語では「場合」「とき」「ならば」を入れ替えて使いがちです。EARS として書くなら、言い回しをチーム内で固定しましょう。たとえばイベントは「とき」、オプション機能は「場合」、異常系は「もし〜ならば」とすると、文面だけでパターンを判別できます。

Kiro のように、キーワードだけ英語の大文字で残す書き方もあります。

WHEN ユーザーがログアウトボタンを押した THE SYSTEM SHALL セッションを破棄する

日本語の文としては自然ではありませんが、パターンが一目で分かり、grep で数えられるという利点があります。

AI 駆動開発で EARS を使うときのポイント

Kiro の EARS は簡略版

Kiro のドキュメント(Feature Specs)では、requirements.md の要件を次の形で書くと説明されています。

WHEN [condition/event] THE SYSTEM SHALL [expected behavior]

Kiro そのものの機能(Spec・Steering・Hooks など)は「Kiro とは? AWS の仕様駆動 AI IDE の Spec・Steering・Hooks と料金プラン」で紹介しています。

示されているのはイベント駆動の形だけで、While・Where・If / Then は出てきません。そのため AI に要件を書かせると、すべてが WHEN の文になりがちです。たとえば「誤ったパスワードを 5 回連続で入力した」は不正入力への対処なので、本来は If / Then で書く異常系です。状態に依存する要件や異常系が WHEN の中に紛れ込んでいないか を人間が確かめると、抜けを見つけやすくなります。

異常系の If / Then を数える

AI に要件を書かせて最初に見るべきなのは、If / Then の要件の数です。要件を正常系の When だけで書くと、エラー時の振る舞いを AI が実装の段階で黙って決めることになります。

こうした場面ごとに If / Then の要件があるかを確かめ、なければ足すよう AI に指示します。

1 文 1 応答を守る

「〜し、〜し、さらに〜する」のように応答を詰め込むと、どれが満たされていないのかをテストで判定しにくくなります。公式のルールでは、応答は 1 個以上書いてかまいません。ただし受け入れ基準として使うなら、1 つの要件に 1 つの検証可能な応答 を目安に分けましょう。そうすれば、テストケースと 1 対 1 で対応させられます。

曖昧な形容詞を数値にする

EARS は文の骨組みを揃えますが、「すばやく」「適切に」「十分な」といった言葉の曖昧さまでは取り除きません。公式の例文が「XX グラム未満」と数値で書いているように、応答の中身は測れる値にします。

検索ボタンが押されたとき、検索 API は 95 パーセンタイルで 500 ミリ秒以内に結果を返さなければならない

Gherkin のテストにつなげる

EARS の要件は、Gherkin のシナリオに書き換えられます。対応は次のとおりです。

EARSGherkin
While〈事前条件〉、Where〈機能〉Given(前提)
When / If〈トリガー〉When(操作・出来事)
shall〈応答〉Then(結果)

先ほどの異常系を EARS で書き、Gherkin にすると次のようになります。

もしユーザーが誤ったパスワードを 5 回連続で入力したならば、認証サービスはそのアカウントを 15 分間ロックしなければならない
Feature: ログイン試行の制限
  Scenario: パスワードを 5 回連続で間違えるとロックされる
    Given アカウント "alice" がロックされていない
    When 誤ったパスワードで 5 回連続ログインを試みる
    Then アカウント "alice" は 15 分間ロックされる

要件は EARS で書いて人間がレビューし、受け入れテストは Gherkin や通常のテストコードで AI に書かせます。この分担にすると、要件からテストまでの対応を追いやすくなります。

Gherkin のキーワードや Cucumber での実行方法は「BDD・Gherkin・Cucumber の違いとは? キーワード一覧と日本語での書き方入門」で解説しています。

まとめ



前の記事
BDD・Gherkin・Cucumber の違いとは? キーワード一覧と日本語での書き方入門
次の記事
cc-sdd とは? Claude Code・Codex で Kiro 式の仕様駆動開発を回すスキルと使い方