用途:该技能提供一套结构化工作流,用于运行 MassGen 实验并分析其产生的 trace 与日志,帮助调试智能体行为与协作模式、测量性能与定位瓶颈、改进日志结构,并生成保存到日志目录的 markdown 分析报告。
主要能力:通过 massgen logs CLI 列出日志及分析状态(list、--analyzed、--unanalyzed、--limit)、生成分析提示(analyze、--log-dir、--turn),以及多智能体自分析模式(--mode self、--force、--config)。自分析会以多智能体从正确性、效率、行为等角度分析并合并为 ANALYSIS_REPORT.md。日志目录支持多轮次,每轮有 turn_N/ 目录及 attempt 子目录。
使用方式:运行实验用 uv run massgen --automation --logfire --config [config_file] "[question]",输出首行含 LOG_DIR 与 STATUS 路径,可据此做文件分析;status.json 每 2 秒更新,可监控 completion_percentage、phase、winner、各 agent 状态。Logfire 需先安装 massgen[observability]、注册账号、uv run logfire auth 或设置 LOGFIRE_TOKEN,并配置只读 token 与 MCP 服务器(claude mcp add logfire -e LOGFIRE_READ_TOKEN=... -- uvx logfire-mcp@latest)。
适用场景:需要毫秒级时序、span 层级、异常堆栈、跨会话查询或实时监控时用 Logfire;分析命令模式、工具参数输出、投票理由、协作流程表、成本 token 摘要时用本地日志文件(status.json、metrics_summary.json、coordination_events.json、coordination_table.txt、streaming_debug.log、vote.json、execution_trace.md 等)。
限制:Logfire MCP 为可选但推荐,未设置 LOGFIRE_READ_TOKEN 时自分析会自动禁用并回退到本地日志;Logfire 限流时建议等待最多 60 秒重试而非回退。已知限制:多智能体经 asyncio.create_task 并发时子 span 可能无法正确嵌套在 agent round span 下,属 OpenTelemetry 上下文传播问题,presentation 阶段正常。其余未在资料中说明的细节暂未提供。