用途:为需要事后人工复核的长时间或无人值守工作保留一条可复核的决策轨迹,让审阅者无需重跑工作或通读全部记录,就能重建“决定了什么、为什么、依据什么证据”。
主要能力:使用单一 TSV 文件,每行一个决策,列为 ts(ISO8601 时间戳)、phase(阶段或工作流)、decision(选择或做了什么,一行)、why(用平实语言说明原因)、evidence(证明用的链接或路径,如 commit SHA、PR 号、file:line、产物或截图路径,不写段落)、result(结果或谓词状态,如 tests green、reverted、pixel-diff 0、INCONCLUSIVE、open)。TSV 便于 GitHub 渲染为可排序表格、终端用 column -s$'\t' -t 查看、表格软件读取,且可用一条命令追加行。
使用方式:复制 references/decision-log-template.tsv 的表头开始干净日志。用辅助脚本保持行格式正确:scripts/log.sh <logfile> <phase> <decision> <why> <evidence> <result>,它会写入时间戳、首次使用时写表头、清理多余制表符和换行,并对以 =、+、-、@ 开头的单元格加单引号前缀,避免在表格软件中触发公式执行。也可用 printf 追加行,但需注意同样字节问题。只记录决策点和检查点,不记录每个动作;循环运行每次迭代一行。默认日志是工作产物,不提交,放在工作目录的 decisions.tsv,或多个任务并行时放 .audit/<task-slug>.tsv,并排除在 git 外;仅当工作足够重要、审阅者需要轨迹来信任结果时才提交。
限制与规则:一行即一个决策或检查点,放不下一行说明决策还不够清晰;只追加,错误调用用新行取代,绝不编辑或删除历史;优先使用已提交脚本产生的证据而非手工一次性产物。运行结束交接前需对照本次运行的 transcript 审计日志是否属实,并必须用不同模型家族的子代理做跨模型复核,回复末尾以“Attention”段落列出复核模型和需关注项。资料未提供具体安装命令、收费或平台信息。