关于 observe-trace
observe-trace 是 Ruflo 技能，用于根据追踪跨度还原任务的分布式执行过程。它构建带时间信息的父子树，识别关键路径和瓶颈，并总结 Agent 间的协作。
主要功能
- 01检索任务追踪跨度
- 02构建父子追踪树
- 03计算耗时与关键路径
- 04标记慢跨度和空闲间隔
- 05总结执行流程
适用场景
- 01查看任务如何跨 Agent 执行
- 02定位追踪中的慢操作
- 03检查 Agent 协作和执行耗时
MCP 相关
它使用 Ruflo MCP 工具从可观测性命名空间检索跨度记录，并将跨度元数据综合为叙述性摘要。
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/observe-trace确认已加载。
详细介绍
观察跟踪
收集任务的分布式跟踪跨度，并构建可视化跟踪树，展示执行流程、耗时和瓶颈。
适用场景
当你需要了解任务如何跨 Agent 执行时——运行了哪些跨度、每个跨度耗时多久、瓶颈在哪里，以及 Agent 如何协同工作。
步骤
- 收集跨度——调用
mcp__plugin_ruflo-core_ruflo__memory_search --namespace observability（或memory_list），检索所有与<task-id>匹配的跨度。memory_*工具系列按命名空间路由；agentdb_hierarchical-*不按命名空间路由（而是按层级working|episodic|semantic路由），因此此处应使用memory_*。请参阅 ruflo-agentdb ADR-0001 §"Namespace convention"。 - 构建跟踪树——使用
parentSpanId引用将跨度整理为父子层级，并将根跨度置于顶部 - 计算耗时——计算每个跨度的耗时（endTime - startTime），并找出关键路径（最长的连续跨度链）
- 识别瓶颈——标记耗时超过该操作类型 p95 的跨度，或跨度之间的间隔表明存在空闲时间的情况
- 综合整理——调用
mcp__plugin_ruflo-core_ruflo__agentdb_context-synthesize，将跨度元数据整理成执行流程的叙述性摘要 - 报告——显示跟踪树，包含：跨度名称、Agent、耗时、状态（OK/ERROR）和瓶颈标记；同时列出跟踪总耗时和关键路径耗时
CLI 替代方案
npx @claude-flow/cli@latest memory search --query "trace spans for task TASK_ID" --namespace observability
评论
支持 Markdown