サブエージェントのシステムプロンプトに追記したい
9. エージェントコマンド / 機能
--append-subagent-system-promptサブエージェント専用の追加指示
概要
--append-subagent-system-prompt フラグを使うと、メインセッションのシステムプロンプトとは別に、サブエージェントが起動する際のシステムプロンプトにだけテキストを追記できます。全サブエージェント共通のルールを一括で注入したい場合に便利です。
設定例
# サブエージェント全体に共通ルールを追記
claude --append-subagent-system-prompt \
"作業前に必ず既存のテストを実行し、結果を報告すること" \
"大規模なリファクタリングをして"
# ファイルから読み込みたい場合は --append-system-prompt-file と使い分け
claude --append-system-prompt-file ./main-rules.md \
--append-subagent-system-prompt "サブエージェント専用の注意事項"こんな時に使う
- 全サブエージェントに共通の作業ルールを徹底させたい時
- メインセッションとは別にサブエージェントだけへ指示を追加したい時
- チーム標準のガードレールをサブエージェント起動時に必ず注入したい時
使い方
- 1claude 起動時に --append-subagent-system-prompt "<テキスト>" を指定
- 2指定したテキストは、生成される全てのサブエージェントのシステムプロンプト末尾に追記される
- 3メインセッション向けには --append-system-prompt-file を別途使う
Tips
- --agent や --agents で定義したカスタムエージェントにも適用される
- CI で一貫したサブエージェントの振る舞いを強制したい場合に有効
- 個別エージェントの frontmatter による指示より優先度は低く、あくまで追記される点に注意