CC逆引きリファレンス

サブエージェントのシステムプロンプトを拡張しキャッシュ効率を上げたい

12. CI/CD・自動化

コマンド / 機能

--append-subagent-system-prompt / --exclude-dynamic-system-prompt-sections

プロンプトキャッシュ再利用率の向上

概要

--append-subagent-system-prompt はサブエージェント用のシステムプロンプトに追加指示を挿入します。--exclude-dynamic-system-prompt-sections は日時やマシン固有情報などの動的セクションをシステムプロンプトから外し、代わりに最初のユーザーメッセージへ移動させることで、プロンプトキャッシュのヒット率を高めます。

設定例

# サブエージェントにも追加指示を適用
claude -p --append-subagent-system-prompt "テストは必ず日本語でレポートして" "テストを実行して"

# 動的セクションを除外してキャッシュ再利用率を上げる
claude -p --exclude-dynamic-system-prompt-sections "コードをレビューして"

# --append-system-prompt-file と組み合わせ
claude --append-system-prompt-file ./rules.txt --append-subagent-system-prompt "サブエージェントもルールに従うこと"
公式ドキュメントを見る

こんな時に使う

  • サブエージェントにもチーム規約を守らせたい時
  • 同一プロンプトを繰り返し実行してコストを削減したい時
  • バッチ処理でキャッシュヒット率を最大化したい時

使い方

  1. 1--append-subagent-system-prompt でサブエージェント向けの追加指示を渡す
  2. 2--exclude-dynamic-system-prompt-sections で日時等の可変情報を切り離す
  3. 3--append-system-prompt / --append-system-prompt-file と併用可能

Tips

  • 動的セクションが混じっているとプロンプトキャッシュが毎回無効化される
  • バッチ/並列実行でコスト削減効果が大きい
  • サブエージェントのシステムプロンプトはメインとは別管理