受け入れ基準

どのようなものか

受け入れ基準とは、個々の変更を受け入れるための条件です。ある状況で何
が観察できればよいかを書きます。「予約確認を送る」は機能を示す言葉で
す。「空き枠を予約したら、確認画面に予約記録と同じ受付番号と開始時刻
が表示される」なら、機能の一部を実際に確かめられます。確認画面をどう
作るかは、チームが決められます。

英国政府のデジタルサービス用マニュアルでは、ユーザーストーリーに対応
する受け入れ基準を、サービスが役割を果たしたか確認するための結果の一
覧として扱っています。ストーリーは、誰が何を必要としているかを伝えま
す。基準は、その合意を話し合い、実装し、確認できるところまで具体化し
ます。その変更を受け入れるかどうかに関係するなら、エラー時の挙動、ア
クセシビリティ、運用上の制約も基準に含まれます。必要になる証拠は、基
準によって異なります。

仕様書には複数の変更に共通する要求を記せます。テストケースは、一つ以
上の基準を確認するための具体的な実行条件を示します。スクラムの完成の
定義は、インクリメントに含める作業が満たすべき品質上の条件を示すもの
です。受け入れ基準は個々の変更で必要な挙動を定めます。例えば、対話型
の機能はすべてキーボードで操作できることを共通の条件とし、新しいカレ
ンダーでは日時を選び、選んだ予約を後から表示できることまで確認しま
す。

なぜ重要なのか

基準を具体的にすると、まだ計画を変えやすいうちに期待の違いが分かりま
す。運用担当者にとっては、記録が作られた時点で予約が成立しているかも
しれません。利用者はメールが届くまで確定したと思わず、問い合わせ窓口
はメールがなくても照合できる受付番号を必要とするかもしれません。それ
ぞれ異なる結果です。どの時点で予約の確定を表示するか、メールが届かな
かったらどうするかを事前に決めておけば、公開後に初めて問題に気付く事
態を避けられます。

検証する側も着目点を絞れます。ある担当者は確認画面を点検し、別の担当
者は制御できる環境でメッセージの送信を中断します。どちらも、何が観察
できれば基準を満たすか分かっています。アクセシビリティには、自動検査
に加えてキーボードで実際に操作する確認が必要な場合があります。応答時
間の上限を確かめるなら、測定環境と負荷を定めます。「すばやく応答す
る」だけでは、合意が取れたように見えても複数の読み方が残ります。

基準に書き写していない規格や法令も適用されます。共通の規則をその変更
にどう当てはめるか、チームの間で解釈が分かれそうな場合は明記します。
導入した日付選択欄なら、どの操作をキーボードで行える必要があるかを挙
げ、既存の規格を示します。根拠が別にある決まりを一から書き直さずに、
画面上で確認できる条件を残せます。

実際の活用例

予約を受け付け、確認のメッセージを送るサービスを想定します。最初の案
には「日時を予約でき、メールが送られる」とあります。サービス責任者、
開発者、検証担当者が、以下の三つの場面を一緒に検討するとします。これ
らは説明用の例で、実際の条件はサービスを担当するチームが決めます。

  * 指定したタイムゾーンで 14
時の枠が空いていれば、確定した予約が一件だけ作成されます。画面の受付
番号、日付、開始時刻は予約記録と一致します。

  *
要求が処理される時点ですでに枠が埋まっていれば、空きがないことが表示
され、利用者は空き枠一覧に戻れます。埋まった枠に二件目の予約は作成さ
れません。

  *
予約の確定後にメッセージの配信が失敗しても、予約は保持されます。画面
で受付番号を確認でき、後続の対応を担当する人が配信失敗を把握できま
す。

各例には前提となる状態、操作、確かめられる結果があります。Gherkin の
Given、When、Then
は、この順番で状況を表します。日本語では「前提」「もし」「ならば」を
使えます。担当者同士で読み合わせたり、自動テストと関連付けたりするの
に役立ちます。単純な変更であれば、短い一覧でも十分です。どちらの形式
でも、受付番号をどの記録と照合するのか、結果を誰の視点から見るのかを
明らかにします。メールが送信キューを出たことが分かっても、受信したこ
とまでは確認できません。

最初の場面は実際の操作画面で調べます。二つ目では、要求が処理される順
番を制御します。三つ目では、予約を保存してから送信の失敗を発生させま
す。別の人が再現できるように、条件と観察結果を作業記録に残します。当
サイトのアクセシビリティ声明にも、実際の操作をどう確認したかを示す例
があります。キーボードでの確認について、観察できたことと今後調べる項
目を区別しています。

問題が起きるところ

曖昧な言葉は、判断を先送りにします。「エラーを適切に処理する」だけで
は、画面の表示も、利用者が次にできることも分かりません。どの状態で何
を知らせ、できる操作をどう残し、どの副作用を防ぐかを書きます。予約の
例では、空きがないと表示された画面の画像だけでは、重複した予約が保存
されていないことまで分かりません。保存された予約を併せて検証します。

必要性を確かめずに実装方法を条件にする書き方もあります。「新しい
キューを使う」は妥当な設計判断かもしれませんが、メッセージが遅れた場
合に起こることを説明していません。技術上の判断は理由を記録できる場所
に残し、基準には観察できる挙動を書きます。外部システムとの連携で特定
のプロトコルが必須なら、その根拠と適用される範囲を記します。

反対に、一覧が長くなり、リリース全体を説明するものになることもありま
す。作業を結果ごとに分け、重要なエラー時の挙動は対応する機能と一緒に
扱います。共通の制約と、今回の変更を誰が検証するかを決めます。試作や
テストで条件の抜けが見つかったら、基準を変更した理由を記録して、影響
のある検証をやり直します。後から読む人が、どの合意について何を検証し
たのかを追えるようになります。

参考資料

  * 英国政府のサービスマニュアルのユーザーストーリーと受け入れ基準

  * Cucumber の Gherkin リファレンス

  * スクラムガイドの完成の定義

  * キーボード操作の確認に関する W3C の解説

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/acceptance-criteria/	engineer.company	70
