名称: braintrust-analyze 描述: 通过Braintrust分析Claude Code会话
Braintrust分析
使用Braintrust追踪数据来分析您的Claude Code会话，发现模式、问题和洞察。
何时使用
- 完成复杂任务后（回顾）
- 调试为什么某事物失败时
- 每周回顾生产力模式
- 寻找创建新技能的机会
- 理解令牌使用趋势
命令
从项目目录运行：
# 分析最后一次会话 - 带工具/代理/技能分解的总结
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
# 令牌趋势 - 使用情况随时间变化
uv run python -m runtime.harness scripts/braintrust_analyze.py --token-trends
选项
--project NAME- Braintrust项目名称（默认: agentica）
您将学习的内容
会话分析
- 工具使用分解
- 代理生成（plan-agent、debug-agent等）
- 技能激活（/commit、/research等）
- 令牌消耗估计
循环检测
发现同一工具被重复调用的会话，这可能表示：
- 陷入搜索循环
- 效率低下的方法
- 改进工具的机会
使用模式
- 您最常使用哪些代理
- 哪些技能被激活
- 每日/每周活动趋势
示例
快速回顾
# 我最后一次会话发生了什么？
uv run python -m runtime.harness scripts/braintrust_analyze.py --last-session
输出：
## 会话分析
**ID:** `92940b91...`
**开始时间:** 2025-12-24T01:31:05Z
**跨度:** 14
### 工具使用
- 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
要求
- BRAINTRUST_API_KEY 在 ~/.claude/.env 或项目 .env 中
- Braintrust追踪已启用（通过braintrust-claude-plugin）