用途:为长时间运行或无人值守的工作保留可审查的决策轨迹,让审阅者能理解过程并信任结果。核心是一份规范化 TSV 日志,每个决策一行。
主要能力:日志列为 ts(ISO8601 时间戳)、phase(阶段或工作流)、decision(选择或做了什么,单行)、why(用平实语言说明原因)、evidence(指向证明的链接或路径,如 commit SHA、PR 号、file:line 或产物、trace、截图路径,不写段落)、result(结果或谓词状态,如测试通过、已回退、像素差异 0、INCONCLUSIVE、open)。提供模板 references/decision-log-template.tsv 与辅助脚本 scripts/log.sh <logfile> <phase> <decision> <why> <evidence> <result>,脚本自动打时间戳、首次写入表头、清理多余制表符与换行,并对以 =、+、-、@ 开头的单元格加单引号前缀。
用法要点:只记录决策点与检查点,如选择的分叉、完成并验证的单元、转向或回退及其触发原因、暴露的阻塞、修复的门禁;循环运行每次迭代一行,跳过琐碎内容。每次 agent 对话为一次 run;向已有日志续写时首行 phase 为 start,并说明此前非本次写入的行的时间范围。默认日志为工作产物,放在工作目录 decisions.tsv 或 .audit/<task-slug>.tsv,不纳入 git;仅当工作需要审阅者依赖该轨迹时才提交。规则:只追加,错误调用用新行取代,不编辑或删除历史;优先使用已提交脚本产生的证据。
审计与复核:运行结束前对照本次 run 的会话记录核验日志,确保每行对应真实决策或动作、证据可解析,遗漏的分叉、转向或放弃方案需补记;纠正日志而非改写叙述,错误行用新行取代。随后启动不同模型家族的子代理进行跨模型复核,标记证据薄弱、未验证步骤、事后看有风险的选择及易被忽略的缺口。
限制:本地默认保存;审计范围仅限本次 run 的行段,不检查他人行;跨模型复核的具体模型与平台支持情况暂未提供。查看时可用 column -s$'\t' -t decisions.tsv 在终端渲染,GitHub 可将提交的 TSV 渲染为表格。