i-Willink
|Tech|✍️ i-Willink

開発者向けプロンプトエンジニアリング——AIコーディング効率を3倍にするテクニック

Claude・ChatGPT・Cursorを使った実践的なプロンプトエンジニアリングを解説。コード生成・デバッグ・テスト作成・ドキュメント化それぞれの最適なプロンプトパターンと、チームで再利用できるプロンプトライブラリの作り方を紹介します。

AIへの指示の質が、出力の質を決めます。

「AIに聞いたけど使えないコードが返ってきた」——これはAIの限界ではなく、プロンプトの問題であることがほとんどです。 本記事では、開発現場で実際に効果を確認したプロンプトパターンを用途別に解説します。

📐効果的なプロンプトの5原則

🎯

文脈を与える

プロジェクトの技術スタック・目的・制約を冒頭で明示する。「Next.js 16 App Router、TypeScript、Tailwind CSS v4を使っています」など。

📋

出力形式を指定する

「TypeScript関数として」「コメント付きで」「テストコードも含めて」など、期待する形式を具体的に指示する。

💡

例(few-shot)を示す

「こういうスタイルのコードを書いてください」と既存コードのスニペットを見せると、スタイルが統一されやすい。

🚫

制約を明示する

「外部ライブラリを追加しないで」「既存のAPIを変えないで」「100行以内で」など、守ってほしい制約を明記する。

📈

段階的に依頼する

一度に複雑な実装を求めるより、「まず設計を考えて」→「次に実装して」と分けるほうが品質が上がる。

用途別プロンプトパターン

コード生成

# コード生成プロンプトテンプレート

以下の条件でTypeScript関数を実装してください:

【技術スタック】Next.js 16 App Router、TypeScript、Prisma

【目的】ユーザーのメールアドレス重複チェックAPI

【入力】`{ email: string }`

【出力】`{ exists: boolean }`

【制約】エラーハンドリングを含む、JSDoc付き、テストコードも作成

【既存コードのスタイル例】(ここに既存コードを貼る)

デバッグ

# デバッグプロンプトテンプレート

以下のエラーを解決してください:

【エラーメッセージ】(エラー全文を貼る)

【発生状況】(いつ・どの操作で発生するか)

【該当コード】(エラーが発生するコードを貼る)

【試したこと】(すでに試した解決策)

【環境】Node.js 22、Next.js 16、TypeScript 5.7

まず原因を3つ仮説立てて、その後で最も可能性の高い解決策を実装してください。

テスト生成

# テスト生成プロンプトテンプレート

以下の関数に対してVitestのユニットテストを書いてください:

【対象コード】(テスト対象の関数を貼る)

【テストフレームワーク】Vitest + happy-dom

【カバーすべきケース】

- 正常系(標準的な入力)

- 異常系(バリデーションエラー)

- 境界値(空文字、最大値、null)

- エラーハンドリング(外部API失敗時)

📚チームで使えるプロンプトライブラリの作り方

効果的なプロンプトをチームで共有・再利用することで、組織全体の開発効率が向上します。

プロジェクトのCLAUDE.mdに記載する

リポジトリルートに CLAUDE.md を置くと、Claude Codeが自動的にプロジェクトのコンテキストとして読み込む。技術スタック・コーディング規約・よく使うプロンプトを記載する。

Notionやドキュメントで管理する

用途別にプロンプトテンプレートを整理し、チームメンバーが追加・改善できるwikiとして運用する。「試して効果があった」ものだけを蓄積するのがコツ。

VS Code スニペットとして保存する

よく使うプロンプトをVS Codeのスニペット(.code-snippets)に登録することで、エディタ上から素早く呼び出せる。

🎯まとめ

  • プロンプトの質がAI出力の品質を決める。文脈・形式・制約を明示する
  • コード生成・デバッグ・テスト生成それぞれにテンプレートを持つ
  • 効果的なプロンプトはCLAUDE.mdやNotionで蓄積・共有する
  • 一度に全部頼まず、設計→実装→テストと段階的に依頼すると品質が上がる

開発パートナーを探していますか?

AIでプロダクトを最速で形にしませんか?

最短1週間でMVPを開発。アイデアの検証から本番リリースまで、i-Willinkがフルサポートします。まずはお気軽にご相談ください。

無料で相談する