本文へスキップ
hdknr blog

EARS 記法

自然言語の要件を 6 つの決まった型(常時・While・When・Where・If/Then・複合)に当てはめて書く記法。Kiro の requirements.md が採用し、AI に書かせた要件の抜けを見つける型として使える

概要

EARS(Easy Approach to Requirements Syntax) は、自然言語の要件を少数の決まった型に当てはめて書く記法である。Rolls-Royce の Alistair Mavin 氏らがジェットエンジン制御の耐空性規則を分析する中で考案し、2009 年の RE’09 で発表した。Airbus・Bosch・NASA・Siemens などが使っている。

形式手法のような厳密な文法ではなく、自然言語のまま文の骨組みだけを揃えるのが特徴で、学習の負担が小さく専用ツールも要らない。Kiro が requirements.md の受け入れ基準に採用したことで、仕様駆動開発 の文脈で広く知られるようになった。

詳細

基本構文

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

事前条件(While)は 0 個以上、トリガー(When)は 0 か 1 個、システム名はちょうど 1 個、応答は 1 個以上。節の順番は時間の流れ(どんな状態で → 何が起きたら → どのシステムが → 何をする)に沿う。

6 つのパターン

パターンキーワード書きたいこと例
常時(Ubiquitous)なしいつでも成り立つ性質・制約The mobile phone shall have a mass of less than XX grams.
状態駆動(State-driven)Whileある状態の間だけの振る舞いWhile there is no card in the ATM, the ATM shall display “insert card to begin”.
イベント駆動(Event-driven)When何かが起きたときの応答When “mute” is selected, the laptop shall suppress all audio output.
オプション機能(Optional feature)Where特定の構成・プランだけの機能Where the car has a sunroof, the car shall have a sunroof control panel on the driver door.
望ましくない振る舞い(Unwanted behaviour)If / Thenエラー・故障・不正入力への対処If an invalid credit card number is entered, then the website shall display “please re-enter credit card details”.
複合(Complex)While + When など状態とイベントの組み合わせWhile the aircraft is on ground, when reverse thrust is commanded, the engine control system shall enable reverse thrust.

正常系の When と異常系の If / Then をキーワードで分けておくと、異常系の要件がいくつ書かれているかを文面から数えられる。異常系を含む複合は While …, if …, then the … shall … と書く。

日本語で書く

骨組みはそのまま使える。言い回しをパターンごとにチームで固定するのがコツで、日本語では「場合」「とき」「ならば」を入れ替えがちなので、たとえばイベントは「とき」、オプション機能は「場合」、異常系は「もし〜ならば」と決める。

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

Kiro や cc-sdd のようにキーワードだけ英語の大文字で残す書き方(WHEN ユーザーがログアウトボタンを押した THE SYSTEM SHALL セッションを破棄する)もある。日本語としては不自然だが、パターンが一目で分かり grep で数えられる。

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

Gherkin への対応

EARSGherkin
While〈事前条件〉、Where〈機能〉Given
When / If〈トリガー〉When
shall〈応答〉Then

If は Gherkin では同じ When になるので、異常系だと分かる名前を Scenario に付ける。要件は EARS で書いて人間がレビューし、受け入れテストは Gherkin で AI に書かせる分担にすると、要件からテストまでを追いやすい(BDD と Gherkin 構文)。

関連ページ

ソース記事