mcpField
B
braintrust-analyze

braintrust-analyze

github.com/parcadeiAgent 工作流3.9k486 次安装39 周前更新
代码仓库

关于 braintrust-analyze

braintrust-analyze 用于分析 Claude Code 会话的 Braintrust 跟踪数据，帮助开发者回顾工具、Agent 和技能使用情况，并发现重复调用与令牌消耗趋势。

主要功能

  1. 01分析最近会话的工具与 Agent 使用
  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 会话中的模式、问题和洞察。

适用场景

  • 完成复杂任务后进行回顾
  • 调试问题失败的原因
  • 每周回顾效率模式
  • 寻找创建新技能的机会
  • 了解 Token 使用趋势

命令

从项目目录运行：

# 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）

你将了解的内容

会话分析
  • 工具使用情况明细
  • Agent 启动情况（plan-agent、debug-agent 等）
  • 技能激活情况（/commit、/research 等）
  • Token 消耗估算
循环检测

查找重复调用同一工具的会话，这可能表明：

  • 陷入搜索循环
  • 方法效率低下
  • 有改进工具的机会
使用模式
  • 最常用的 Agent
  • 激活的技能
  • 每日／每周活动趋势

示例

快速回顾
# 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