黑哥AI · AI 落地实战派 第 13 期 · 能跑了,还不算能交付
AI 实战教程 · 第 13 期

能跑了,还不算能交付 动手前怎么拆、坏了怎么修、怎么让东西经得住别人天天用,全程说人话

你让 AI 搓出来一个东西,跑起来了,效果还挺好,这一刻特别有成就感。

可要把它交给客户、交给同事天天用,中间还差着一截。

这一课就补这一截。

先给你吃颗定心丸:全程没有一行代码要你自己写,也没有一个专业词要你背。

每一步都是你说一句话,AI 去干。你要学的就两件事:会提要求,会验收。

零代码基础友好 你提要求它干活 每章一段现成话术
能跑了,还不算能交付
黑哥说

自己搓着玩,坏了重启就行。交出去的东西,坏了你是要赔笑脸的。

这两年我帮企业落地 AI,见得最多的场面就是:演示的时候当场很惊艳,一交到客户手里天天用,三天就崩。

差距翻来覆去就那几样:东西只在你电脑上能跑,只有你会用,坏了没人知道,改一点塌一片。

好消息是,这几样全都有招,而且每一招都是 AI 替你干,你一行代码都不用碰。

这一课把每一招的「要求怎么提、验收怎么验」都给你写好了,每章末尾那段话,复制粘贴就能用。

01

先认差距:样品和商品是两回事

章节漫画

你桌上那个 demo,是样品。

客户手里天天用的,是商品。

样品只要一次惊艳。商品得经得住天天用、随便点、乱输入。

打个比方。

你自己做了张 Excel 表,用得飞起。

发给全部门,第一天就有人把公式改崩了,第二天有人塞了一列你没想到的格式,第三天表就废了。

表没变,用的人变了。你能兜住自己,兜不住所有人,这就是样品和商品的距离。

交付前先掂量四样:换台电脑还能跑吗?只有你会用吗?坏了有人知道吗?改一点会塌一片吗?
这四问答不上来,东西还在样品阶段。下面一样一样补。

往下讲之前说好一件事。

后面每冒出一个新词,我当场给你翻译成人话。你听个大概就行,一个都不用背。

真记不住也没关系。每章末尾都有一段写好的话,你复制给 AI,它全知道该干什么。那段话是说给 AI 听的,你不用看懂。

02

动手前,先让它把东西拆成几块

章节漫画

大活别让 AI 一句话闷头搓。

这就跟装修一样,图纸都没出就让施工队直接砌墙,砌到一半你想改户型,墙全得拆。

正确的开工姿势:先让它把要做的东西拆成几块,用大白话讲给你听。

一般就三块:给人看的一块(页面、按钮),干活的一块(背后的逻辑),存东西的一块(你的数据放哪)。

这个「先拆块再动工」,程序员嘴里有个词,叫架构设计。词不用记,意思就是先出图纸,再砌墙。

你不用懂技术。图纸拿到手,就问三个问题。

数据存在哪?坏了哪块能单独换?以后想加功能往哪加?

这三个问题它答得清清楚楚,你再放它动工。答得含糊,现在就掰扯清楚,比砌完墙再拆便宜一百倍。

第 5 期讲过,先出计划再放行。这一步是同一个道理,只是从「先出计划」升级成「先出图纸」。

复制给 AI · 开工前先拆块
先别写代码。把这个系统拆成几块,每块干什么、数据存在哪、块和块怎么连,用大白话写一份结构说明给我。再告诉我:哪一块最容易坏,坏了能不能单独换,以后想加功能往哪加。我点头你再动工。
03

坏了别慌,排错就四步

章节漫画

系统一报错,新手最常见的反应是两种:把 AI 骂一顿,或者整个推倒重来。

两种都亏。报错是线索,你把线索用好,修起来快得很。

报错原样甩给它

别转述。整段复制,连你看不懂的那些红字一起贴过去。你用自己的话转一遍,线索就丢一半。

让它先说原因,再动手

跟它说「先别改,说出最可能的三个原因,按可能性排」。它一上来就动手,容易越改越乱。

一次只改一处,改完立刻验

两处一起改,好了你不知道是谁的功劳,坏了你不知道是谁的锅。

修三次没好,回退重来

回到上一个能跑的存档(第 7 期讲过,能回退就大胆试),换个问法重新来。在烂摊子上继续缝,越缝越烂。

打个比方。店里灯不亮,先看是不是跳闸了,再看是不是灯泡坏了。

上来就把整面墙的电线全换掉的,是冤大头。

复制给 AI · 报错了先这样问
系统报错了,报错信息我原样贴在下面。你先别动手改,告诉我最可能的三个原因,按可能性从高到低排,每个原因说清楚怎么验证。我确认是哪个之后,你一次只改一处,改完带我验一遍再改下一处。【把报错全文贴在这里】
04

可维护:让下一个人接得住

章节漫画

只有你会用的东西,你就是它的终身客服。

这就跟请年假前得写交接文档一个道理。文档写不明白,假期天天被夺命连环 call。

可维护就两个动作,全都让 AI 干。

第一,让它写一份说明书。这是个什么东西、怎么装、怎么跑起来、最常见的几个问题怎么办,全写清楚。

程序员管这份说明书叫 README。词不用记,你跟 AI 说「写份说明文档」,它就懂。

说明书的标准只有一条:一个没碰过这东西的新人,照着自己能跑通。跑不通就改到能跑通。

第二,让它每次改完活自动记一笔。这次改了什么、为什么改。

三个月后出问题,你翻一眼记录,三分钟就知道毛病出在哪。没记录,你对着一堆文件从头猜。

复制给 AI · 写一份新人能跑通的说明书
给这个项目写一份 README,按这个顺序:这是个什么东西、给谁用、怎么装、怎么跑起来、最常见的三个问题怎么办。标准只有一条:一个没碰过这个项目的新人,照着文档自己能跑通。写完你自己按新人视角走一遍,哪里走不通就改到走通。以后每次改动,都在文档末尾记一行:改了什么、为什么改。
05

可运作:能一直跑,才叫上线

章节漫画

跑一次是演示,一直跑才是服务。

这一步管三件事,一件都别省。

第一件,搬家。现在这东西住在你电脑里,你一合盖它就断气了。

得给它搬到一台一直开着的电脑上。这种电脑行话叫服务器,你就当是给它在外面租了个不熄灯的工位,一年几百块。

怎么租、怎么搬,你直接问 AI,它带你走全程。这个搬的动作,行话叫部署,词照样不用记。

你只管验收一句话:「我电脑关了,它还跑吗?」

第二件,它挂了你得知道。最糟的场面是客户比你先发现系统挂了。

最简单的招:让它每天定时给你发一条「我还活着」,发到飞书就行(第 2 期教过怎么接飞书)。哪天没收到这条消息,你就知道该看看了。

第三件,数据备份。第 7 期讲过,数据是单向门,没备份的数据丢了就是丢了。

让 AI 设好每天自动备份,然后一定要真演练一次「从备份把东西恢复出来」。

备份没演练过,等于没备份。这句话是无数人用真数据换来的。

复制给 AI · 上线前把三件事配齐
这个系统要正式上线了,给我出一份上线方案,讲清楚三件事。一,它部署在哪,我电脑关了它还能不能跑。二,它挂了我怎么第一时间知道,给我配一个每天定时报平安的通知。三,数据每天自动备份到哪,然后带我真做一次从备份恢复,恢复不出来就说明备份没用,改到能恢复为止。
06

可开发:改得动,才走得远

章节漫画

交付完第二周,客户一定会来一句:「能不能再加个小功能?」

改不动的系统,交付那天就是绝版。改得动的系统,才能跟着客户的生意一起做大。

养成三个习惯,系统就一直改得动。

小步走。一次让它改一件事,改完就验,验完就存档。步子越小,出了问题越好找。

加新不碰旧。让它动手前先说清「这次会动到哪些已有的文件」,动得越少越好。

交活前自己测。每次改完,让它把原来的主要功能挨个跑一遍,证明旧的没被改坏。

打个比方。餐馆加一道新菜,不该把厨房推倒重装。

要是加个菜就得停业三天,这厨房从设计那天就是失败的。

复制给 AI · 加功能不塌旧功能
给这个系统加一个新功能:【描述你要的功能】。动手前先告诉我,这次要动到哪些已有的文件,会不会影响现在能跑的功能。改完之后,把原来的主要功能挨个跑一遍给我看,证明旧的没被改坏,再交活。
07

交付前,过一遍这张单子

章节漫画

把整课收成六个问题。

每次要把东西交出去之前,对着过一遍,全答上来再交。

交付前六问 · 存下来每次过一遍
1. 换台电脑,它还能跑吗? 2. 有没有一份新人照着能跑通的 README? 3. 它挂了,你会第一时间知道吗? 4. 数据昨天备份了吗,备份真能恢复吗? 5. 改一处,旧功能还都活着吗? 6. 客户乱点乱输,它会当场露怯吗?没底就在交付前让 AI 自己乱点乱输测一遍。

自己用,图它跑得快。交出去,图它塌不了。

这六问过了,你的东西才算从样品变成商品。

最后还是那句话,AI 就是个得力的新人。

前面十二课教你怎么带它干活,这一课教你让它按正式员工的规矩交活。

规矩立住了,你搓出来的东西才接得住真实世界。

HeiGe-GEO-SEO

开源案例 · 黑哥自己的项目

这是我自己用 AI 搓出来、又按这一课的规矩收口的一个真实项目。它是干什么的你可以完全不关心,值得看的是交付的架子:说明书写到新人照着能跑通、几十道自动的检查题守着旧功能、每次改动都得先过这些题才算数。一个零基础的人从头搓出来的东西,做到什么样才算交付级,让 AI 带你翻一遍就有数了。

复制给 AI · 学它的交付架子
帮我把 https://github.com/HeiGeAi/HeiGe-GEO-SEO 克隆到本地。先别管它的功能,带我看三样东西:它的 README 是怎么写到新人能跑通的、它的测试怎么跑一遍、它的目录是怎么分块的。看完告诉我,这三样搬到我自己的项目里,第一步该干什么。
能跑了是起点,
交得出去才是本事。

动工前先拆块,坏了按四步排错,可维护、可运作、可开发一样样配齐。你搓出来的东西,从此接得住真实世界。

扫码添加作者飞书好友
黑哥飞书二维码备注 黑哥AI 更快通过