用途:为长时间运行或无人值守的工作保留一条可审查的决策轨迹,让审查者能快速了解做了什么、为什么这么做、依据是什么、结果如何。
主要能力:维护一份规范的 TSV 日志,每行一个决策,单元格保持单行,证据用指针而非大段文字。列包括 ts(ISO8601 时间戳)、phase(阶段或工作流)、decision(选择或做了什么,一行)、why(用平实语言说明原因)、evidence(提交 SHA、PR 号、file:line、产物/追踪/截图路径等可验证指针)、result(结果或谓词状态,如测试通过、已回滚、像素差异 0、INCONCLUSIVE、open)。
使用方式:复制 references/decision-log-template.tsv 的表头开始新日志。可用辅助脚本 scripts/log.sh <logfile> <phase> <decision> <why> <evidence> <result>,它会写入时间戳、首次使用时写表头、清理多余制表符和换行,并对以 =、+、-、@ 开头的单元格加单引号前缀;也可用 printf 追加行,但需注意同样的问题。只记录决策点和检查点,不记录每个动作。默认日志是工作产物,放在工作目录的 decisions.tsv,或多个任务并行时放在 .audit/<task-slug>.tsv,不纳入 git;仅当工作需要审查者依赖轨迹才能信任结果时才提交。
规则与限制:日志只追加,错误决策用新行取代,不编辑或删除历史。运行结束前需对照本次运行的 transcript 审计日志,检查每行是否对应真实决策或动作、证据是否可解析并支持其声明,缺失的分叉或转向需补记;审计不修改或删除行,错误行用新行取代。还需由不同模型族的子代理做跨模型审查,并在回复末尾以 Attention 段落列出审查模型和需关注的问题。日志文本应使用平实语言,避免 AI 腔和抽象术语。
适用场景:长时间运行、无人值守、需要可审查决策轨迹的工作。
限制:资料未提供具体安装方式、收费、平台支持范围等信息。