Claudeのプロンプト設計：指示・文書・JSON検証の学習ガイド

この分野の考え方

同じ文を少しずつ長くしても、どの変更が効いたか分からなければ改善は再現できません。この経路では、指示、引用する資料、出力の条件を分離してから例示を調整します。

JSONとして読めることと、値が業務上正しいことは異なります。日付、金額、参照IDなどの条件はアプリケーションでも確認し、形式を整えたことで検証が終わったと考えないようにします。

最後に入力と評価例を固定して変更前後を比較します。正常な例だけでなく、空欄、矛盾した資料、判断を保留すべき例を含めると、回答を強制してしまう指示に気付きやすくなります。

おすすめの学習順序

1. Claudeのプロンプトが矛盾するとき：制約の優先順位を設計する

   矛盾する要望のどちらを優先するかを定義します。

   次へ進む目安：事実の一致と文体の条件を別々に書ける。

2. Claudeへ文書を渡すときの区切り方：XMLタグと信頼境界は別物

   参照文書の文面を実行すべき指示と混同しないためです。

   次へ進む目安：文書内の命令文をデータとして扱える。

3. ClaudeのJSON出力を業務で使う：形式の正しさと意味の正しさを分ける

   構造が正しくても値の意味が誤る場合を確認します。

   次へ進む目安：必須項目、値の範囲、元資料との一致を区別して検査できる。

4. Claudeプロンプトの変更管理：改善したつもりで壊さないための評価

   変更と結果を結び付け、悪化した時に戻せるようにします。

   次へ進む目安：同じ評価例で変更前後の差と残る失敗を記録できる。

よくあるつまずき

• 長い指示ほど良いと考え、矛盾する条件を増やす。
• 形式に合ったJSONをそのまま確定値として保存する。
• 改善のたびに評価例も変更し、比較できなくする。

まとめの確認課題

架空の請求書から合計額と通貨を抽出する依頼を作り、通常、合計不一致、通貨欠落の三ケースを比較してください。

• 入力文書と依頼を明確に区切る。
• 形式検証と業務検証を別に実行する。
• 失敗例を保存し、変更後も再確認する。

学習用の課題です。実際の業務では、対象サービスの公式資料と所属組織のルールを確認してください。

この分野の全10記事

• Claudeのプロンプトが矛盾するとき：制約の優先順位を設計する

  詳細さ、短さ、網羅性を同時に求める依頼を整理。必須条件と希望条件を分け、両立できない場合の応答を決めます。

• ClaudeのFew-shot例を選ぶ：正解例だけでなく境界例を入れる

  例示を増やしても分類が安定しない理由。近いカテゴリ、例外、保留を含む少数例で、判断境界を伝える方法を解説します。

• Claudeへ文書を渡すときの区切り方：XMLタグと信頼境界は別物

  指示と資料を区切る目的、資料内の命令文を扱う方法、アプリ側で必要な権限制御を整理します。

• ClaudeのJSON出力を業務で使う：形式の正しさと意味の正しさを分ける

  構造化出力を受け取った後に必要な検証を説明。存在しないID、範囲外の値、権限違反を形式チェックから切り離して扱います。

• Claudeの文書回答に根拠を付ける：引用位置と適用範囲の確認

  複数の資料から回答するときに、文書ID、版、引用箇所を結び付ける方法。引用があっても断定できないケースを考えます。

• Claudeプロンプトの変更管理：改善したつもりで壊さないための評価

  指示の変更を一度に混ぜず、入力セットと判定条件を固定して比較する方法。モデルや検索設定の変更も一緒に追跡します。

• Claudeで抽出と判断を分ける：文書処理を段階化する条件

  一度の依頼で要約、判定、返信を行う構成を分解。中間結果の検証と、工程を増やすコストを比較します。

• Claudeの要約で何が失われるか：短さと情報保持を別に評価する

  重要な例外や否定を消さない要約の設計。意思決定に必要な情報を決め、欠落を検出するチェック方法を紹介します。

• Claudeで問い合わせを分類する：保留ラベルと誤分類の重みを決める

  正解率だけでは見えない分類の失敗を整理。複数ラベル、保留、誤配属の影響を考慮した評価方法を解説します。

• Claudeで日本語を校正する：事実の修正と表現の修正を分ける

  文章を読みやすくする過程で意味を変えないための手順。数字、固有名詞、主張の強さ、文体を別々に確認します。