【実践】AIエージェントでのコーディング指南書 - 4ヶ月の開発から学ぶプロンプト術

Wed, 07 Jan 2026 10:00:00 +0900

はじめに

「AIエージェントを使ってみたけど、うまく動かない」「何を指示すればいいかわからない」——そんな声をよく聞きます。

この記事は、約4ヶ月間AIエージェント（Claude Code、Codex CLIなど）を使って開発してきた経験から見つけた、効果的なパターンをまとめた指南書です。これまで各自が試行錯誤しながら使ってきましたが、知見が整理されないまま属人化していました。開発チームに新メンバーが加わったこのタイミングで、改めてノウハウを整理・共有することにしました。

1. 効果的なプロンプトの書き方

1.1 「@ファイルパス」でコンテキストを明示する

AIエージェントは賢いですが、読心術は使えません。どのファイルの話をしているのか、明示的に教えてあげましょう。

1
2
3
4
5
6
7


❌ 悪い例：
「このエラーを直して」

✅ 良い例：
「@src/components/user-profile/sections/department-info.tsx
について、部署名がIDのまま表示されてしまっています。
原因を調査して修正してください。」

Anthropic のベストプラクティスでも、「giving clear directions upfront reduces the need for course corrections later」（最初に明確な指示を与えることで、後から軌道修正する必要が減る）と述べられています¹。

@記法のポイント：

ポイント	良い例	悪い例
フルパスで指定	`@src/components/.../file.tsx`	`file.tsx を見て`（どこにあるか不明）
複数ファイル比較時	両方のパスを明示	「もう一つのファイルと比較して」

1.2 問題の背景・文脈を詳細に説明する

実際の開発で効果的だったプロンプトパターンを見てみましょう。

1
2
3
4
5
6
7


元請けベンダーから以下の質問が来ています。
コードベースやSalesforceの現在のライセンス構成での
ガバナ制限など、Context7やネット調査も含めて調査してください。

---

[質問内容をそのまま貼り付け]

このプロンプトには以下の要素が含まれています。

MCP on Feature Branch Tech Blog

【実践】AIエージェントでのコーディング指南書 - 4ヶ月の開発から学ぶプロンプト術

はじめに

1. 効果的なプロンプトの書き方

1.1 「@ファイルパス」でコンテキストを明示する

1.2 問題の背景・文脈を詳細に説明する