Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

エージェントはフロントマターで initialPrompt を宣言できるようになりました。最初のターンが自動送信されます。

原文（英語） ​

Agents can now declare initialPrompt in frontmatter to auto-submit a first turn

概要 ​

エージェントの Markdown ファイルのフロントマターに initialPrompt を定義することで、エージェントを起動した際に最初のプロンプトが自動的に送信されます。これにより、エージェントを呼び出すたびに毎回同じ初期プロンプトを入力する手間を省き、ウォームアップ処理や初期化タスクを自動化できます。

基本的な使い方 ​

エージェントファイル（.claude/agents/ 内の .md ファイル）のフロントマターに initialPrompt を追加します：

markdown
---
name: code-reviewer
description: コードレビューを行うエージェント
initialPrompt: リポジトリの構造を確認して、レビュー準備を整えてください。
---

あなたは経験豊富なコードレビュアーです。...

エージェントを起動すると、initialPrompt の内容が自動的に送信され、エージェントが即座に作業を開始します。

実践例 ​

自動的にコンテキストを収集するエージェント ​

起動と同時にプロジェクト情報を収集するエージェント：

markdown
---
name: project-analyzer
description: プロジェクトの状態を分析するエージェント
initialPrompt: まず README.md、package.json（存在する場合）、および主要なディレクトリ構造を確認してください。
---

あなたはプロジェクト分析の専門家です。...

デバッグセッション用エージェント ​

起動時にエラーログを自動収集：

markdown
---
name: debug-helper
description: デバッグを支援するエージェント
initialPrompt: 最新のエラーログ（logs/error.log）と、最近変更されたファイル（git diff HEAD~1）を確認してください。
---

あなたはデバッグの専門家です。...

定期レポート生成エージェント ​

起動と同時にデータ収集を開始：

markdown
---
name: report-generator
description: 日次レポートを生成するエージェント
initialPrompt: 今日のコミット履歴（git log --since=midnight）と、現在のテスト結果を確認してください。
---

あなたはレポート生成の専門家です。...

ウォームアップ処理との組み合わせ ​

複数の初期化ステップを一度に実行：

markdown
---
name: dev-assistant
description: 開発補助エージェント
initialPrompt: |
  以下を確認してください：
  1. 現在のブランチ名（git branch --show-current）
  2. 未コミットの変更（git status）
  3. 最近のコミット（git log --oneline -5）
---

注意点 ​

  • initialPrompt はエージェント起動時に一度だけ自動送信されます
  • ユーザーはその後通常通り会話を続けられます
  • initialPrompt の内容は会話履歴に記録されます
  • 複数行のプロンプトは YAML のブロックスカラー（|）を使用して記述できます
  • エージェントファイルは ~/.claude/agents/ または .claude/agents/ ディレクトリに配置します

関連情報 ​