5个让AI代理变“傻”的致命错误，和30分钟就能改好的硬核解法

作者提米哥

❌ 错误 1：没给 AI “立人设” → 它就是个复读机

问题：直接丢一个默认模型去干活，结果它说话像客服机器人：“您好，这个问题有多种解决方案……”（然后啥也没解决）

解法：给它一份「人格说明书」，我们叫它 SOUL.md（灵魂文件）。别被名字吓到——它就是一个纯文本文件，50 行以内，回答 4 个问题：
– 它是谁？（比如：“你是一个专注前端部署的工程师，熟悉 Vercel、Docker 和 Next.js”）
– 它怎么说话？（比如：“用短句，带代码块，不讲废话；遇到不确定的事，直接说‘我不确定，但可以试试……’”）
– 它知道什么？（比如：“你知道本项目用 pnpm + Turborepo，CI 跑在 GitHub Actions”）
– 它绝对不做啥？（比如：“绝不修改 package.json 的依赖版本，除非用户明确要求”）

加了这个文件，响应质量不是“好一点”，而是从“查资料”变成“真同事”。下面对比一目了然：

# 加 SOUL.md 前（泛泛而谈）
User: 怎么把本地 Next.js 项目上线？
Agent: 部署方式有很多，比如 Vercel、Netlify、Docker 等，你可以根据需求选择……

# 加 SOUL.md 后（精准出手）
User: 怎么把本地 Next.js 项目上线？
Agent: 你用的是 pnpm + Turborepo，推荐直接推到 Vercel：
1. 在项目根目录运行 `pnpm build`
2. 登录 Vercel CLI：`vercel login`
3. 部署：`vercel --prod --git-dry-run=false`
✅ 我已帮你生成 vercel.json（含 turbo 缓存配置），需要我贴出来吗？

💡 提米哥说：这不是“拟人化”，是降低沟通熵值。就像你不会让新同事第一天就自学公司全部文档，AI 也一样。

❌ 错误 2：把整个世界塞进它的脑子 → 它直接宕机

问题：一股脑把 50 页手册、300 个 API 文档、上周会议记录全喂给 agent——结果它反应慢、答偏、还乱引用。

解法：信奉「最小够用原则」——只给它当前任务真正需要的那几行信息。
– ✅ 好做法：给 8 行关键配置说明 + 1 个链接：“详见 docs/deploys.md 第3节”
– ❌ 坏做法：把 docs/ 整个文件夹拖进 prompt

额外技巧：把长期知识（如公司规范、技术栈约定）存在单独的 memory.md 里，让 agent 按需读取，而不是每次都在 prompt 里重复加载。

❌ 错误 3：没教它“出错了怎么办” → 它会死循环或装死

问题：agent 调用 API 失败了，不报错、不重试、也不求助，就卡在那儿——你刷新十次，它还是同一句：“正在处理中……”

解法：在系统提示词里，写死 4 条「故障守则」，就像给程序加 try-catch：

## 错误处理规则（必须遵守）
- 如果调用工具失败，立刻换一种方法再试（例如 curl 失败就改用 fetch）
- 同一个任务连续失败 3 次，停止尝试，清晰告诉用户：“我卡在 XX 步，需要你帮我确认：A. XXX？B. YYY？”
- 绝对不隐藏错误！哪怕只是“权限不足”，也要原样说出来
- 每次失败，自动记录到日志：时间 + 步骤 + 报错原文（方便你后续排查）

这一步做完，80% 的“我的 agent 又不动了”问题，当场消失。

❌ 错误 4：没加安全围栏 → 它可能删库跑路

问题：agent 自动执行 rm -rf node_modules、自动发 Slack 消息给 CEO、自动调用 $200/次的付费 API……你还没反应过来，账单和道歉邮件已经发出去了。

解法：用白纸黑字写清「三条高压线」，放在所有指令最开头：

## 安全红线（违反即终止）
- 删除/覆盖任何文件前，必须输出完整路径 + 询问：“确认删除？[y/N]”
- 给任何人发消息（Slack/Email/IM）前，必须列出收件人+内容草稿 + 等待你输入“发送”
- 单次会话调用付费 API 总费用超 $5，立即暂停并提醒：“本次已花费 $4.8，继续将触发扣费”
- 所有高危操作（删、发、付、改权限），必须先用中文解释“这一步会做什么”，再执行

🔐 提米哥说：真正的自由，来自清晰的边界。 不是限制能力，而是让能力可预期、可托付。

❌ 错误 5：建完就扔 → 它很快变成“过期员工”

问题：你花两天搭好 agent，上线后就再也不管。一个月后，它还在推荐已废弃的部署方式，对新出的 Next.js App Router 一无所知。

解法：把它当真人同事来养：
– 每月花 15 分钟更新 SOUL.md：加一条新规范、删一条过时命令
– 每周扫一眼日志，记下它反复答错的问题 → 补进知识库
– 用户反馈“这里说得不清楚”，就优化它的表达模板（比如把长段落改成带 ✅/⚠️ 的清单）
– 版本号别写 v1.0，写 v17.2 —— 这才是活的证据

我见过最稳的 agent，版本号是 v23，不是因为炫技，是因为它真的在进化。

✅ 终极心法：别把它当程序，当队友

这 5 个错误，根源只有一个：
我们习惯写代码——给变量赋值、给函数传参、期待它完美执行。
但 AI agent 不是函数，它是需要入职培训、工作手册、KPI 反馈和季度复盘的数字同事。

花 30 分钟认真写一份 SOUL.md、加四条错误规则、划三条安全线——
你换来的不是“一个能跑的 demo”，而是未来一个月每天多出 2 小时、少踩 10 次坑的靠谱搭档。

现在，就打开你的编辑器，新建一个 SOUL.md。第一行写：
# 我是 [你的名字] 的 AI 开发助手，专注帮你搞定 [具体一件事]
——这就已经超过 70% 的人了。

直达网址：https://leimspire20.gumroad.com/l/hyuzc

类似文章