生成AIにテスト観点を出してもらっても、「もっともらしいけれど、期待した内容ではない」と感じたことはないでしょうか。原因は、AIの性能だけではありません。依頼する作業に対して、根拠となる情報や対象範囲が足りていないことがあります。
私自身、開始時には要件と一般的なテスト観点一覧から観点を出そうとしました。しかし、それだけでは仕様から外れた一般論や、実際のテスト環境・担当範囲では実行できない項目が混ざり、期待する粒度の候補になりませんでした。そこで仕様、既存テスト、過去の問題に関する情報などを追加し、何を根拠にするかを分けて渡したところ、レビューしやすい候補に近づきました。
この記事では、AIへ資料を渡す前に確認したい項目を、実務で使える順番に整理します。目的は、資料を大量に投入することではありません。AIに推測で埋めさせず、人が判断できる候補を作らせるための準備です。
先に結論:入力資料は「量」ではなく「役割」をそろえる
テスト観点を作るために、手元の資料をすべてAIへ渡す必要はありません。まず、次の5つを整理します。
- 今回AIに任せる作業と、作りたい成果物
- 対象機能・対象範囲・対象外
- 根拠となる資料と、その版・役割
- 資料内の不足や矛盾
- 入力してよい情報かどうか
この5つが整理されていれば、資料が完全にそろっていなくても小さく始められます。逆に、資料を増やしても役割が曖昧なら、AIが出した候補の根拠を追えず、レビューの負担が増えます。
なぜ要件と一般的な観点一覧だけでは足りなかったのか
最初に要件と一般的なテスト観点一覧を渡す方法には、次のような良さがあります。
- 短時間で候補を多く出せる
- 境界値、状態遷移、権限など、見落としやすい確認軸を思い出せる
- 資料が少ない段階でも検討を始められる
一方で、一般的な観点一覧には、その機能で本当に確認すべきか、実際に実行可能かを判断するための現場情報がありません。仕様に存在しない前提の確認、対象外のテスト、担当外の作業、実際の画面や業務ルールと合わない候補が混ざりやすくなります。
私の場合も、要件と一般的な観点一覧だけでは候補の数は出たものの、仕様に沿っているか、手元の環境・権限・データで実行できるかを判断できない状態でした。対象機能の仕様、既存の回帰確認、過去に問題になった条件とのつながりも弱かったため、仕様や既存テストなどを追加しました。
重要なのは、一般的な観点一覧を使わないことではありません。一般知識から出た候補と、仕様や既存テストに根拠がある候補を分けて扱うことです。前者は「検討候補」、後者は「資料に基づく候補」として、人が採否を判断します。
AIに渡す情報の種類と役割は、AIでテスト観点の網羅性を高める、渡すべき8種類の情報で詳しく紹介しています。実際に資料から観点候補を作る流れは、Claude Codeでテスト観点を作る手順を参照してください。この記事では、その前段となる、情報を渡す前の整え方に絞ります。
入力資料を準備する5つの確認項目
1. 先に「何を作らせるか」を決める
同じ資料でも、テスト観点の候補を作るのか、確認項目を具体化するのか、テストケースの手順まで作るのかで、必要な情報は変わります。
最初に、AIへ任せる作業を一文で書き出します。
通知設定機能について、システムテストで人がレビューするテスト観点候補を作る。
ここで「完成したテストケースを作る」と曖昧に頼むと、AIは前提条件、操作、期待結果を推測して埋めることがあります。初回は、根拠と要確認事項を含む観点候補に留める方が安全です。
テスト観点からテストケースへ具体化する流れは、Claude Codeでテスト観点からテストケースを作る手順で解説しています。
2. 対象と対象外を明確にする
「通知設定」とだけ書かれていても、通知種別、利用者の権限、画面操作、保存処理、外部配信まで、確認対象になり得る範囲は複数あります。今回どこまでを扱うかを決めずに資料を渡すと、AIは広い範囲を候補に含めます。
たとえば、次のように分けます。
| 項目 | 今回の例 |
|---|---|
| 対象 | 通知設定画面での表示、変更、保存結果 |
| 対象ユーザー | 設定変更権限を持つ一般利用者 |
| テストレベル | システムテスト |
| 対象外 | メール配信基盤の内部処理、性能試験、脆弱性診断 |
| 出力 | テスト観点、確認したいリスク、根拠、要確認事項 |
対象外は、候補を減らすためだけの指定ではありません。誰が確認するか、どの環境・データ・権限で実行できるかを明確にし、担当外または実行不能な項目をもっともらしいテストとして採用してしまうことを防ぐためのものです。
3. 資料に「役割」と「版」を付ける
仕様、既存テスト、過去障害を追加するときは、ファイル名だけを列挙しないでください。各資料から何を読み取りたいかを伝えます。
| 資料 | 役割 | AIへの指示例 |
|---|---|---|
| 要件・要求 | 利用目的と対象範囲を理解する | 重要な利用者・業務上の影響を把握するために使う |
| 機能・UI仕様 | 条件、状態、期待結果を確認する | 候補の根拠として該当箇所を示す |
| 既存テスト | 維持すべき回帰確認と用語を把握する | 正解として複製せず、重複や根拠未確認も示す |
| 過去障害・問い合わせ | 見落としやすいリスクを知る | 個別事象を写さず、再確認すべきリスクへ変換する |
| 一般的な観点一覧 | 資料だけでは気づきにくい確認軸を補う | 資料に基づく候補とは分けて「検討候補」として出す |
資料には、可能なら版番号・更新日・対象機能も付けます。古い既存テストや障害票を、現在の仕様と同じ前提で扱わないためです。資料同士で内容が違うときは、AIにどちらが正しいかを決めさせず、「要確認事項」として出力させます。
4. 足りない情報は「推測させない」と決める
資料が不足していると、AIは自然な文章で空白を埋めようとします。しかしQAでは、その補完が誤った前提や存在しない仕様を混ぜる原因になります。
たとえば、通知設定の初期値が資料にないなら、「初期値はこうであるはず」と候補を確定させるのではなく、次のように扱います。
初期値に関する根拠が資料にない場合は、推測でテスト条件を作らない。確認が必要な仕様として、要確認事項に記載する。
不足情報は失敗ではありません。確認が必要な点を早い段階で見つけられたこと自体が、AIを使う価値の一つです。AI出力をどこまで信用し、何を人が決めるかは、AI出力はどこまで信用できる?QAでの整理・抽出・最終判断の分け方も参考にしてください。
5. 入力前に機密性を確認する
仕様書、テストケース、障害票には、顧客名、個人情報、認証情報、未公開機能、社内の運用情報が含まれることがあります。資料の品質を上げるために、入力してはいけない情報まで渡してはいけません。
入力前に、次を確認します。
- 利用するAIサービスと組織のルールで、その資料を入力してよいか
- 固有名詞、ID、メールアドレス、URL、画面キャプチャに含まれる情報を匿名化できるか
- 元の意味を保ったまま、架空の名称や抽象的な値に置き換えられるか
- 出力をどこへ保存・共有するか
機密情報を扱う際の確認項目は、QA業務で機密情報を守って生成AIを使うための6つの確認項目にまとめています。
実務で使える入力資料準備チェックリスト
AIへ資料を渡す直前に、次の項目を確認します。
作業の目的
- □ AIに作らせる成果物を決めた(観点候補、確認項目、テストケースなど)
- □ 完成品ではなく、人がレビューする候補を作らせることを明記した
- □ 出力に含める項目(リスク、根拠、要確認事項など)を決めた
対象範囲
- □ 対象機能、対象ユーザー、対象画面または操作を決めた
- □ テストレベルと、今回扱うテストタイプを決めた
- □ 対象外の機能、作業、テストを明記した
根拠資料
- □ 仕様・既存テスト・過去障害など、資料ごとの役割を決めた
- □ 資料の版、更新日、対象範囲を確認した
- □ 既存テストや過去障害を、現在の正解としてそのまま扱わない方針を決めた
- □ 一般的な観点一覧からの候補と、資料に根拠がある候補を分けるよう指示した
不足・矛盾
- □ 資料にない仕様をAIが推測で補わないよう指示した
- □ 資料間の矛盾は、要確認事項として出力させるようにした
- □ 出力をレビューし、必要な資料を追加する前提にした
安全な利用
- □ 入力してよい情報か、組織のルールと利用サービスの条件を確認した
- □ 固有名詞や識別情報を匿名化・抽象化した
- □ 出力の保存先と共有範囲を決めた
入力資料を渡すときの指示例
資料そのものに加えて、次のような作業条件を付けると、AIが資料の役割を取り違えにくくなります。
“`text あなたはQA担当者の作業を補助します。 以下の資料を基に、通知設定機能のシステムテストにおける テスト観点候補を作成してください。完成したテストケースは作成しません。
【対象】
- 通知設定画面での表示、変更、保存結果
- 設定変更権限を持つ一般利用者
【対象外】
- メール配信基盤の内部処理
- 性能試験、脆弱性診断
【資料と役割】
- 要求:利用目的と対象範囲を確認する
- 仕様:条件、状態、期待結果の根拠にする
- 既存テスト:回帰確認と用語を確認する。正解として複製しない
- 一般的な観点一覧:追加で検討すべき確認軸を出す。資料に基づく候補とは分けて「検討候補」とする
【出力ルール】
- 「観点/確認したいリスク/根拠資料と箇所/要確認事項」を表にする
- 資料に根拠がない内容は「検討候補」と明記する
- 資料にない仕様、資料間の矛盾は推測で補わず、要確認事項にする
- 対象外に当たる候補は出力しない

