AIコーディングツールに伝わるプロンプトの話し方

背景、制約、完了条件を含む開発依頼は、入力するより話す方が速いことがあります。難しいのは音声認識ではありません。コーディングアシスタントが安全に作業できる構造を与えることです。

Cursor、Claude Codeなどにプロンプトを話すときは、次の方法が役立ちます。

最初に完成形を伝える

冒頭で、作業後にどのような状態にしたいかを伝えます。問題を見つけるまでの経緯から長く話し始める必要はありません。

例えば、次のように始めます。

プロジェクト一覧に空の状態を追加してください。既存のフィルターは維持し、APIのレスポンスは変更しないでください。

これで、アシスタントは目標と重要な境界を把握できます。背景はその後に追加できます。

安定した順序で背景を話す

伝わりやすい口頭プロンプトには、通常四つの要素があります。

1. 結果: 完了時に何ができていればよいか。
2. 場所: どのルート、コンポーネント、ファイル、サービスが関係するか。
3. 制約: 何を変更してはいけないか。
4. 検証: どのように結果を確認するか。

順序を固定すると、長い依頼でも追いやすくなります。重要な制約が背景説明に埋もれることも防げます。

「目標は」「関連するファイルは」「変更しない部分は」「最後に確認することは」のような区切りを使えば、自然な話し方のまま構造を作れます。

コード識別子を普通の文章と分ける

ファイルパス、コマンド、環境変数、シンボル名は、普通の文章より厳密さが必要です。この部分は少しゆっくり話し、別の文に分けます。

役立つ習慣は次のとおりです。

• ファイルの役割を説明してからパスを話す。
• 発音が曖昧な識別子は文字単位で確認する。
• コマンドを独立した文として話す。
• 不確かな名前はリポジトリで確認するよう依頼する。
• シークレット、トークン、認証情報は読み上げない。

頻繁に使う製品名、社内サービス名、技術略語はTypeoffのカスタム辞書に登録すると認識が安定します。

作業範囲を明確にする

コーディングアシスタントは、意図した範囲より広く変更できる場合があります。対象外の内容も明確に伝えてください。

よく使う境界には次のものがあります。

• 公開APIの動作を変更しない。
• 既存のキーボード操作とアクセシビリティを維持する。
• 関係のないファイルを変更しない。
• データベース操作は読み取り専用にする。
• 差分を確認するまでコミットやデプロイをしない。

これらは飾りではなく、実際の操作を制御する情報です。作業が始まる前に伝えます。

確認方法で依頼を締めくくる

結果の判断方法がなければ、依頼は完成していません。確認する方向を伝えたうえで、実際のコマンドはリポジトリを調べてから選んでもらいます。

確認方法には次のようなものがあります。

• 対象を絞った単体テストまたは結合テスト
• リポジトリのビルドと型チェック
• 実際のブラウザで対象ルートを確認
• 最終差分のレビュー
• 関係のない動作が維持されていることの確認

画面の変更では、確認する表示幅と操作を伝えます。バックエンドの変更では、結果を観察できる境界を指定します。

影響の大きい依頼は送信前に確認する

音声は意図を伝えるのに便利ですが、コマンドの結果は残ります。削除、デプロイ、本番データ、決済、認証情報に関わる依頼は、送信前に全文を確認してください。

通常のリファクタリングや調査なら短い確認で十分です。破壊的な操作や外部への変更では、口述したプロンプトを自分で実行するコマンドと同じように扱います。

すべてのプロンプトを長くする必要はありません。結果、場所、境界、確認方法がそろっていることが重要です。