用途:在跨进程或异步边界时,始终传递显式标识符,避免依赖“最新”或“当前”状态,因为“最近”本质上是竞态条件。
主要能力:提供一套模式与正反示例,指导如何在整个流水线中传递显式 ID,并区分不同 ID 类型。
使用方式:生成进程时传入 --session-id $ID;将 ID 存入状态文件以便后续关联;使用完整 UUID 而非部分匹配;保持不同 ID 类型相互独立。
应避免:在执行时查询“最近会话”;假设 await/spawn 后当前上下文仍然有效;混淆不同 ID 类型。资料中区分了 session_id(Claude Code 会话,面向人)、root_span_id(Braintrust 追踪,查询键)和 turn_span_id(会话内的 Braintrust 轮次)。
示例:错误做法是 spawn('analyzer', ['--learn']) 默认使用“最近”;正确做法是 spawn('analyzer', ['--learn', '--session-id', input.session_id])。
适用场景:需要跨进程或异步边界保持身份一致性的流水线。
限制:资料未提供安装命令、平台、收费或效果信息。