指示文のバージョン管理を行う

AIに仕事を頼むとき、あなたは「指示文（プロンプト）」を書きますよね。最初に書いた指示文がそのまま完璧に動くことは、実はほとんどありません。「もう少し丁寧な口調にしたい」「この条件を追加したい」と何度も書き直していくうちに、どれが最新版で、どれが一番うまくいったのかわからなくなる——これはAIを使い始めた人がほぼ全員経験する「あるある」です。

このレッスンでは、指示文の変更履歴を残す方法を学びます。料理にたとえると、レシピを改良するたびにノートに「第2版：塩を減らした」「第3版：火加減を変えた」とメモしておくようなものです。こうしておけば、いつでも「一番おいしかったバージョン」に戻れます。

• 指示文に「バージョン番号」と「変更メモ」をつけて管理できるようになる
• 過去のバージョンと比較して、どの変更が効果的だったか判断できるようになる

• ChatGPT、Claude、またはお好きなAIチャットツールが使える状態であること
• 過去に1つ以上の指示文を書いたことがあること（簡単なものでOK）

バージョン管理と聞くと難しそうに感じるかもしれませんが、やることはシンプルです。

1. バージョン番号をつける（v1、v2、v3……）
2. 何を変えたかメモする（変更理由と変更内容）
3. 結果を記録する（うまくいったか、いかなかったか）

この3つをセットで残しておくだけです。

まず、指示文の履歴を記録するためのシート（テンプレート）を用意しましょう。以下のフォーマットを、メモアプリやGoogleドキュメントにコピーしてください。

# 指示文バージョン管理シート

v1（作成日：2026-04-13）

• 指示文：（ここに指示文を貼り付け）
• 変更点：初版
• 結果メモ：（AIの出力がどうだったか簡単に記録）
• 評価：⭐⭐⭐（5段階で自己評価）

v2（作成日：）

• 指示文：（ここに改良版を貼り付け）
• 変更点：（何をどう変えたか）
• 結果メモ：（改善されたか、悪化したか）
• 評価：⭐⭐⭐⭐

> **ポイント**: 日付と評価を必ず残すことで、あとから「いつ、どの変更が効果的だったか」を振り返れます。

では、実際にやってみましょう。あなたが普段使っている指示文を1つ選んでください。ここでは例として「お客様への返信メールを作る指示文」を使います。

v1（初版）の例

お客様からのクレームに対する返信メールを書いてください。
丁寧な口調でお願いします。

この指示文をAIに送って、出力を確認します。結果メモに「丁寧だが、具体的な対応策が書かれていない」と記録したとしましょう。

v2（改良版）の例

お客様からのクレームに対する返信メールを書いてください。

条件：
- 丁寧な口調（です・ます調）
- まず謝罪、次に原因の説明、最後に今後の対応策を書く
- 200文字以内

変更点は「構成の指定（謝罪→原因→対応策）」と「文字数制限」の追加です。

良い変更メモの例

✅ 良い例：「v1では対応策が抜けていたので、『謝罪→原因→対応策』の3段構成を指定した。文字数制限も追加」

❌ 悪い例：「ちょっと直した」「改善した」（何を変えたかわからない）

バージョンが増えてきたら、AIに「どの変更が効果的だったか」を分析してもらいましょう。以下のプロンプトをそのまま使えます。

以下は、同じ目的の指示文のバージョン履歴です。
どのバージョン間の変更が最も効果的だったか、理由とともに教えてください。

（ここにバージョン管理シートの内容を貼り付ける）

AIが「v1→v2の構成指定が最も効果的でした」のように分析してくれるので、次の改良に活かせます。

何度か改良を重ねたら、一番うまくいったバージョンに「⭐ベスト版」の印をつけましょう。

### v3 ⭐ベスト版（作成日：2026-04-13）
- 指示文：（ベスト版の指示文）
- 変更点：v2に「お客様名を冒頭に入れる」を追加
- 結果メモ：最も自然で丁寧な返信が生成された
- 評価：⭐⭐⭐⭐⭐

今後はこの「ベスト版」をコピーして使い、さらに改良が必要なときはv4として分岐させます。

以下の3つが揃っていれば、このレッスンは完了です。

• バージョン管理シートに、最低2つのバージョン（v1とv2）が記録されている
• 各バージョンに「変更点」と「結果メモ」が書かれている
• どのバージョンが一番良かったか、自分で判断して印をつけている

「変更が小さすぎて記録するほどでもない」と思ったとき

→ 小さな変更こそ記録する価値があります。「句読点を変えただけで出力が変わった」ということもよくあります。迷ったら記録しておきましょう。

「バージョンが増えすぎて管理しきれない」とき

→ 10バージョンを超えたら、評価が低いバージョン（⭐1〜2）は「アーカイブ」セクションに移動させましょう。普段見るのはベスト版と直近3バージョンだけで十分です。

「どこに保存すればいいかわからない」とき

→ Googleドキュメント、Notion、メモアプリなど、あなたが普段使っているツールでOKです。大切なのは「1つの場所にまとめる」ことです。複数の場所に散らばると、どれが最新かわからなくなります。

このレッスンでは、AIへの指示文にバージョン番号・変更メモ・結果記録をつけて管理する方法を学びました。これを習慣にすると、指示文の品質が着実に上がっていきます。次に指示文を書き直すときから、ぜひ「v2」とつけてみてください。