一句话解释
Trace 是一次执行从输入到输出经过了哪些步骤、工具和状态的轨迹。
小白比喻
快递物流记录让你知道包裹到过哪里、谁处理过、何时异常。
第一性原理
不可追踪的系统无法解释，也无法稳定改进。
为什么 AI Coding 时代必须懂
AI 输出错了，必须知道它看了什么、调用了什么、在哪一步偏了。
商业项目事故
Agent 错删记录，但没有工具调用日志，无法确认是误判还是权限漏洞。
指挥 Codex 时应该怎么问
请为这个工作流补 trace 记录，包括输入、计划、工具调用、返回和最终判断。任务卡里应该怎么写
列出必须记录的事件、字段、敏感信息脱敏和保存周期。
验收标准怎么写
任一失败都能通过 trace 定位到具体步骤和输入输出。
错误指令
出错了再看控制台。
合格指令
每次工具调用记录 requestId、参数摘要、结果、耗时和错误。