AgentFails

关于智能体翻车库

智能体翻车库（AgentFails）收集 AI 编程智能体的各种翻车方式，并为每一种配上今天就能粘贴进仓库的修复。它免费、开源，内容来自社区投稿。

三分法

检查智能体的产出，归根结底是三个问题。这个分法来自 @liushiyumath 关于审查智能体产出的 X 帖子。这里的每条模式都只属于其中一类：

  1. 1. 做错了功能: 做的是对的东西吗？

    它做的东西不是你想要的。到审 PR 时已经太晚了。应该让队友在写代码之前就在需求文档、设计稿或产物上批注，并写出能排除错误理解的验收标准。

    做错了功能 →

  2. 2. 有 Bug: 没有 bug 吗？

    功能是对的，但有 bug。用审查环节来抓（/code-review 类技能或上下文干净的审查者）、用智能体改不了的真实测试、用证据代替口头声明。

    有 Bug →

  3. 3. 越界 / 不理想: 是你想要的做法吗？有没有越界？

    能用、也没 bug，但不是你想要的做法。例如：你只让改个前端小地方，智能体却动了后端逻辑。修复方式是把共享的 /verify 技能、范围规则、diff 预算和钩子放进仓库，让整个团队用同一套护栏。

    越界 / 不理想 →

X: post 1post 2

一条模式包含什么

  • 名称和类型（做错功能、有 bug 或越界）。
  • 你看到的症状、智能体为什么会这样、一个最小示例。
  • 复制即用的修复：CLAUDE.md、AGENTS.md、.cursor/rules 的规则，必要时再加 Claude Code 钩子、技能或 CI 检查。
  • 来源。写在上下文文件里的规则是建议；钩子、权限和 CI 检查才是强制。我们会说明哪个是哪个。

智能体标签表示这条模式的修复覆盖了哪些智能体。大多数模式在各家智能体上都有报告，所以多数条目四个标签都有。

致谢

首批条目改编自以下公开的分类和指南。每个条目页面都链接了具体来源，建议去读原文。

维护者：@liushiyumath。内容存放在 GitHub，修改都通过 Pull Request 进行。

投稿翻车案例