Claude Codeの使用から得た実践的なプロンプトエンジニアリングの教訓

効果があったこと：本番コードのリリース

開発経験のないプロジェクトマネージャーのユーザーが、Claude Codeを使用して本番コードを構築しリリースすることに成功しました。作成されたアプリケーションはブラウザで動作し、1,200以上のテストを含んでいます。

中核的な課題：プロンプトの質

特定された主な困難は、プロンプトが正確でない場合、Claude Codeは不十分または誤った結果を生成するという点です。ユーザーは「プロンプトが完璧でなければ、全力で壁に突っ込むことを許してしまう」と述べています。

結果を改善した3つのテクニック

• 2段階プロンプト： プロンプトを一気に書く代わりに、ユーザーは2段階アプローチを採用しました。第1段階では、自分自身のドメイン言語で何を行うか、ルールと望ましい結果を含めて記述します。第2段階では、信頼性エンジニアの視点からプロンプトを書き直し、検証ゲート、単一目的、明示的なセッション境界、およびショートカット防止ルールを追加します。ユーザーは、1段階ではまともな結果が得られるが、2段階では本番レベルの結果が得られると発見しました。
• 1プロンプト＝1目的： 複数の目標を1つのプロンプトにまとめると、一貫して悪い結果につながりました。Claude Codeは1つの目標を優先し、それらを雑に統合するか、両方に対して不完全な解決策を提供しました。ユーザーは「無情な範囲規律」を強調し、1プロンプトあたり1つの目的を持つことを最大の「品質倍増器」として発見しました。
• 具体的な役割定義： 「シニア開発者として行動してください」のような一般的な役割指示は「ほぼ役に立たない」ことがわかりました。効果的な役割は、タスクに必要な専門知識の正確な組み合わせを指定する必要があります。ユーザーは例を示しています：「商業用作曲エンジンを構築した音楽院で訓練を受けた音楽理論家」は、「音楽の専門家」のような曖昧な指示とは根本的に異なり、より良い結果を生み出します。具体性は、出力のトーンだけでなく、モデルの根本的な思考プロセスを変えます。