新モデルへの切り替えに向けて、チームが見積もりデータの整理に使うプロンプト(prompt)、つまり AI に仕事の進め方を伝える指示を開いてみると、「確認した後にもう一度確認する」「すべての項目を必ず埋める」といった念押しが並んでいます。こうした指示は、過去にミスが起きるたびに、一つずつ追加されてきたのかもしれません。モデルが変わる今、そのまま引き継ぐべきでしょうか。それとも、すべて書き直すべきでしょうか。
Intellicon Solutions は、モデルを更新する際にプロンプトも併せて点検することを勧めています。ただし、受け入れ判断では、文字数がどれだけ減ったかだけを見てはいけません。まず、会社として引き続き守るべき業務ルールと、以前のモデルを指示どおりに動かすために追加した注意書きを分け、同じデータを使って修正前後の結果を比較します。本当に確認すべきなのは、守るべき条件が抜け落ちていないかどうかです。
まず、会社のルールと繰り返しの念押しを分ける
INSIDE の報道によると、旧モデル向けに書かれた大文字による強調や繰り返しの注意書きは、新モデルではトークン使用量を増やし、結果に悪影響を及ぼす可能性があります。記事で紹介されている Claude Code のコマンド /doctor prompt-audit は、CLAUDE.md、skills、agents、commands に含まれる古い指示を点検し、無効になったパスや、ファイル間で矛盾するルールも指摘します。ユーザーが確認するまでは、問題点と修正案を提示するだけで、ファイルを変更することはありません。
ただし、強い表現の指示をすべて削除すべきという意味ではありません。まずは、見積もりデータの整理など、現在実際に担当者が取り組んでおり、結果の正誤を判断できる人もいる業務を一つ選ぶことを勧めます。そのうえで、関連する指示を一つずつ洗い出し、記載箇所、対応する業務上の要件、残す理由を明記します。最初は、次の基準で分類するとよいでしょう。
- 引き続き守るべき業務要件:例えば、通貨、税区分、見積有効期限の明記が社内ルールで定められている場合は、その要件を残します。モデルが変わったからといって省略してはいけません。
- 具体化が必要な確認方法:何度も確認するよう求めるだけで、確認対象が書かれていない指示は、具体的なチェック項目に置き換えることを勧めます。例えば、品名と品番が一致しているか、納期が記載されていない場合に要確認事項として挙げているか、といった項目です。
- テストしてから残すかどうかを決める旧来の表現:すべて大文字で書かれた文や、繰り返しの注意書きは、削除・修正の候補にできます。ただし、もともとどのようなミスを防ぐために加えたのかを記録し、削除後に同じ問題が再発しないかをテストする必要があります。
各要件の根拠は、業務責任者に確認してもらいましょう。残す理由をチームで説明できない場合は、まず「要確認」と記載します。必要なルールだと決めつけることも、確認せずに削除することも避けてください。
別々の場所に書かれたルールも、まとめて点検する
記事では、異なるファイルに書かれたルールが互いに矛盾する可能性にも触れています。企業が業務の指示を点検する際にも、注意すべき点です。例えば、見積もりデータを整理するスキル(skill、繰り返し適用できる定型の手順)では不足しているデータを列挙するよう求めているのに、タスクの指示ではすべての項目を自力で埋めるよう求めている場合、チームはまず、データが不足しているときの対応を決めなければなりません。強調表現を数か所削除するだけでは解決しません。
引き続き同じ業務を対象に、ルールが一致していない箇所を一覧にまとめることを勧めます。それぞれについて、ルールの記載箇所、矛盾する内容、現在従うべき業務ルール、確認責任者を記録します。納期が不明な場合は、まず営業担当者に確認するという社内ルールがあるなら、スキルとタスクの指示を両方修正し、不足情報として何を挙げるのか、誰に確認を依頼するのか、確認が取れるまでどの工程を完了してはいけないのかを明記します。
また、指示で参照しているフォルダー、テンプレート、操作コマンドも、一つずつ確認する必要があります。文書が移動していたり、テンプレートが廃止されていたりする場合は、文章に矛盾がなくても、指示内の参照先を更新しなければなりません。このため、今回の点検では修正事項の一覧を残し、後任の担当者も対応状況を追跡できるようにします。さらに、同じルールを参照している箇所がすべて一覧に含まれているか、責任者に確認してもらいましょう。
同じデータを使い、修正後に条件が抜け落ちていないか確かめる
まず元の指示を保存し、新モデルに修正前と修正後の指示をそれぞれ与えて、同じ代表的なデータを処理させることを勧めます。プロンプト以外のデータ、ツール、実行設定は、できる限り同じに保ちます。一度に多くの条件を変えると、結果に違いが出ても、その原因を後から特定できなくなるためです。
見積もりデータの整理であれば、テストデータには、項目がすべてそろっているケース、納期が欠けているケース、データの内容が互いに矛盾するケースなどを含めます。業務責任者がそれぞれのケースで取るべき対応をあらかじめ明記し、次の項目に沿って結果を確認します。
- 必要な条件が抜け落ちていないか:通貨、税区分、見積有効期限がすべて記載されているかを確認します。文章が読みやすくなったからといって、必要な情報の欠落を見逃してはいけません。
- 不足しているデータを、そのまま不足として示しているか:元のデータに納期がない場合、勝手に日付を補うことなく、ルールどおり要確認事項として挙げているかを確認します。
- 形式と確認手順が要件を満たしているか:担当者が所定の項目に沿って後続の処理を進められるか、営業担当者の確認が必要な内容が明示されているかを確認します。
重要なケースは複数回テストし、毎回の入力データ、使用した指示のバージョン、出力結果を保存することを勧めます。修正後に必要な条件が抜け落ちた場合は、いったん修正範囲を絞り、再テストします。回答の一つがよくできているように見えたというだけで、本番で使っている指示を置き換えてはいけません。
テストに合格してから、スキルとタスクを更新する
テストに合格した手順は、そのときの会話の中だけに残さず、繰り返し使えるスキルやタスクの指示としてまとめることを勧めます。EgentWrX では、定型の手順やルールをスキルに記載できるほか、タスクのバージョン管理と公開ポリシーを通じて、修正後の業務指示を管理できます。
まずタスクの新しいバージョンを作成し、修正理由とテスト結果を記録します。そのうえで、業務責任者が必要な条件に漏れがないかを確認し、IT 担当者が参照パスの有効性と操作の正常動作を確認してから公開します。社員が自分で作成したスキルを全社で使えるようにする場合は、管理画面の審査キューに提出し、承認を受ける必要があります。一方、ルールの照合やテストケースの準備は、引き続きチームで行います。
次にモデルを切り替える前には、試行する業務と責任者を選び、ルール一覧と代表的なデータを用意しておきましょう。また、テストでどのような不合格結果が出たら既存の指示の置き換えを見送るのかも、事前に合意しておきます。こうした準備があれば、チームは点検とテストの結果に基づいて、残すべき指示、修正すべき表現、本番で使用するバージョンを更新する時期を判断できます。
よくある質問
新モデルに切り替える際、既存のプロンプトをすべて書き直す必要がありますか?
すべてを書き直す必要はありません。まず、各指示が業務上どのような目的を持ち、なぜ残す必要があるのかを確認することを勧めます。引き続き守るべき見積条件、データ要件、確認手順は残します。繰り返しの念押しや旧モデル向けの表現は、いったんテスト対象の一覧に入れ、修正前後の結果を比較してから削除・修正するかを判断しましょう。
点検ツールが削除を勧めた指示は、そのまま削除してもよいですか?
そのまま削除することは勧めません。まず、削除・修正によって社内ルールの遵守に影響が出ないかを業務責任者に確認してもらい、その後にテストを実施します。ツールの提案は、業務上の判断に代わるものではありません。特に、データが不足している場合の対応や、上長の確認が必要な内容に関わる指示は、確認の記録を残すことが重要です。
既存のプロンプトの点検は、業務部門と IT 部門のどちらが担当すべきですか?
業務責任者と IT 担当者が分担して点検し、AI プロジェクト責任者が結果を取りまとめることを勧めます。業務側は、指示に含まれる条件と出力結果が業務要件を満たしているかを確認し、IT 側は参照パスが有効か、操作が正常に実行できるかを確認します。最後に、チームでテスト結果を踏まえ、新しいバージョンを公開するかどうかを判断します。
参考資料
- モデルを更新したら、指示も更新を!Claude Code の /doctor prompt-audit で CLAUDE.md や skills にある古いプロンプトを点検 — INSIDE の報道。既存プロンプトの点検、無効になった内容やルールの矛盾の検出、修正前にユーザーが確認する手順を紹介しています。



