第 2 关 · 把话说清楚
一句好的交代有四段:目标、拓扑、约束、验收。少一段,AI 就只能猜。
阶段 0 · 先弄明白
第 2 关
- 25 分钟
- 不花钱
- 做完你会得到:一个四段式的说法,后面每一关都用它
在这里盖章
这一关解决什么
AI 做得好不好,大半取决于你说得清不清楚。这一关练的就是怎么说。
不用学术语,也不用写得很长。看这位负责人平时怎么说的:
「确保配置都是一样的,网关的容器也要确保都可以一键启动,没有那种本机独特才有的东西」
一句话里有目标(备用机随时能顶上)、有约束(不能有只在某一台机器上才有的东西)、有验收(一键能启动)。
AI 据此把备用机上的配置和镜像做成和生产一致,并加了一个每天自动跑的检查:两边不一致时,改动推不上去。
四段
一句交代里有四样东西。点下面四块,把它们加进去或拿掉,看 AI 收到的是什么,缺的那段它会怎么猜。
点下面四块,把它们加进去或拿掉,看右边 AI 收到的是什么。
AI 收到的话
我要这个网站挂了的时候,我比用户先知道。
没说拓扑:它得自己去翻机器。翻得到还好;翻漏一台,那台就没人盯。
没说约束:它可能为了装监控重启服务;也可能把所有小毛病都推给你,一天上百条,你很快就不看了。
没说验收:它会说「已完成」,但没人验证过告警真的发得出来。
| 段 | 回答什么 | 不说会怎样 |
|---|---|---|
| 目标 | 你要什么结果 | 它做了一件事,但不是你要的那件 |
| 拓扑 | 有哪些机器和服务,彼此怎么连 | 它自己去翻,翻漏的那台没人管 |
| 约束 | 什么不能碰,什么要省 | 它为了完成任务重启了生产,或者花了钱 |
| 验收 | 怎么算做完 | 它说「已完成」,没人知道是不是真的 |
目标:说结果,不说做法
这样说,它只能猜
帮我装一个夜莺,配上告警规则。
这样说,它知道做到哪算完
我要这个网站挂了的时候,我比用户先知道。
前一句是做法。装完了,它就算完成了,至于告警发不发得到你手机上,不在这句话里。后一句是结果,用什么工具、配什么规则,它自己定,但做不到「你先知道」就不算完。
你说的是做法,它就照做法做。你说的是结果,它会为结果负责。
如果你不知道该要什么结果,直接问它。这也是真实的用法:
「如果真出问题了,能不能及时回滚」
这是在一次生产切换之前问的。他没有说「给我做一个回滚方案」,而是问了一个他真正担心的问题。
当时的回滚方案只有三行字,没排练过。AI 在切换后的真实状态上把回滚逐步做了一遍,查出三处问题。其中两处的后果是悄悄发生的:余额差几笔、有人看到别人的记录,事后很难查到是回滚造成的。
拓扑:让它知道你有什么
拓扑就是「有哪些机器、上面跑着什么、谁连着谁」。第一次交代一件事的时候要说,之后它会记进仓库,你就不用再说。
说到这个程度就够:
对助手说
我有两台机器。dev 是开发机,你就在这台上。prod 是生产机,上面跑着我的网站,三个容器:proxy 接访问,web 是网站本体,db 是数据库。域名 指向 prod。你能从 dev 用 ssh prod 登上去。
三样东西一定要说:
- 哪台是生产。 它对生产会更小心。
- 数据在哪。 数据库在哪台、有没有备份。数据丢了找不回来。
- 你自己都不清楚的地方。 直接说「这台上还有什么我不确定,你去查」。比装作清楚要好。
「我目前域名全在 cf,阿里云的也没有在用了」
一句拓扑上的事实。当时 AI 在好几台机器上发现还配着另一家云的解析账号,不知道是不是在用。有了这句话,它把这些全部当成残留,逐个清理掉了。
约束:什么不能碰
约束只说真正要紧的。常用的就这几类:
| 类别 | 例子 |
|---|---|
| 不能停 | 「不要重启 prod 上的容器」 |
| 不能删 | 「不认识的东西标成待查,不要删」 |
| 不能花钱 | 「需要买东西先问我」 |
| 不能太吵 | 「告警只发真正影响到用户的」 |
| 不能漏 | 「所有机器都要做,一台不落」 |
有些约束不是一开始就想得到的,是它做了之后你才发现不对。这时候直接否掉,说出理由:
「备份太多了,很快就会把我的东西占满」
AI 的第一版方案是「默认全部备份,只排除缓存」,没实测过会占多少空间,而其中一块磁盘上有 110 GB 的视频。被这句话否了。
理由比结论重要。有了「会占满」这个理由,下一版方案改成了只备份重建不出来的东西。
验收:说清怎么算做完
验收是四段里最容易漏的,也是最值钱的。没有它,你只能相信它说的「做完了」。
最好的验收是故意弄坏一次:
这样说,它只能猜
做完告诉我。
这样说,它知道做到哪算完
做完后我会手动把网站停掉。 五分钟内我的手机要收到通知,写清影响了谁、我该做什么。
后一句让它知道你真的会去试。它会自己先试一遍,试不通的会在交给你之前修好。
也可以只问一句,逼它把证据拿出来:
「都验证清楚了吗」
那一轮改了很多页面。AI 的回答没有只说「验证了」,而是分层说:哪些只是编译通过,哪些真的在页面上点过。编译通过只能证明代码拼得上,证明不了按钮点得动。
后来这句话被做成了程序:改动推送之前自动检查有没有验证记录,拿不出来就推不上去。那是第 15 关。
练一次
把你现在最想让 AI 做的一件事,写成四段。不用发给谁,写在记事本里就行。下面是个例子,照着改:
对助手说
目标:我想知道我的网站每天有多少人访问。 拓扑:网站在 prod 上,入口是 proxy 容器,访问记录应该在它的日志里。 约束:不要改网站本身,不要重启任何容器。 验收:给我一个每天早上能看到的数字,并且告诉我这个数字是怎么算出来的。
过关检查
每一条都亲手验过再打勾。全部打勾,这一关盖章。
再短一点也行
四段是给第一次交代一件事用的。等它摸清了你的家底,你的话会越来越短:
- 「全部做一遍。」
- 「该退的直接补齐。」
- 「Agent 能把控的直接修。」
这些都是真实说过的话。能说得这么短,是因为拓扑已经在仓库里,约束已经写成了规则,验收已经做成了程序。那是后面几个阶段要做的事。
最后更新于