SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场braintrust-analyze

braintrust-analyze

智能体与模型

查看项目

更新于 10-15 12:27

技能介绍

用途

braintrust-analyze 用于通过 Braintrust 的追踪数据分析 Claude Code 会话，帮助使用者发现其中的模式、问题与洞察。它面向需要回顾和优化 AI 编码工作流的开发者，适合在完成复杂任务后做复盘、排查任务失败原因、进行每周生产力回顾、寻找可创建为新技能的机会，以及理解 token 使用趋势。

主要能力

工具围绕 Claude Code 会话提供多种分析视图：

  • 会话分析：最近一次会话的摘要，包含工具使用明细、智能体调用（如 plan-agent、debug-agent 等）、技能激活（如 /commit、/research 等）以及 token 消耗估算。
  • 会话列表：列出近期会话。
  • 智能体统计：查看最近 7 天的智能体使用情况。
  • 技能统计：查看最近 7 天的技能使用情况。
  • 循环检测：发现同一工具被重复调用的会话（超过 5 次相同工具调用），可能意味着陷入搜索循环、方法低效或存在改进工具的空间。
  • 会话回放：展示指定会话的完整操作序列。
  • 每周摘要：按天分解活动情况。
  • Token 趋势：查看随时间变化的 token 使用量。

使用方式

所有命令从项目目录运行，形式为 uv run python -m runtime.harness scripts/braintrust_analyze.py 加上对应参数：

# 分析上一次会话 - 含工具/智能体/技能明细的摘要
uv run python -m runtime.harness scripts/braintrust_analyze.py --last-session

# 列出近期会话
uv run python -m runtime.harness scripts/braintrust_analyze.py --sessions 5

# 智能体使用统计（最近 7 天）
uv run python -m runtime.harness scripts/braintrust_analyze.py --agent-stats

# 技能使用统计（最近 7 天）
uv run python -m runtime.harness scripts/braintrust_analyze.py --skill-stats

# 检测循环 - 查找重复的工具模式（>5 次相同工具调用）
uv run python -m runtime.harness scripts/braintrust_analyze.py --detect-loops

# 回放指定会话 - 显示完整操作序列
uv run python -m runtime.harness scripts/braintrust_analyze.py --replay <session-id>

# 每周摘要 - 每日活动分解
uv run python -m runtime.harness scripts/braintrust_analyze.py --weekly-summary

# Token 趋势 - 随时间的使用量
uv run python -m runtime.harness scripts/braintrust_analyze.py --token-trends

可用选项：

  • --project NAME：Braintrust 项目名称，默认值为 agentica。

典型示例

快速复盘上一次会话：

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

适用场景

  • 复杂任务完成后的回顾与总结。
  • 调试任务失败原因。
  • 每周生产力模式复盘。
  • 发现可沉淀为新技能的机会。
  • 了解 token 使用趋势。
  • 通过循环检测识别低效或卡住的操作模式，进而改进工具。

运行要求

  • 需要在 ~/.claude/.env 或项目 .env 中配置 BRAINTRUST_API_KEY。
  • 需要启用 Braintrust 追踪（通过 braintrust-claude-plugin）。

限制

除上述要求外，关于该工具的收费、价格、具体平台支持范围、效果保证等信息，资料中暂未提供。