同行

第 6 章/独立负责

和 AI 一起做东西,怎么才不返工?

你把需求说明发给小满,他做出了第一版。你点了点,挺高兴,接着说:“再加个导出功能,顺便把界面改好看点,排名那里加个图表,对了,评委名单能不能从 Excel 导进来……”

他一口气全改了。改完,导出能用了,图表也有了,可原来好好的打分功能,算出来的排名不对了。你都不知道是哪一处改坏的。

和 AI 一起做东西,最常见的坑不是“他做不出来”,而是一次要得太多。改动一多,坏了都不知道坏在哪。

这个站就是这么做出来的

说一个真实的例子:你正在读的这个网站,就是本站作者和几个 AI 一起做出来的。中间走过弯路,也是最好的教材。

试一下

这个站是怎么和 AI 一起做出来的

  1. 1

    和 AI 来回聊了几轮,写出四份文档:给谁看、讲什么、长什么样、用什么做。中途推翻了一次:第一版设计太“艺术”,改成了现在这样安静的样子。

    学到的:需求文档就是写给 AI 的交办单(3.2)。改需求要趁早,改文档比改代码便宜得多。

  2. 2
  3. 3
  4. 4
  5. 5
  6. 6

五步走

步骤你做什么交给 AI 什么
1. 说清需求用上一节的计算器理清楚,让 AI 先反问你回答问题,提出更简单的做法
2. 先要一个能点的原型只要最核心的那一个功能做一个最小版本
3. 一次只改一处每次只提一个改动,改完马上试改那一处,其他不动(3.4)
4. 自己验收准备几组你知道答案的数据,算一遍对一对帮你写测试数据
5. 交付和备份留一份说明书,定好谁来维护写说明书、写使用手册

第 4 步最容易被跳过。你知道答案的数据,是你验收的唯一底气:比如五个评委的分数,你手算过排名,拿来一试就知道对不对。

做第一版原型
我想做一个小工具:[一句话]。
需求说明:[粘贴上一节计算器生成的那段]

请先只做最核心的一个功能:[比如:输入每位评委的分数,去掉最高最低分,算出平均分和排名]。
做成一个单独的 .html 文件,双击就能在浏览器里打开,不需要安装任何东西。
界面简洁,所有文字用中文。
做完告诉我:怎么打开,怎么用,以及我可以用哪几组数据来检查它算得对不对。

AI 写的网页文件,用 DeepSeek 就能生成,复制代码存成 .html 文件即可。用 WorkBuddy 这类能动手的工具,它会直接把文件交给你。

API:给程序用的窗口

DeepSeek 网页版是给人用的界面;API 是给程序用的窗口,背后是同一个大脑。这个站设置里填的 key 走的就是 API:你的浏览器直接把对话发给 DeepSeek 的服务器。

key:门禁卡,也是账单

谁拿到你的 key,就能用你的名义调用,费用记在你的账上。所以别发群里、别写进代码里。不小心泄露了,就去 DeepSeek 后台作废,再换一个新的。

按 token 计费

输入和输出分开计价,输出更贵。重复发送的相同开头能命中缓存,这部分输入更便宜。我们测接口时,返回结果里就带着 prompt_cache_hit_tokens 这个字段。

API 不记事

每次请求都是独立的。所谓“他记得上一句”,是程序每次把前面的对话一起重发(第 3.4 节的硬核部分讲过)。这个站也是这么做的。

为什么全部门共用一个 key 就得有后端

这个站只有前端,没有自己的服务器,所以 key 只能放在你自己的浏览器里。想让全部门共用一个 key 又不让人看见,就得有一台后端服务器把 key 藏起来,替大家转发。这正是第 6.2 节阶梯里,从 L2 迈到 L3 的那道坎。

对应到小满: API 是他的工作邮箱,key 是你的工牌,工牌借出去,账就记在你头上。

现在试试· 用 DeepSeek 或 WorkBuddy,五分钟

  1. 用上面的卡片,做出你那个小工具的第一版。
  2. 准备三组你知道答案的数据,逐一试一遍。
  3. 只挑一个你最想改的地方,让它改,改完再试一遍。