プロンプトは「お願い」ではなく「仕様書」——設計者なら勝てる領域
「AIをうまく使えない」という相談を受けて指示文を見せてもらうと、原因はいつも同じだ。お願いを書いている。いい感じにして、うまくまとめて。AIへの指示は依頼文ではなく仕様書だ。そして仕様書なら、設計者は書き慣れている。この認識ひとつで、AIの出力は別物になる。
Photo: Unsplash「お願い」プロンプトはなぜ失敗するか
うまくいかないプロンプトには共通の型がある。いい感じに、分かりやすく、適切に。形容詞と副詞で書かれた指示だ。人間の部下なら文脈を察して補ってくれるが、AIは察した振りをして、もっともらしい別物を返してくる。曖昧な指示に曖昧さを指摘せず突き進むのが、現状のAIの怖さだ。
人間相手なら通じるのに、と感じるかもしれない。だが思い出してほしい。人間相手でも、曖昧な指示は手戻りを生んできたはずだ。新人に「いい感じに図面をまとめて」と言って、期待通りのものが出てきた経験があるだろうか。AIは、曖昧な指示の弱点を高速で露呈させる装置でもある。
つまりプロンプトの問題は、AIの問題ではなく指示の問題だ。そして曖昧さを排して要求を記述する技術には、製造業に古くからの名前が付いている。仕様書だ。
仕様書には何が書いてあるか
設計者が図面や仕様書を書くとき、無意識にやっていることを分解してみる。まず前提条件を書く。対象は何で、環境は何で、制約は何か。次に要求を書く。何を満たすべきか、数値でどこまで許容するか。そして検収条件を書く。何を確認できたら合格とするか。
この構造は、そのままプロンプトに移植できる。対象のデータと背景を渡し、出力に求める形式と制約を数値で指定し、最後に合格条件を書く。たったこれだけで、AIの出力は目に見えて安定する。魔法の言い回しを探す必要はない。仕様書の作法をそのまま使えばいい。
逆に、仕様書に絶対書かないことを思い出してほしい。いい感じに仕上げること、とは誰も書かない。書いた瞬間に検収できなくなるからだ。プロンプトも同じで、検収できない指示は書いた時点で失敗している。
仕様書型プロンプトの5要素
実務で使っている型を5要素に整理する。第1に前提。対象は何か、読み手は誰か、どんな文脈か。第2に入力。渡すデータの形式と意味。第3に出力仕様。形式、分量、含めるべき項目、除外する項目。第4に制約。してはいけないこと、守るべきルール。第5に合格条件。何を満たせば完了か。
たとえばCATIAのマクロ仕様をAIに整理させるなら、こう書く。前提として対象はV5の図面チェック用マクロで読み手は保守担当。入力として現行コードを渡す。出力は機能一覧の表で、関数名・目的・入出力の3列。制約として推測で機能を書かない、不明な箇所は不明と明記する。合格条件は全関数が表に載っていること。
5要素を毎回全部書く必要はない。だが出力が期待とずれたときは、5要素のどれが欠けていたかを点検すると、原因がすぐ特定できる。ずれの9割は、出力仕様か合格条件の欠落だ。
検収できない指示は、
書いた時点で失敗している。
指示の質を2軸で診断する
チームのプロンプトを診断するとき、私たちは2軸で見る。前提が明示されているか、合格条件が明示されているか。両方あるのが仕様書型で、手戻りが最も少ない。前提だけあって合格条件がないと、文脈は合うが完成度が運任せになる。逆だと、形は整うが的外れが混ざる。
最悪なのは両方ない指示で、これがいわゆるお願い型だ。出力のたびに、なんか違うと感じて書き直しを繰り返す。この書き直しの往復こそが、AI活用の隠れたコストになっている。1回の指示に数分余計にかけて仕様を書くほうが、totalでは圧倒的に速い。
診断は自分の過去の指示履歴でもできる。うまくいった指示とそうでない指示を並べて、2軸で分類してみてほしい。自分の癖がどの象限にあるか、一目で分かるはずだ。
効果は手戻り回数に出る
仕様書型の効果は、出力の質より先に手戻り回数に現れる。社内の作業で計測したところ、お願い型の指示では平均3〜4往復かかっていたやり取りが、5要素を揃えた指示では6割以上が1発、悪くても2往復で収束するようになった。作業時間より精神的な消耗の差が大きい。
副産物もある。仕様書型プロンプトはそのまま再利用資産になる。うまくいった指示は型として保存し、チームで共有できる。お願い型の指示は再現性がないので資産にならない。ここでも、書いたものが蓄積するかどうかの差が付く。
注意点を1つ。仕様を書き込みすぎると、今度はAIの提案力を殺す。探索させたい場面では合格条件を緩め、確定作業では厳密に書く。仕様の解像度を場面で使い分けるのも、設計と同じだ。
設計者なら、勝てる
最後に強調したい。仕様を書く訓練を何年も積んできた職種は、実はそう多くない。設計者は毎日、図面という名の仕様書で、離れた場所の相手に意図を誤解なく伝える仕事をしてきた。公差を決め、条件を明記し、検図で検収する。この能力はプロンプトにそのまま転用できる。
AI時代に価値が上がるのは、流暢な文章を書く力ではなく、要求を仕様に落とす力だ。それはまさに設計者の本業であり、勝てる領域だ。プロンプトという言葉に気後れせず、いつもの仕様書の作法で書いてみてほしい。出力の変化に驚くはずだ。
「AIに何をさせるか」の設計でつまずいたら、声をかけてください。私たちは自社の現場でAIエージェントを回しながら仕組みを作ってきました。その手順をそのままお渡しします。
記事一覧をすべて見る →