mcpField
B
braintrust-analyze

braintrust-analyze

github.com/parcadeiエージェントワークフロー3.9k486 回インストール39 週間前に更新
リポジトリ

braintrust-analyze について

braintrust-analyze は、Claude Code セッションの Braintrust トレースを分析するスキルです。開発者向けに、ツールやエージェントの利用状況、繰り返し呼び出し、トークン使用傾向を示します。

主な機能

  1. 01セッション内のツールとエージェントを分析
  2. 02最近のセッションと利用統計を表示
  3. 03ツール呼び出しのループを検出
  4. 04日次・週次の活動を集計

活用シーン

  1. 01複雑なタスク後のセッション振り返り
  2. 02タスク失敗の原因調査
  3. 03生産性とトークン傾向の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/parcadei/continuous-claude-v3 --skill braintrust-analyze

インストール後、Claude Code で/braintrust-analyzeを入力して読み込まれたか確認します。

同梱ファイルSKILL.md.bakSKILL.v6.md

詳細

Braintrust 分析

Braintrust のトレースデータを使用して、Claude Code のセッションのパターン、問題、知見を分析します。

使用するタイミング

  • 複雑なタスクを完了した後（振り返り）
  • 失敗の原因をデバッグするとき
  • 生産性のパターンを週ごとに確認するとき
  • 新しいスキルを作成する機会を見つけるとき
  • トークン使用量の傾向を把握するとき

コマンド

プロジェクトディレクトリから実行します。

# Analyze last session - summary with tool/agent/skill breakdown
uv run python -m runtime.harness scripts/braintrust_analyze.py --last-session

# List recent sessions
uv run python -m runtime.harness scripts/braintrust_analyze.py --sessions 5

# Agent usage statistics (last 7 days)
uv run python -m runtime.harness scripts/braintrust_analyze.py --agent-stats

# Skill usage statistics (last 7 days)
uv run python -m runtime.harness scripts/braintrust_analyze.py --skill-stats

# Detect loops - find repeated tool patterns (>5 same tool calls)
uv run python -m runtime.harness scripts/braintrust_analyze.py --detect-loops

# Replay specific session - show full sequence of actions
uv run python -m runtime.harness scripts/braintrust_analyze.py --replay <session-id>

# Weekly summary - daily activity breakdown
uv run python -m runtime.harness scripts/braintrust_analyze.py --weekly-summary

# Token trends - usage over time
uv run python -m runtime.harness scripts/braintrust_analyze.py --token-trends

オプション

  • --project NAME - Braintrust のプロジェクト名（デフォルト：agentica）

得られる知見

セッション分析
  • ツールの使用状況の内訳
  • エージェントの起動（plan-agent、debug-agent など）
  • スキルの有効化（/commit、/research など）
  • トークン消費量の推定
ループの検出

同じツールが繰り返し呼び出されているセッションを見つけます。これは次の可能性を示している場合があります。

  • 検索ループから抜け出せない
  • 非効率なアプローチ
  • より良いツールを導入する機会
使用パターン
  • 最もよく使用するエージェント
  • 有効化されるスキル
  • 日次／週次のアクティビティ傾向

例

簡単な振り返り
# What happened in my last session?
uv run python -m runtime.harness scripts/braintrust_analyze.py --last-session

出力：

## Session Analysis
**ID:** `92940b91...`
**Started:** 2025-12-24T01:31:05Z
**Spans:** 14

### Tool Usage
- Read: 4
- Bash: 2
- Edit: 2
...
ループを見つける
uv run python -m runtime.harness scripts/braintrust_analyze.py --detect-loops
週次レビュー
uv run python -m runtime.harness scripts/braintrust_analyze.py --weekly-summary

要件

  • ~/.claude/.env またはプロジェクトの .env に BRAINTRUST_API_KEY が設定されていること
  • Braintrust のトレースが有効になっていること（braintrust-claude-plugin 経由）

コメント

Markdown 対応