「いい感じに直して」が通用しない時代へ——AIコーディングツールで求められる「明示的な指示」の技術

チャットボットに気軽に相談するだけなら、「いい感じに直して」でも返事は返ってきます。しかし、AIがファイル編集やコマンド実行の権限を持つ時代において、この曖昧さは致命的なコストになります。

Claude Code、Cursor、Devinといった最新のAIコーディングツールは、単なる提案ではなく「実行」を伴います。この違いが、プロンプト設計の重要性を根本的に変えているのです。

実行権限を持つAIツールに曖昧な指示を出すと、以下のような問題が頻発します：

これらは単なる時間の浪費ではありません。本番環境への影響やセキュリティリスクにも直結する問題です。

ChatGPTとの決定的な違い

ChatGPTのような対話型AIでは、出力されたコードを人間が確認し、選択的にコピー&ペーストします。この「人間というフィルター」が最後の防波堤になっていました。

一方、Claude CodeやCursorは**直接ファイルシステムにアクセスし、即座に変更を適用**します。この実行モデルの違いが、プロンプト品質への要求を劇的に高めています。従来は「80点の指示で70点の結果」でも許容できましたが、実行系ツールでは「95点の指示で98点の結果」を目指さなければなりません。

明示的指示のメリットと学習コスト

**メリット**:

**注意点**:

どんな人・場面に向いているか

この手法が特に効果を発揮するのは：

逆に、個人の小規模プロトタイピングでは、ここまでの厳密性は不要かもしれません。状況に応じた使い分けが重要です。

1. 「変更範囲」を明示する

**悪い例**:

このコードを改善して

**良い例**:

src/utils/validator.ts ファイルのみを対象に、
emailValidation 関数の正規表現を RFC 5322 準拠に修正してください。
他のファイルや関数には一切変更を加えないでください。

2. 「完了条件」を定義する

**悪い例**:

プロっぽいデザインにして

**良い例**:

ボタンコンポーネントに以下を適用してください：
- Material Design 3 のElevationレベル2を適用
- ホバー時のアニメーション（200ms ease-in-out）
- 既存のカラーパレット（variables.cssで定義済み）を使用
- 新しい依存関係の追加は不要
完了条件：上記4点が実装され、既存のテストが全てパスすること

3. 「禁止事項」を先に伝える

AIに「やってほしくないこと」を明示するのは非常に効果的です：

以下の制約を守ってリファクタリングしてください：
- node_modules や package.json への変更は禁止
- 既存のAPIインターフェースを変更しないこと
- console.log のデバッグコードを残さないこと
- コメントの削除や変更は不要

この情報は @53able さんの投稿を参考にしています。