briefing について
briefing は、タスクの状況や関連コードを簡潔に整理し、判断に役立つ情報を示すエージェント向けスキルです。求められた観点に必要な情報源だけを調べ、会話やコードベース全体の再掲を避けます。
主な機能
- 01状況、計画、解説、判断の観点を特定
- 02関連する会話やファイルを順に確認
- 03タスクに必要な範囲に情報収集を限定
- 04主要なファイル、事実、制約を要約
- 05簡潔なセクションで情報を整理
活用シーン
- 01タスクの現在の状況をすばやく把握
- 02次の手順と関連ファイルを確認
- 03タスクに関わるコードの境界や流れを理解
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ sjunepark/ agent-scripts --skill briefingインストール後、Claude Code で/briefingを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
ブリーフィング
現在のタスクについて、判断にすぐ使える簡潔な概要をユーザーに提示します。会話やコードベース全体をそのまま繰り返さず、タスクに関係する作業コンテキストを復元します。
情報源
以下の順に情報源を確認し、概要に含める各点を読んだ内容に結び付けられた時点で止めます。それ以外の内容には、推論であることを明記します。
- 現在の会話
- コードベース内の関連ファイルのうち、必要最小限のもの
- タスクの理解に影響する場合は、
AGENTS.md、ARCHITECTURE.md、近くのモジュール資料などの関連ローカルドキュメント
コードのパスがユーザーの状況把握に役立つ場合は、記載してください。
重視する内容
ユーザーの明示的な依頼から重視する内容を推測します。指定がなければ status を既定とします。複数の要素が混在する場合は、メニュー形式にせず、必要な要素を組み合わせてください。
status— 現状の確認を求められた場合:現在の実装状況を中心に説明します。plan— 次に何をするか尋ねられた場合:想定される進め方と対象箇所を中心に説明します。teach— 関連コードについて理解を求められた場合:役割、境界、処理の流れを中心に説明します。decision— 判断に必要な情報を求められた場合:制約、トレードオフ、影響の大きい不明点を中心に説明します。
対象外
このスキルでは、次の内容を作成しません。
- リポジトリ全体のアーキテクチャ概要
- 計画、コード、設計のレビュー
- 現在のタスクに必要な場合を除く、プロジェクトロードマップの再構築
- 会話全体の冗長な振り返り
- ユーザーから明示的に求められた場合を除く、実装の逐一解説
手順
-
求められている重視点を特定します(「重視する内容」を参照)。
-
タスクの範囲を把握します。
- 現在の依頼を具体的に述べます。
- 必要に応じて、今回のタスクと以前の関連性の低い話題を区別します。
- 関連情報だけを集めます。
- 現在の会話から始めます。
- 現状を説明するために必要最小限のファイルとドキュメントを読みます。
- 幅広く調べるより、エントリーポイント、変更対象ファイル、近くのインターフェース、安定した資料を優先します。
- 素早く把握できるように要約します。
- 生の調査結果を、今ユーザーが必要とする少数の事実にまとめます。
- 関連するファイルやモジュールを直接挙げます。
- それぞれが現在のタスクにどう関係するかを説明します。
- 内容を厳選します。
- 重複する点を取り除きます。
- 情報量が少ない履歴やコードの細部を省きます。
- 推測は、明確に推論と記載する場合を除き、省きます。
- 現在のタスクで本当に重要な場合を除き、未解決の問いを新たに提示しません。
出力
既定では合計 8~14 個の箇条書き、または同程度の短いセクションにまとめます。
ユーザーから別の形式を求められない限り、次の構成を使います。
現在のタスク
- 現在取り組んでいる内容を、1~3 個の箇条書きで説明します。
関連コード
- 主要なファイルやモジュールを挙げ、各項目が重要な理由を簡潔に説明します。
現時点で重要なこと
- このタスクに関わる、最も重要な実装上の事実、動作、制約を示します。
判断に必要な情報
- 次の判断に必要な事実だけを記載します。
- 役立つ場合に限り、次の手順を簡潔に示します。
コメント
Markdown 対応