用途:为长时间运行或无人值守的工作保留一条可审查的决策轨迹,让评审者能信任工作结果。所有记录保存在单一 TSV 文件中,每行对应一次决策。
主要能力与格式:从 references/decision-log-template.tsv 的表头行开始创建干净日志。列为 ts(ISO8601 时间戳)、phase(阶段或工作流)、decision(选择或做了什么,一行)、why(直白原因,不写术语标签)、evidence(证明用的链接或路径:commit SHA、PR 号、file:line、产物或截图路径,不写段落)、result(结果或断言状态,如测试通过、已回滚、pixel-diff 0、INCONCLUSIVE、open)。
使用方式:可用 scripts/log.sh <logfile> <phase> <decision> <why> <evidence> <result> 写行,它会打时间戳、首次写入表头、清理杂散制表符/换行,并对以 =、+、-、@ 开头的单元格加单引号前缀;直接 printf 追加也可,但同样要处理这些字节。只记录决策点与检查点(如分叉选择、完成的单元及其验证结果、转向或回滚及其触发原因、暴露的阻塞、修复的关卡),循环每次迭代一行,跳过琐碎内容。
运行与存放:一次运行是一个智能体对话(含后续轮次及其摘要);接替、替换或新对话算新运行。当一次运行向已有行的日志追加时,其第一行 phase 用 start,并标明此前非本次运行所写行的 ts 范围,证据指向本次运行。默认日志是工作产物而非提交物,放在 decisions.tsv 或 .audit/<task-slug>.tsv,排除在 git 外;只有当工作足够重要、评审者需要轨迹时才提交。规则为仅追加,错误调用用新行取代,绝不编辑或删除历史。
限制与配套:运行结束时需用本次运行的 transcript 审计日志,并用 pstack-harness 技能定位会话存储,不要读其他工作区;找不到就说明审计未运行。回复末尾需附 Attention 段,列出交叉评审子代理(以 trail reviewer 角色)标记的问题。GitHub 可把已提交 TSV 渲染为表格,终端可用 column -s$'\t' -t decisions.tsv 查看。安装或价格等信息暂未提供。