Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

バックグラウンドエージェントの完了通知に出力ファイルパスが欠落していた問題を修正しました。この問題により、コンテキストの圧縮後に親エージェントがエージェントの結果を回復するのが困難になっていました。

原文（英語） ​

Fixed background agent completion notifications missing the output file path, which made it difficult for parent agents to recover agent results after context compaction

概要 ​

バックグラウンドで実行されるサブエージェントが完了した際の通知に、出力ファイルのパス情報が含まれていなかったバグが修正されました。この問題は特にコンテキスト圧縮（context compaction）が発生した後に顕著で、親エージェントがバックグラウンドエージェントの実行結果ファイルを見つけて回復することが困難になっていました。修正後は完了通知に出力ファイルパスが正確に含まれ、結果の回復が確実に行えます。

基本的な使い方 ​

この修正はv2.1.71以降で自動的に適用されます。バックグラウンドエージェントを使用する際、完了通知に出力ファイルパスが含まれるようになります。

bash
# バックグラウンドエージェントを使用したタスク
> サブエージェントを起動して大規模なコード解析を行ってください

# 修正後: エージェント完了通知に出力ファイルパスが含まれる
# → 親エージェントが結果を確実に参照できる

実践例 ​

並行コード解析の結果回収 ​

複数のバックグラウンドエージェントを起動して並行処理を行い、結果を収集する場合。

bash
# 親エージェントが複数のバックグラウンドエージェントを起動
> 以下の3つのモジュールをそれぞれバックグラウンドで解析してください:
  1. src/auth/ - 認証モジュール
  2. src/api/ - APIモジュール
  3. src/db/ - データベースモジュール

# 各バックグラウンドエージェントの完了通知に出力パスが含まれる
# → 親エージェントが全ての結果を確実に収集できる

コンテキスト圧縮後の結果回収 ​

長時間のセッションでコンテキスト圧縮が発生した後の結果回収。

bash
# 長時間のセッションでバックグラウンドエージェントを使用
> 大規模なテストスイートをバックグラウンドで実行してください

# （コンテキスト圧縮が発生した後でも）
> バックグラウンドエージェントの結果を確認してください

# 修正前: コンテキスト圧縮後に出力ファイルパスが失われ、結果の回収が困難だった
# 修正後: 通知に出力パスが含まれているため、確実に結果を回収できる

自動化パイプラインでのエージェント管理 ​

複数のエージェントを連携させた自動化パイプラインでの利用。

bash
# マルチエージェントワークフロー
> ステップ1のバックグラウンドエージェントを起動し、完了後にステップ2を実行してください

# エージェント間の結果受け渡しが確実に行われる

注意点 ​

  • この修正はバックグラウンドエージェント（サブエージェント）機能を使用する場合に特に重要です。
  • コンテキスト圧縮が頻繁に発生する長時間セッションでの信頼性が向上します。
  • 出力ファイルは一時ディレクトリに保存されるため、セッション終了後に削除される場合があります。
  • バックグラウンドエージェント機能はClaudeの高度なオーケストレーション機能の一部です。

関連情報 ​