Claude Codeで2サイトを回す中で見えた「再利用の境界」
私は現在、urisol.com（法人・NDT技術記事）とurinosuke.com（個人ペンネーム・biz/code/fi/life/side）の2つのサイトをClaude Codeで構築・運用している。どちらもAstro + Cloudflare Pagesの構成で、GitHub Actionsによる自動投稿を回している。
運用を始めて2ヶ月が経ち、「プロンプトの再利用設計」について実感が言語化できるようになってきた。『LLMのプロンプトエンジニアリング』（オライリー・ジャパン）で学んだテンプレート化・コンテキスト設計の原則を、実際の運用に落とし込む過程で見えてきた境界がある。
本記事では、プロンプトの再利用が効く場面と、毎回作り直すほうが早い場面の境界を、2サイト運用の実例から整理する。
再利用が効く場面：記事生成・定型タスク・構造化出力
1. 記事生成プロンプト
記事生成のプロンプトは、最も再利用が効いている領域だ。urisol.com・urinosuke.comともに、記事生成用のプロンプトテンプレートを作り込んでおり、毎回ほぼ同じ構造で記事を出力している。
再利用が効く理由は次の3点：
- 出力形式が固定（Markdown + JSON形式のメタデータ）
- 制約条件が明確（文字数・構成・禁止事項）
- 著者の立場・事実台帳が変わらない
記事のテーマ・切り口は毎回変わるが、「誰が・どの立場で・どういう制約のもとで書くか」は不変だ。この不変部分をプロンプトに固定しておくことで、テーマ部分だけを差し替えれば記事が生成できる設計になっている。
2. 定型タスク（コード整形・リファクタリング提案）
コードの整形・リファクタリング提案も再利用が効く。たとえば「このファイルのインデントを統一してください」「この関数を分割してください」といった指示は、対象ファイルが変わっても指示内容は変わらない。
この種のタスクは、プロンプトを「タスク名 + 対象ファイルパス」の2要素に分解しておけば、対象を差し替えるだけで再利用できる。
3. 構造化出力（JSON・YAML・CSV生成）
構造化されたデータ出力も再利用が効く。たとえば記事メタデータをJSON形式で出力する場合、スキーマ（title・slug・description・categories等）は固定だ。
出力形式が固定されているタスクは、プロンプトに「出力例」を埋め込んでおけば、Claude Codeが形式を守って出力してくれる。Few-shot学習の典型的な適用例だ。
再利用が効かない場面：探索的タスク・状況依存の判断・デバッグ
1. 探索的タスク（「なぜエラーが出るのか調べてください」）
エラーの原因調査や、期待通りに動かない挙動の原因特定は、再利用が効かない。なぜなら、エラーの種類・発生箇所・コンテキストが毎回異なるからだ。
この種のタスクでは、プロンプトを再利用するより、エラーログ・該当ファイル・実行環境の情報を毎回新しく貼り付けて、その場で状況を説明したほうが早い。
2. 状況依存の判断（「このコードは残すべきか削除すべきか」）
コードの取捨選択・設計判断は、文脈に強く依存する。たとえば「この関数はまだ使われているか」「このファイルは削除してよいか」といった判断は、プロジェクト全体の依存関係・実装状況を見ないと答えられない。
この種の判断タスクでは、プロンプトを再利用するより、「今の状況はこうで、こういう選択肢があって、どう判断すべきか」を毎回記述したほうが精度が高い。
3. デバッグ（「この実装のどこが間違っているか」）
デバッグも再利用が効かない典型例だ。コードの誤り・ロジックのバグは、毎回異なる箇所・異なる原因で発生する。
デバッグでは、「どういう挙動を期待していて、実際にはどうなったか」を毎回具体的に記述する必要がある。この記述は再利用できない。
境界を分けるポイント：タスクの「不変部分」と「可変部分」の比率
プロンプトの再利用が効くかどうかは、タスクの「不変部分」と「可変部分」の比率で決まる。
不変部分が多いタスク（記事生成・定型処理・構造化出力）は、再利用が効く。プロンプトに不変部分を固定しておき、可変部分（テーマ・対象ファイル・データ）だけを差し替えればよい。
可変部分が多いタスク（探索・判断・デバッグ）は、再利用が効かない。毎回の状況・文脈が異なるため、プロンプトを再利用するより、その場で状況を記述したほうが早い。
実運用での使い分け：「テンプレート」と「その場記述」の併用
私の実運用では、次のように使い分けている：
- 記事生成・定型タスク: プロンプトテンプレートを用意し、テーマ・対象だけを差し替えて実行
- 探索・判断・デバッグ: プロンプトは再利用せず、その場で状況を記述して指示
この使い分けにより、再利用が効く場面では効率化し、再利用が効かない場面では柔軟に対応できる運用が回っている。
まとめ：再利用設計は「不変部分」を見極めることから始まる
Claude Codeでのプロンプト再利用設計は、タスクの「不変部分」と「可変部分」を見極めることから始まる。不変部分が多いタスクはテンプレート化し、可変部分が多いタスクはその場で記述する。この使い分けが、実運用でのプロンプト設計の実践知になる。
2サイト運用を回す中で、この境界が見えてきた。今後は、テンプレート化できるタスクをさらに増やし、再利用の効率を上げていく。
関連書籍
LLMのプロンプトエンジニアリング
GitHub Copilot設計者によるプロンプト設計論。コンテキスト・スカフォールディング・テンプレート化の概念地図が、Claude Code運用にそのまま応用できる。
参考
- Anthropic公式ドキュメント - Prompt Engineering
- GitHub Copilot - Best Practices for Prompt Engineering
- オライリー・ジャパン - LLMのプロンプトエンジニアリング
関連記事
- Claude Codeで2サイトを並行運営して3ヶ月、プロンプト設計を「再利用できる型」に分解したら記事生成の手戻りが1/3になった話
- 法人と個人事業を併営して2年、マネーフォワードで「3財布の現金の流れ」を整理する実運用を言語化する
- 38歳個人事業主が『LLMのプロンプトエンジニアリング』を読んで設計した業務用テンプレート3段階：コンテキスト・スカフォールディング・評価設計の実務応用
まとめて読む: AI活用・自動化