agent-error-log 是一个让 AI 编程智能体记住自己所犯错误,并强制在修复之前先记录的系统。它是一个小巧、无依赖的系统,面向使用 AI 编程助手或构建自己智能体循环的任何人。该系统由三个文本文件、两个小工具、一个 git 钩子和可选的框架拦截器组成。它在修复之前记录每个错误及其根因,除非错误已被记录否则拒绝提交修复,并通过检查日志健康状况、重新阅读未解决的错误、重新呈现从过往失败中提炼出的教训,使每个会话在启动时都经过校准。不要求特定的模型、提供商或框架;任何能读取 .txt 文件并运行终端命令的智能体都可以使用。该系统通过结构、先因后果和强制执行来应对 AI 智能体的无状态问题,即智能体每个会话都要从头重新学习项目的失败模式。结构指每条错误记录都在机器验证的模板中写明症状、原因、修复和状态。先因后果指 CAUSE 字段在修复开始之前写好,没有它的条目会被 linter 拒绝。强制执行指 git 钩子会阻止未引用已记录错误的代码提交,使这条规则成为机械性的而非靠自觉。
使用 AI 编程助手的团队用 agent-error-log 在修复之前记录错误。
构建自定义智能体循环的团队用 agent-error-log 强制执行错误记录。
厌倦了同一个 bug 被引入两次的团队用 agent-error-log 防止其再次出现。
团队用 agent-error-log 通过 git 钩子强制执行先记录后修复。
团队用 agent-error-log 在启动会话时通过健康检查和未解决错误进行校准。