特許・Qi

設計者のためのAIプロンプト設計——依頼文の書き方

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

#特許Qi#現場主義#AIエージェント

AIに設計の仕事を頼んで期待外れだったとき、多くの場合の原因はAIではなく依頼文にあります。設計者は図面と仕様書で意図を伝える訓練を受けています。その技術はそのままプロンプト設計に使えます。実例で示します。

計画ノートPhoto: Unsplash
CONTENTS
1. AIへの依頼文は、外注の仕様書と同じもの 2. 悪い依頼文の実例と、そこで何が起きるか 3. 良い依頼文の実例——同じ依頼を書き直す 4. 依頼文の型——設計現場で使える5行フォーマット 5. AIにコードを書かせない、という選択

AIへの依頼文は、外注の仕様書と同じもの

はじめて会う外注先に、口頭で「あの穴、いい感じに開けといて」と頼む人はいません。図面を出し、公差を書き、基準面を指定します。AIへの指示も同じです。AIは経験の浅い外注先だと思って書くのがいちばん近い。

違いは、AIが分からないときに聞き返さないことです。人間の外注なら「基準どこですか」と電話がかかってきます。AIは黙って推測で埋めます。だから推測される余地を先に潰しておく必要があります。

つまりプロンプト設計は、新しい技能ではありません。設計者がすでに持っている「曖昧さを潰して伝える」技能を、文章に適用するだけです。書き方のコツは、突き詰めると3つに集約されます。

悪い依頼文の実例と、そこで何が起きるか

まず実際にありがちな依頼文を挙げます。「CATIAでボルト穴を自動で開けるマクロを作って」。これだけです。私たちが現場で見た依頼文の大半が、この粒度です。

この一文からAIが決めなければならないことを数えると、10個以上あります。穴の直径は。座標の与え方はパラメータかExcelか。対象はパートかプロダクトか。既存の穴と重なったらどうするか。座ぐりは要るか。失敗したときロールバックするか。単位はミリか。決めなかったことは、全部AIが勝手に決めます。

結果、それらしいコードが出てきます。動きもします。しかし現場の運用とは噛み合わず、直すより書き直したほうが早い状態になる。「AIは使えない」という結論は、たいていここで生まれています。

もうひとつ悪い依頼文の典型が、「いい感じに」「うまく」「適切に」といった評価語です。評価語は指示ではなく丸投げです。適切という言葉が出てきたら、その裏に数値があるはずなので、それを書きます。

決めなかったことは、
全部AIが勝手に決める。

良い依頼文の実例——同じ依頼を書き直す

先ほどの依頼を書き直します。「CATIA V5のパートに対し、Excelで与えた座標リストからボルト穴を開けるVBAマクロを作ってください。入力はA列にX、B列にY、C列に直径(mm)。対象は現在アクティブなPartDocumentの最初のBody。穴は貫通ではなく深さ12mm固定。既存フィーチャと同じ座標があった場合は作成せずスキップし、スキップした行番号を最後にまとめてMsgBoxで表示。座標が数値でない行があれば処理全体を実行せず、行番号を示して終了してください」。

長いと感じるかもしれませんが、この程度で十分です。ポイントは4つ。入力の形式、対象の範囲、異常時の挙動、出力の形。この4つが埋まっていれば、AIは推測する必要がなくなります。

特に効くのが3つめ、異常時の挙動です。「数値でない行があれば実行せず終了」と書くだけで、生成されるコードの性格が変わります。私たちの言う自働化の思想を、依頼文の中に入れてしまうわけです。

そして重要なのは、この依頼文が自分の頭の整理そのものになっていることです。ここまで書けた時点で、仕様は固まっています。AIを使うかどうかに関わらず、価値があります。

VBA参考実装例:良い依頼文から生成されるコードの骨格(前提検査つき)
Sub CreateHolesFromList()
    Dim oDoc As PartDocument
    ' 前提検査:アクティブがパートでなければ実行しない
    If TypeName(CATIA.ActiveDocument) <> "PartDocument" Then
        MsgBox "パートを開いてから実行してください"
        Exit Sub
    End If
    Set oDoc = CATIA.ActiveDocument

    Dim oBody As Body
    Set oBody = oDoc.Part.Bodies.Item(1)

    ' 座標リストの読み込み(Excelから配列で受け取り済みとする)
    Dim i As Integer
    Dim skipped As String
    For i = LBound(coords, 1) To UBound(coords, 1)
        ' 数値でない行が1つでもあれば全体を中止する
        If Not IsNumeric(coords(i, 1)) Then
            MsgBox i & " 行目が数値ではありません。処理を中止します"
            Exit Sub
        End If
    Next

    Dim oShapeFactory As ShapeFactory
    Set oShapeFactory = oDoc.Part.ShapeFactory
    For i = LBound(coords, 1) To UBound(coords, 1)
        ' 既存穴と同一座標ならスキップし、行番号を記録
        If IsDuplicated(oBody, coords(i, 1), coords(i, 2)) Then
            skipped = skipped & i & ", "
        End If
    Next

    oDoc.Part.Update
    MsgBox "スキップした行: " & skipped
End Sub

冒頭で対象ドキュメントの型を検査し、座標の妥当性を全数チェックしてから初めて造形に入ります。異常時の挙動を依頼文に書いておくと、この構造が自然に出てきます。

依頼文の型——設計現場で使える5行フォーマット

毎回長文を考えるのは大変なので、私たちは社内で5行の型を使っています。目的、入力、対象、異常時、出力。この順に1行ずつ書く。慣れれば2分で書けます。

目的の行では、動詞を1つに絞ります。「作って整理して確認して」ではなく、まず「作る」だけ。1回の依頼に動詞は1つが原則です。複数やらせると、どれも中途半端になります。

入力の行では、実物の一部を貼ります。Excelの3行分、ツリーの構成、命名規約の例。言葉で説明するより、実データを1つ見せるほうが圧倒的に正確に伝わります。これは人間相手でも同じです。

異常時の行を書く習慣は、そのままレビューにも効きます。他人のツールをレビューするとき「異常時どうなりますか」と聞けば、8割のツールでその場では答えが出てきません。そこが弱点です。

AIにコードを書かせない、という選択

ここまでプロンプト設計のコツを書いてきましたが、私たちの本業では少し違うことをしています。AIにコードを生成させていません。特許第7907964号のAIエージェント「Qi」は、検証済みの社内ツールを「選択」するだけです。

理由は品質保証です。AIが生成したコードは、生成のたびに違います。同じ依頼でも次の日には別のコードが出る。それを毎回レビューする体制は、量産設計の現場では回りません。500本を超える検証済みツールから選ばせるほうが、確実で速い。

選択されたツールは、実行前にDSL(私たちが「関所」と呼ぶ層)を通ります。引数の型、対象の状態、権限。ここで弾かれたら実行されません。AIの判断が直接CADに届くことはない設計です。

とはいえ、日常業務でAIにコードや文章を書かせる場面はいくらでもあります。そのとき効くのが、この記事で書いた依頼文の型です。使い分けの基準は、結果を人がレビューできるかどうか。レビューできる規模なら生成させていい。量産に流れるものなら、検証済みのものを選ばせる。

ここまで読んで「うちでもやってみたい」と思われたなら、まずは私たちの無料セミナーをのぞいてみてください。改善を金額で語る考え方を、実例を使って一緒に組み立てます。相談だけでも歓迎です。

生成させるか選ばせるかと依頼文AIに任せたい作業結果を人がレビューできる規模?検証済みツールを選ばせる関所で引数・状態・権限を検査目的:動詞を1つに絞る入力:実データの一部を貼る対象:範囲を明記する異常時:挙動を決めて書く出力:形を指定するAIに生成させ人がレビューする作業に使うできないできる
図1: 人がレビューできる規模なら5行の型で書いて生成させ、量産に流れるものは検証済みツールを選ばせる。
同じ依頼、書き方だけを変えた結果曖昧な依頼文(1行)1割動くが運用と噛み合わず書き直し5行フォーマット7割微修正でそのまま使える
社内で同一タスクを2種類の依頼文で投げ、そのまま現場投入できたかを比較した体感値。
依頼文の5行フォーマット1目的動詞は1つに絞る2入力実データを3行だけ貼る3対象どのドキュメント・どの範囲か4異常時止めるのか、飛ばすのか5出力何をどこにどの形で
この順に1行ずつ。慣れれば2分で書ける。
AIに生成させるか、検証済みツールを選ばせるか検証済みツールを選択させるQiの領域生成禁止。既存ツールのみAI生成でよい試作・調査AI生成+人の全数レビューレビュー負荷が大きい →結果が量産に流れる →
判断軸は「人がレビューできる規模か」と「結果が量産に流れるか」。
Qronix 開発チーム

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

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

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

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