用途 reasoning-trace-recorder 是一个面向 T4 任务执行的轨迹记录技能,在任务处于活动状态时自动触发,为每一轮 Claude 交互追加不可篡改的推理轨迹,目标是实现取证级的可复现性。
主要能力
- 事件追加:每产生一个事件,就向 .claude/plans/traces/{TASK_ID}.jsonl 追加一行 JSON,每个 T4 任务对应一个文件。
- 事件类型:file_read、output_claim(含 grounded 布尔值与 grounded_by 字段)、tool_call、tool_result、decision、phase_transition。
- 依据判定:依据规范 §11.1,当同一条轨迹中至少有一次先前的 file_read 覆盖了被声明的文件、函数或符号时,该 output_claim 被视为有依据;无依据的声明会被标记,并可通过 /aura-frog:trace --hallucinations 查看。
- 预算控制:每个任务目标不超过 500 个事件;超过 1000 个事件时,通过 post-execute-update-node 钩子设置 trace_overflow 标记。
使用方式 该技能在 T4 任务执行期间自动调用,无需手动触发。当出现以下情况时静默退出:不存在 .claude/plans/active.json、active.task 为 null,或环境变量 AF_TRACE_DISABLED=true。更详细的 JSON schema、各事件类型的载荷字段以及关联说明,见 skills/reasoning-trace-recorder/reference.md,按需加载。
限制 不调用 LLM,不编辑计划文件,也不裁剪已有轨迹。事件数量有目标上限,超出上限仅设置溢出标记,资料未说明更多处理方式。