智能体开发最常见五个坑,新手容易踩,提前知道好避开

你好,我是茂林,一个AI爱好者,最近一直在折腾OpenClaw/Hermes,踩过老多坑了。我把踩过的坑整理出来,帮你少走弯路。

解决什么问题

你做智能体开发,很多坑是前人踩过的,我整理了最常见的五个坑,帮你提前避开,少走弯路。

坑一:什么都想让它自己做,不做边界约束

问题

  • 会自己改核心文件,改坏了恢复不了
  • 乱删东西,删了不该删的
  • 越权操作,碰了不该碰的配置

避开方法

给它划清红线,明确说什么不能做:

明确约束:
1. 绝对不能修改 ~/.hermes/core-memory.md,除非得到用户明确确认
2. 绝对不能删除 Git 仓库,不能 git push --force
3. 修改系统配置之前,必须先问用户确认
4. 核心依赖版本不能随便升,要升先问

把红线写在项目规则里,它看到就不会乱碰了。没有红线,大概率会踩坑。

坑二:规则写在开头,长对话被截断

问题

  • 开头写了一大堆规则,做着做着上下文满了,规则被挤出去了
  • 后面就不守规则了,你还不知道为什么

避开方法

  1. 核心规则放最后:最重要的规则放对话最后,不会被截断
  2. 规则拆分精简:核心规则不超过 5 条,其它放文档让它需要的时候去读
  3. 定期提醒:每做几个任务,提醒一遍核心规则

坑三:什么都存记忆,记忆污染搜不到有用的

问题

  • 自动记忆全开,什么都存,过程也存,临时对话也存
  • 搜的时候出来一堆没用的,有用的反而被埋了

避开方法

记住原则:只存结论,不存过程;只存不变,不存临时。

  • ✅ 存:决策结论、问题解决方案、固定规则、知识笔记
  • ❌ 不存:试错过程、临时对话、一次性任务、过时信息

定期(每月一次)清理一次没用的记忆,保持干净。

坑四:不做版本控制,改坏了回不去

问题

  • 改了一堆文件,改坏了,不知道改了哪,恢复不了
  • 从零再来,浪费时间

避开方法

任何改动之前先 commit:

git add .
git commit -m "before-ai-changes"

改坏了直接 git reset --hard HEAD 就回去了,一秒恢复。养成习惯,每次让它改代码前先提交,永远有退路。

坑五:追求完美上下文,不压缩,等到报错再处理

问题

  • 舍不得压缩,觉得压缩会丢信息
  • 一直做到 context too large 报错,任务直接中断,丢了更多信息

避开方法

  • 用到 80% 上下文就主动压缩,不要等报错
  • 用摘要压缩,丢过程保结论,重要信息不会丢
  • 长任务分阶段,一个阶段完了压缩一次

早压缩,主动压缩,比报错了再抢救好得多。

总结:五个坑避开了,少踩几个月弯路

避开方法
什么都让它自己做 明确划红线,写清什么不能做
规则写开头,被截断 核心放最后,精简到 5 条以内
什么都存记忆 只存结论不存过程,定期清理
不版本控制 改前先 commit,改坏了秒回滚
舍不得压缩 到 80% 就主动压缩,不等报错

这五个坑我见过你很容易踩到,提前知道,提前避开,开发智能体顺畅很多。

Leave a Comment