AI 反思

是什么

AI 反思是 AI 对自身过程错误的记录机制。当 AI 发现自己犯了可重复的工作流错误，或差点重复犯错时，会把反思写入 docs/current/workflow/ai-reflection/。

这些反思不是情绪化总结，而是面向后续执行的约束记录：错误是什么、为什么发生、下次应如何避免。

为什么需要它

AI 常见的问题具有重复性，例如过早实现、跳过验证、误用文档来源、错误委派、丢失上下文或在没有足够证据时声称完成。

如果这些错误只在一次对话中被纠正，下一次任务仍可能再次发生。AI 反思把经验沉淀为可扫描的约束，让项目能够从过程错误中积累防护。

如何使用

当 AI 检测到自己出现或接近出现过程错误时，会自动调用反思流程，并在 docs/current/workflow/ai-reflection/ 下记录文档。常见错误类别包括：

• 过早实现
• 跳过验证
• 文档误用
• 委派误用
• 上下文丢失

反思文档应写清触发场景、错误模式、纠正动作和后续约束。后续 Feature 开始时，契约扫描 会读取这些反思，并把相关约束注入执行上下文。

与其他机制的关系

AI 反思与 契约扫描 形成闭环：反思记录错误，契约扫描把反思转化为执行约束，从而降低再次犯错的概率。

它也能为 对抗性硬化 提供线索，帮助审查过程关注那些项目中已经出现过的高频风险。