用途 这是一个用于长期运行或无人值守工作的决策留痕技能，旨在为任务过程保留可供审查的决策轨迹，方便事后核对做了什么、为什么这样做、依据是什么、结果如何。
主要能力
- 单一规范日志：采用一份 TSV 文件，每个决策占一行，单元格保持单行。列包括 ts（ISO8601 时间戳）、phase（阶段或工作流）、decision（选择或执行的内容）、why（用平实语言说明原因）、evidence（能够证明该决策的链接或路径，如提交 SHA、PR 号、file:line，或产物、trace、截图的路径，不写段落）、result（结果或谓词状态，如测试通过、已回滚、像素差为 0、INCONCLUSIVE、open）。
- 模板与辅助脚本：可从 references/decision-log-template.tsv 复制表头行开始新日志；使用 scripts/log.sh <logfile> <phase> <decision> <why> <evidence> <result> 自动写入时间戳、首次使用时写入表头、清理多余制表符与换行，并对以 =、+、-、@ 开头的单元格加单引号前缀。也可直接用 printf 追加行，但需注意同样的问题。
- 记录粒度指导：只记录决策点与检查点，例如选择某个分叉、完成某个单元及其验证结果、转向或回滚及其触发原因、暴露的阻塞、修复的关卡；循环运行则每次迭代记录一行。跳过琐碎与不言自明的内容。
- 运行边界：一次运行指一次智能体对话（含后续轮次及其摘要）；接手、替换智能体或新开对话视为新运行。当某次运行向已有日志追加内容时，其第一行的 phase 为 start，并需注明此前若干行的 ts 区间以及本次运行的标识（如对话 id）。
- 存放位置：默认作为工作产物、不提交，置于工作目录的 decisions.tsv，或并行任务时置于 .audit/<task-slug>.tsv，并排除在 git 之外；仅当工作重要到审查者需要轨迹才能信任结果时才提交。
- 只追加规则：错误决策以新增一行来取代，绝不编辑或删除历史；优先使用已提交脚本产出的证据而非手工临时结果。
- 日志审计：运行结束前，用 ../rex-subagents/scripts/sessions read <id> --tools 读取本次运行的对话记录（Claude Code 用 $CLAUDE_CODE_SESSION_ID，Codex 用 $CODEX_THREAD_ID，且不要传 --all-projects），逐段核对日志行是否对应真实决策或动作、证据是否能解析并支持其声明；发现缺口或错误时以新增取代行修正，而从不改动或删除既有行。
- 跨模型轨迹审查：交回结果前，在与执行工作不同的另一套环境上以 --read-only 启动名为 trail reviewer 的 worker（Claude Code 之后用 codex，Codex 之后用 claude），向其提供日志绝对路径、对话路径以及「不要委派」的说明，由其标记用户应注意的问题，例如证据薄弱或缺失的决策、未执行或未证明的验证步骤、事后看有风险的取舍（过早、范围蔓延、掩盖症状）、用户粗略浏览时会遗漏的缺口。
- 回复格式：产生轨迹的运行，每次回复末尾附「Attention」节，首行为审查所用模型（reviewed by <model>），随后列出指向具体行或时刻的标记；「No flags」也是有效取值。
使用方式 按上述模板建立日志，使用辅助脚本或 printf 逐行追加；在关键决策点记录而非记录每个动作；运行结束前对照对话记录审计；交回前触发跨模型审查并在回复中附上 Attention 节。其他技能可将审计轨迹路由至此，按名称引用并让其掌控格式，不必重述列定义。
适用场景 适用于长时间运行、无人值守或需要事后审查的工程任务，尤其是需要向审查者证明关键取舍、验证步骤与结果可信度的工作；也可作为其他技能统一的审计轨迹格式。
限制 日志默认不提交，是否提交需视工作重要性判断；审计只覆盖本次运行的区段，不检查其他运行的日志行（除非本次工作表明其有误）；跨模型审查要求具备另一套环境与相应 worker 机制；查看时可用 column -s$'\t' -t decisions.tsv 在终端渲染，已提交的 TSV 可在 GitHub 上以表格显示。