用途:为长时间运行或无人值守的工作保留可复核的决策轨迹,让评审者能快速了解每一步做了什么、为什么这样做、证据在哪、结果如何。
主要能力:维护一份规范日志,单个 TSV 文件,每次决策一行,单元格保持单行,证据用指针而非大段文字。列为 ts(ISO8601 时间戳)、phase(阶段或工作流)、decision(选择或做了什么)、why(用平实语言说明原因)、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;仅当工作需要评审者靠轨迹才能信任结果时才提交。规则:只追加,错误决策用新行取代,绝不编辑或删除历史。
运行结束时需对照本次运行的对话记录审计日志,检查每行是否对应真实决策或动作、证据是否可解析并支持其声明,发现缺口就补记;审计不修改或删除任何行,错误行用新行取代。交付前还应让不同模型家族的子代理审阅轨迹,标记证据薄弱、验证缺失、事后看有风险的选择等,并在回复末尾以 Attention 段落列出,首行为 reviewed by <model>。
适用场景:长时间、多阶段、无人值守的 AI 代理工作,需要向评审者交代决策依据时。
限制:在 GitHub Copilot 上使用前需先阅读平台映射及其各技能说明;审计时只读取本次运行在 ~/.claude/projects/<encoded-cwd>/ 下的对话记录,不要跨项目通配,以免读到无关私密对话。其他事实暂未提供。