要約: VAONは、お客様からいただいた最初のご依頼をAIに読ませ、まだ誰も決めていない事項を7つの分類で洗い出します。データ、承認、例外、権限、外部連携、非機能、対象外です。エンジニアがそのリストを絞り込み、お客様にしか答えられない質問だけを残します。答えの出ていない質問がある間は、仕様を確定しません。
目次
- なぜ仕様書を書く前に、質問を整えるのか
- AIはご依頼の内容から、どう質問を洗い出すのか
- エンジニアは質問リストを、どんな基準で絞り込むのか
- 7分類の質問リストのテンプレート
- AIに資料を確認させて、VAONが分かったこと
- この進め方が向かない場合
- よくあるご質問
1. なぜ仕様書を書く前に、質問を整えるのか
仕様の品質を左右するのは、仕様書の下書きよりも、その前に作る確認事項のリストです。空白のまま書いた下書きは、空白を推測で埋めてしまいます。そして推測は、決定事項とほとんど見分けがつきません。
「仕様書がなくても相談できますか」は、2026年にお客様からいただいたご質問のうち、特に多い3つのひとつでした。お答えは「できます」です。ただし、VAONが最初に行うのは文書の作成ではありません。まだ誰も決めていないことの洗い出しです。
VAONのClaude Codeを使った開発フローでは、これがステップ1にあたります。AIが確認事項を挙げ、エンジニアがお客様に伺う質問を選びます。仕様確定はその次のステップ2です。要件定義全体の期間と費用は、要件定義にかかる期間と費用の目安でご説明しています。本稿では、質問の作り方だけを扱います。
2. AIはご依頼の内容から、どう質問を洗い出すのか
AIで要件の抜け漏れを洗い出すときは、「足りない点はありますか」と漠然と聞くのではなく、決まった分類ごとに読ませると、使える質問が出てきます。漠然と聞くと、長く、重複の多いリストになります。
材料は、お客様からいただいたメール、Excelファイル、打ち合わせの記録です。資料をAIツールに入れるのは、お客様の許可をいただいてからです。AIには分類ごとに、質問1つにつき次の3点を出させます。
- 業務担当の方が読んで分かる言葉で書いた質問
- その質問のきっかけになった、ご依頼資料の該当箇所
- 質問しなかった場合に、開発チームが推測で決めてしまう内容
役に立つのは3点目です。質問しないことの代償が、そこに見えるからです。
3. エンジニアは質問リストを、どんな基準で絞り込むのか
エンジニアが残すのは、お客様側の方が答えられ、その答えによって作るものが変わる質問だけです。AIが出すリストは、お客様にお送りするリストより必ず長くなります。
外す質問は、たいてい次のどれかにあたります。
- ライブラリやテーブル構成など、開発チームが自分で決められる技術的な質問
- いただいた資料にすでに答えがあり、AIが読み落としただけの質問
- 別の質問と内容が重なっている質問
- どう答えていただいても、作るものが変わらない質問
「はい・いいえ」で答える質問は、選択肢の形に書き直します。たとえば「出荷後に注文が取り消された場合、システムは(a)取消を止める、(b)取消を受け付けて返品伝票を作る、(c)その他、のどれにしますか」という形です。お客様の判断が速くなり、答えの読み違いも減ります。
それぞれの質問には、答えていただきたい方も書き添えます。リスト全体をお一人にお送りすると、「たぶん今と同じで」というお答えが増えてしまうためです。
4. 7分類の質問リストのテンプレート
次の7分類の質問リストは、AIに作業を指示するときにも、ご自身でリストを点検するときにも、そのまま写してお使いいただけます。表中の質問は説明のための例で、実際の案件のものではありません。
| 分類 | 質問の例 | 質問しないと、開発側が置く前提 | お客様側で答える方 |
|---|---|---|---|
| データ | 顧客データは今どこにあり、重複はあるか。何年分を移行するか | データはきれいで、全件移行する | 現行システムの運用担当の方 |
| 承認 | いくら以上の注文に承認が必要か。承認者の不在時は誰が代わるか | 承認は1段階、代理なし | 部門責任者の方 |
| 例外 | 一部取消や、請求書発行後の返品はどう扱うか | 通常の流れしかない | 日々その業務を行う方 |
| 権限 | 「管理者」「一般」のほかに、閲覧のみの役割はあるか | 役割は2つ | 管理職の方、セキュリティ担当の方 |
| 外部連携 | どの会計ソフトとデータをやり取りするか。定時か、即時か | 手作業でCSVを出力する | 情報システム担当の方 |
| 非機能 | 同時に使う人数は何人か。データを何年保存するか | 初期設定のまま | 情報システム担当の方、管理職の方 |
| 対象外 | 今回のフェーズで作らない帳票や画面はどれか | 話に出たものはすべて対象 | 予算を決める方 |
最後の「対象外」は、作らないものについての質問なので、忘れられがちです。対象外が明確になっていれば、後から出てきたご要望は変更管理の手順と書面に沿って扱えます。
発注者の立場から要件定義を見直したい場合は、IPA(独立行政法人情報処理推進機構)が2019年に公開したユーザのための要件定義ガイド 第2版も参考になります。
5. AIに資料を確認させて、VAONが分かったこと
VAONが分かったのは、AIは資料の食い違いや空欄を見つけるのは得意でも、どの業務ルールが正しいかは判断できない、ということです。社内プロジェクトで、大規模言語モデル(LLM)に基本設計書を確認させたときの結果です。
AIがよく見つけたのは、2つの資料で記述が食い違っている箇所、エラー時の流れや境界条件の記載漏れ、用語の不統一でした。一方、業務ルール、優先順位、トレードオフ、実際の運用については判断できませんでした。そこでVAONでは、1回目の確認はAI、業務の観点の確認は人、という役割分担にしています。
仕様確定前の質問リストも、同じ考え方で作ります。
日本のお客様とのお仕事では、もう一つ理由があります。日本では、情報を受け取る側が送り手の立場に立って考え、十分に解釈することが期待されます。質問リストは、その「汲み取るべきこと」を、答える方が決まった、書かれた質問に置き換えます。チャットでいただいたお答えも、VAONがフィードバック管理ファイルやバックログに記録し、お客様にご確認いただきます。
6. この進め方が向かない場合
AIで作った質問リストは、業務を担当されている方へのヒアリングの代わりにはなりません。次の4つの場合は、あらかじめお伝えしています。
- 書かれていないルール。 「常連のお客様にはこの上限を適用しない」といった取り決めは、どの資料にも載っていないことがほとんどです。AIは、見えないものについて質問できません。出てくるのはヒアリングのときだけです。
- お客様側に答えられる方がいらっしゃらない場合。 よい質問でも、答える方がいなければ、仕様は推測で埋めることになります。
- 資料をAIツールに渡す許可をいただいていない場合。 エンジニアが同じ7分類で手作業でリストを作ります。時間はかかりますが、考え方は変わりません。
- ごく小さな修正。 ボタンの文言を1か所直すのに、7分類の表は不要です。
質問が多すぎるリストをお送りすることは、絞り込みの作業をお客様に押しつけることになります。そうなったら、絞り込みの工程が抜けていたということです。
7. よくあるご質問
質問リストと要件定義書は、何が違うのですか。 質問リストには、まだ誰も決めていないことを書きます。要件定義書には、決まったことを書きます。VAONはまず質問リストを作り、お客様側の適切な方にお答えいただいてから、その内容を要件定義書に反映します。答えの出ていない項目は「未決」と明記し、推測で埋めることはしません。
技術に詳しくなくても、質問に答えられますか。 答えられます。そのための絞り込みです。開発チームが自分で決められる技術的な質問は外し、お客様の業務についての質問だけを残します。誰が承認するのか、何が例外か、データがどこにあるか、といった内容です。社内の別の方に伺うべき質問には、どなたに確認すればよいかを書き添えます。
AIが社内の資料を読むことはありますか。 お客様の許可がある場合だけです。作業を始める前に、どのデータを使ってよいか、誰が閲覧できるか、資料をAIツールに渡してよいかをお客様と取り決めます。許可をいただいていない場合は、エンジニアが同じ分類で、手作業で質問リストを作ります。時間はかかりますが、絞り込みの考え方は同じです。
質問リストが揃うまで、どのくらいかかりますか。 この工程だけの決まった期間はありません。新規案件では、質問とお答えのやり取りをVAONの仕様確定フェーズの中で行います。期間は通常1〜2週間、大規模な案件では2〜4週間です。進み具合は、お客様側でお答えいただくまでの時間に最も左右されます。
仕様確定のあとで、新しい疑問が出てきたらどうなりますか。 新しい疑問もお伺いしますが、変更管理の手順に沿って扱います。VAONが変更要求を作成し、費用とスケジュールへの影響を書面でお示しし、お客様のご承認後に着手します。ご承認いただいていない作業の請求書をお送りすることはありません。最初の質問リストを丁寧に作るほど、こうしたやり取りは少なくなります。
今日からできることが一つあります。開発会社にお送りする予定のご依頼内容を、上の表の7分類に沿って見直し、分類ごとに質問を1つずつ書いてみてください。ご自身で答えられない分類には、社内で答えられる方のお名前を書き添えます。仕様確定の前に画面を見て確かめる次の工程は、AIでワイヤーフレームを作り、仕様確定前に画面ごとに承認するでご紹介します。
このリストを貴社のご依頼に当てはめてみたい場合は、無料相談(60分)をご利用ください。CEOが同席します。資料のご準備は不要で、ご契約を前提としたものではありません。
執筆者: ダン・ヴァン・ルアン(Đặng Văn Luân)、VAON 創業者・CEO。ハノイ工科大学 HEDSPI 卒業。FPT Softwareを経て、Digital Plus(東京)で5年間、1,000万人が利用するシステムの開発に携わる。その後8年間、従業員120名のITアウトソーシング企業でCOOを務め、ISO 9001・ISO 27001に基づく管理体制を構築。業界経験15年。
参考資料
- IPA(独立行政法人情報処理推進機構)「ユーザのための要件定義ガイド 第2版」2019年9月12日公開:https://www.ipa.go.jp/archive/digital/iot-en-ci/jyouryuu/youkenteigi20190912.html(2026年10月29日確認)