明明只是让 AI “加个小功能”，
结果它把你整个项目结构都“重构”了？🙃

别急着骂模型菜。
真相只有一个：不是它不行，是你不会“用人”。

今天这篇，不讲玄学，只讲一个被 90% 程序员忽略的小技巧：
👉 给 Coding Agent 写“任务说明书”。

一、AI 不是你肚子里的蛔虫

很多人对 AI 的期待是这样的：

• “我说一句话，它就能懂我的灵魂。”

现实是：

• “你说一句话，它就开始自由发挥。”

真实数据很扎心：
82% 的失败，都死在「任务描述」这一步。

你以为你在布置工作，
它以为你在让它参加《荒野求生》。

二、像带实习生一样带 AI

记住一句话：

AI = 刚入职、很努力、但不懂业务的外包新人

你会怎么带新人？
肯定不是甩一句：“你去把这个做了。”

你会说：

• 别动哪几张表
• 参考哪个模块
• 做到什么程度算合格

Coding Agent 也一样。

三、一个万能“五段式”提示词模板 

以后给 AI 派活，照着这个结构来写，成功率直接从 23% → 60%+。

1️⃣ 任务定义（≤2句）

说清楚：做什么 + 做成什么样

• ❌ 不要：“优化一下性能”
• ✅ 要：“把订单导出接口的响应时间降到 500ms 以内”

2️⃣ 相关代码

告诉它去哪看：

• 关键文件路径
• 类似功能的参考实现

这样它就不会满仓库乱翻，还顺便把你不常动的代码“顺手修一修”。

3️⃣ 约束与禁区 ⚠️

这一段最重要！

比如：

• 不准改登录逻辑
• 必须复用现有工具函数
• 不能用新库

把“红线”画清楚，比教它怎么做更重要。

4️⃣ 验收条件

别只说“搞定就行”，要说：

• 接口返回什么字段
• 页面长什么样
• 日志里有没有报错

让它能自检，而不是等你来当 QA。

5️⃣ 输出格式

明确告诉它：

• 只要改动清单 + SQL
• 不要长篇大论的“论文式分析”

省下来的时间，都是你摸鱼的时间 😎

四、再送你一个“懒人外挂”：CLAUDE.md

如果你用的是Claude Code / Cursor，
强烈建议你搞一个：

📄CLAUDE.md

相当于给 AI 发的项目入职手册：

• 用什么框架
• 目录怎么拆
• 哪些事绝对不能干

写好一次，后面所有对话自动生效。
越写越聪明，越用越省心。

五、写给每一个被 AI 气到想砸键盘的人

说实话，我们不是讨厌 AI。
我们只是讨厌：

• 明明是为了早点下班，结果变成了加班修 Bug
• 本来只想偷个懒，结果像带了个永远不毕业的实习生
• 技术越来越强，心情却越来越差

但你换个角度想想：

它不是在跟你作对，
它只是在等你，好好跟它说一次话。

从今天开始，
别再对它吼“你怎么这么蠢”，
试着像带新人一样，带它一把。

你会发现——
真正厉害的，从来不是 AI，而是会“用 AI 的人”。

🥤 写在最后的小请求

如果你也有过：

• 被 AI 气笑的时刻
• 一句 Prompt 拯救整个项目的瞬间

欢迎在评论区讲讲你的故事 👇
说不定，你的经验，刚好能救另一个快秃头的程序员一命。

如果这篇文章让你觉得：“啊，这说的就是我！”
那就顺手转给你那个，天天跟 AI 打架的同事吧 😂，他可能不会请你吃饭，但一定会默默在心里给你点个赞 👍