AI・エージェント

プロンプトは「お願い」ではなく「仕様書」——設計者なら勝てる領域

2026.01.27 / 読了目安 7分 / 執筆: Qronix 開発チーム

#AIエージェント#設計思想#現場主義

「AIをうまく使えない」という相談を受けて指示文を見せてもらうと、原因はいつも同じだ。お願いを書いている。いい感じにして、うまくまとめて。AIへの指示は依頼文ではなく仕様書だ。そして仕様書なら、設計者は書き慣れている。この認識ひとつで、AIの出力は別物になる。

設計図面Photo: Unsplash
CONTENTS
1. 「お願い」プロンプトはなぜ失敗するか 2. 仕様書には何が書いてあるか 3. 仕様書型プロンプトの5要素 4. 指示の質を2軸で診断する 5. 効果は手戻り回数に出る 6. 設計者なら、勝てる

「お願い」プロンプトはなぜ失敗するか

うまくいかないプロンプトには共通の型がある。いい感じに、分かりやすく、適切に。形容詞と副詞で書かれた指示だ。人間の部下なら文脈を察して補ってくれるが、AIは察した振りをして、もっともらしい別物を返してくる。曖昧な指示に曖昧さを指摘せず突き進むのが、現状のAIの怖さだ。

人間相手なら通じるのに、と感じるかもしれない。だが思い出してほしい。人間相手でも、曖昧な指示は手戻りを生んできたはずだ。新人に「いい感じに図面をまとめて」と言って、期待通りのものが出てきた経験があるだろうか。AIは、曖昧な指示の弱点を高速で露呈させる装置でもある。

つまりプロンプトの問題は、AIの問題ではなく指示の問題だ。そして曖昧さを排して要求を記述する技術には、製造業に古くからの名前が付いている。仕様書だ。

仕様書には何が書いてあるか

設計者が図面や仕様書を書くとき、無意識にやっていることを分解してみる。まず前提条件を書く。対象は何で、環境は何で、制約は何か。次に要求を書く。何を満たすべきか、数値でどこまで許容するか。そして検収条件を書く。何を確認できたら合格とするか。

この構造は、そのままプロンプトに移植できる。対象のデータと背景を渡し、出力に求める形式と制約を数値で指定し、最後に合格条件を書く。たったこれだけで、AIの出力は目に見えて安定する。魔法の言い回しを探す必要はない。仕様書の作法をそのまま使えばいい。

逆に、仕様書に絶対書かないことを思い出してほしい。いい感じに仕上げること、とは誰も書かない。書いた瞬間に検収できなくなるからだ。プロンプトも同じで、検収できない指示は書いた時点で失敗している。

仕様書型プロンプトの5要素

実務で使っている型を5要素に整理する。第1に前提。対象は何か、読み手は誰か、どんな文脈か。第2に入力。渡すデータの形式と意味。第3に出力仕様。形式、分量、含めるべき項目、除外する項目。第4に制約。してはいけないこと、守るべきルール。第5に合格条件。何を満たせば完了か。

たとえばCATIAのマクロ仕様をAIに整理させるなら、こう書く。前提として対象はV5の図面チェック用マクロで読み手は保守担当。入力として現行コードを渡す。出力は機能一覧の表で、関数名・目的・入出力の3列。制約として推測で機能を書かない、不明な箇所は不明と明記する。合格条件は全関数が表に載っていること。

5要素を毎回全部書く必要はない。だが出力が期待とずれたときは、5要素のどれが欠けていたかを点検すると、原因がすぐ特定できる。ずれの9割は、出力仕様か合格条件の欠落だ。

検収できない指示は、
書いた時点で失敗している。

仕様書型プロンプトの5要素1前提対象・読み手・文脈2入力渡すデータの形式と意味3出力仕様形式・分量・含める項目4制約禁止事項・守るルール5合格条件何を満たせば完了か
ずれたときはどの要素が欠けたかを点検する

指示の質を2軸で診断する

チームのプロンプトを診断するとき、私たちは2軸で見る。前提が明示されているか、合格条件が明示されているか。両方あるのが仕様書型で、手戻りが最も少ない。前提だけあって合格条件がないと、文脈は合うが完成度が運任せになる。逆だと、形は整うが的外れが混ざる。

最悪なのは両方ない指示で、これがいわゆるお願い型だ。出力のたびに、なんか違うと感じて書き直しを繰り返す。この書き直しの往復こそが、AI活用の隠れたコストになっている。1回の指示に数分余計にかけて仕様を書くほうが、totalでは圧倒的に速い。

診断は自分の過去の指示履歴でもできる。うまくいった指示とそうでない指示を並べて、2軸で分類してみてほしい。自分の癖がどの象限にあるか、一目で分かるはずだ。

指示の質の4象限前提のみ:<br>文脈は合うが完成度が運任せ仕様書型:<br>手戻り最少・再利用できるお願い型:<br>書き直しの往復が続く条件のみ:<br>形は整うが的外れが混ざる前提が明示 →合格条件が明示 →
前提の明示×合格条件の明示で診断する

効果は手戻り回数に出る

仕様書型の効果は、出力の質より先に手戻り回数に現れる。社内の作業で計測したところ、お願い型の指示では平均3〜4往復かかっていたやり取りが、5要素を揃えた指示では6割以上が1発、悪くても2往復で収束するようになった。作業時間より精神的な消耗の差が大きい。

副産物もある。仕様書型プロンプトはそのまま再利用資産になる。うまくいった指示は型として保存し、チームで共有できる。お願い型の指示は再現性がないので資産にならない。ここでも、書いたものが蓄積するかどうかの差が付く。

注意点を1つ。仕様を書き込みすぎると、今度はAIの提案力を殺す。探索させたい場面では合格条件を緩め、確定作業では厳密に書く。仕様の解像度を場面で使い分けるのも、設計と同じだ。

5要素を揃えた指示が1発で収束した割合60%6割以上悪くても2往復で収束。消耗の差が大きい
社内作業での計測。お願い型は平均3〜4往復だった
仕様書型プロンプトを書いて直す流れAIに頼みたい作業がある前提・入力・出力仕様・制約を書く探索させたい場面?合格条件を緩めに書く合格条件を厳密に書くAIに渡して出力を見る期待どおりに出た?5要素のどれが欠けたかを点検型として保存しチームで共有再利用できる資産になる探索確定作業ずれた出た
図4: 場面で合格条件の厳しさを決め、ずれたら5要素の欠けを点検し、うまくいった指示は型にする。

設計者なら、勝てる

最後に強調したい。仕様を書く訓練を何年も積んできた職種は、実はそう多くない。設計者は毎日、図面という名の仕様書で、離れた場所の相手に意図を誤解なく伝える仕事をしてきた。公差を決め、条件を明記し、検図で検収する。この能力はプロンプトにそのまま転用できる。

AI時代に価値が上がるのは、流暢な文章を書く力ではなく、要求を仕様に落とす力だ。それはまさに設計者の本業であり、勝てる領域だ。プロンプトという言葉に気後れせず、いつもの仕様書の作法で書いてみてほしい。出力の変化に驚くはずだ。

「AIに何をさせるか」の設計でつまずいたら、声をかけてください。私たちは自社の現場でAIエージェントを回しながら仕組みを作ってきました。その手順をそのままお渡しします。

Qronix 開発チーム

CATIA歴22年超・愛知県の大手自動車メーカー及びグループ各社でCATIAツール開発の技術責任者を務めたメンバーを中心とする、CAD自働化のスペシャリスト集団。2024年創業、特許第7907964号を保有。

「うちの資産でもできる?」
まずその質問からどうぞ。

できる・できないの判定と自働化設計書のご提案までは無料です。

contact@qronix.jp へ相談する
記事一覧をすべて見る →
← 記事一覧へトップページへ →