AI 编程全流程:Codex 交付产品的五步与三条原则
以电子书阅读器为例,把 AI 编程拆成环境搭建、产品设计、技术设计、产品实现、人工验证五步,并给出三条不能省的原则。
这条视频的示例项目是一个电子书阅读器,作者用自己的 AI 编程流程把它做完,再把流程拆成五个环节讲了一遍。它要回答的问题很具体:直接给 AI 发一句「帮我做个笔记软件」也能出东西,但出来的东西往往跟你想的不是一回事,bug 还不少。
五个环节依次是环境搭建、产品设计、技术设计、产品实现、人工验证。前两步打地基,后三步做执行和把关。演示工具是 Codex,出现在视频里的每个动作,基本都对应着一类具体的失败场景。
如果你已经在用 AI 写代码,但每次交付都要自己当测试员,这条视频给的框架值得照着走一遍;如果你只是想看看 AI 编程现在到了什么程度,看前两个环节就够。
先补齐这几个词
MVP:minimal viable product 的缩写,指第一版只做最核心、能把主流程跑通的功能,用来低成本验证产品方向。在这条视频里,它决定了第一版砍掉什么:EPUB 支持砍成只支持 TXT,三种主题砍成只做明亮主题,书签不做。
AGENTS.md:放进项目里给 AI 读的说明文件,每轮新会话开始时会优先被读取,用来传递项目背景和开发规范。在这条视频里,它承载两条硬规则,每次改动必须创建 git commit,每次改动必须编写或更新测试。
demo:这里指可实际操作、但后端用模拟数据的前端页面,只把界面和交互做出来。在这条视频里,它被当作一个可选步骤,用来在真实后端动工之前先确认操作流程顺不顺手。
Codex:OpenAI 的通用编程 Agent,可搭配 GPT 以及 DeepSeek、GLM、Kimi 等模型使用。在这条视频里,它是从头用到尾的操作工具,作者关于插件和验证能力的建议也都围绕它展开。
视频的脉络
视频从「一句话让 AI 做软件」的失败体验讲起,随后按项目推进的顺序把流程走了一遍:先搭环境和规则,再定产品边界,接着选技术栈,然后实现并验证,最后回到原则层面收口。中途没有换主题,五个环节就是它的全部骨架,而且每个环节都停在一个可以照着做的动作上,不是停在概念上。
分段拆解
开场:为什么一句话交给 AI 不够用
作者指出,直接给 AI 一句「帮我做个笔记软件」,确实能得到能跑起来的东西,但效果和预期差距很大,bug 也不少。原因说得很直白:你想的是一个东西,AI 交付的是另一个东西。后面那五个环节,就是为了缩小这个落差。
环境搭建:Git 与 AGENTS.md
这一步做了两件事。用 Git 初始化项目,每完成一个功能就存成一个版本,代码被搞乱时可以回退到之前的可用状态。然后创建 AGENTS.md,也就是给 AI 的项目说明书,新会话优先读取,里面写了两条硬性要求:每次改动必须创建 git commit;每次改动必须编写或更新测试,交付前确保所有测试和验证通过。第二条的作用是让 AI 自己先跑一遍,挡掉明显的问题。
产品设计:先砍 MVP 的边界
作者会先跟 AI 讨论 MVP 的边界。视频里的例子是:最初 AI 建议支持 EPUB,作者砍成只支持 TXT;三种主题砍成只做明亮主题;书签不做。讨论完整理成一份设计文档,这份文档不追求详尽,只定大方向。
demo 是这一步的可选动作,一个可操作、但后端用模拟数据的前端页面。它有两个好处,提前验证产品设计,以及让后续实现更精确,因为它能直观告诉 AI 最终想要的样子。
技术设计:新开会话定技术栈
技术设计单独开一个会话讨论,最终选的是 Electron 加 React、TypeScript、Vite 和 Electron Forge 这套架构。视频里提到,Codex 判断 Electron 很适合这个项目并优先采用,同时也给出了 Electron 的缺点和 Tauri 这个备选项。
产品实现:先给 AI 自测能力
动手实现之前,作者强调必须先给 AI 自测的能力。建议是在 Codex 上至少装两个插件,computer use 用来操作电脑,Chrome 用来查看页面。没有验证环境,AI 只能把代码写完就交,bug 全积到交付那一刻,而你就变成了它的测试员,来回帮它找问题很费时间。
实现完成后,作者亲自跑了一遍,一上来就报错,让 Codex 修完才通过。
收尾:五步流程与三条不能省的原则
结尾把前面讲的内容收成五步流程,并给出三条不能省的原则:用 Git 搭好环境、让 AI 具备自测能力、最后一定要人工验证。作者还提到,产品设计和技术设计要做多细,取决于你想保留多少掌控力。参与越多,把控越强,但更费时间;参与越少越快,偏差风险也越高。
转折出现在哪
这条视频在观点上没有反转,五个环节是一条直线。唯一一处从「建议做」变成「看情况做」的是 demo:作者先讲了它的两个好处,随后把它标成可选,判断标准落在后端实现成本上。后端成本高的产品,比如涉及文档处理、搜索检索、模型调用的个人知识库,值得先做 demo 把界面和交互定下来;像电子书阅读器这种只导入 TXT、后端简单的,直接做产品再调整就行。
哪些段落可以跳过
整条视频节奏偏紧,从开场痛点直接进入流程,很少停在大段铺垫或重复上。想省时间的话,对 Codex 已经不陌生的人可以跳过开头对工具的演示和介绍,大致在视频一分钟左右的位置;MVP、前端、后端这类术语解释扫一眼即可,后面的操作讲解不看定义也能明白。其余部分是连续的操作说明,跳着看容易漏掉条件。
看完能拿到什么
- 一套可以照搬的五步流程:环境搭建、产品设计、技术设计、产品实现、人工验证,以及每一步该产出什么。
- AGENTS.md 里那两条硬规则的写法和作用,强制 commit、强制写测试并在交付前跑通。
- 判断要不要先做 demo 的标准,也就是看后端实现成本的高低。
- 给 AI 装自测能力的具体做法,以及在 Codex 上对应的两个插件。
- 三条不能省的原则,和「流程做多细取决于你想保留多少掌控力」这个取舍框架。
内容核验说明
把 AI 编程拆成环境搭建、产品设计、技术设计、实现、人工验证五步,每步都落在能照做的动作上:AGENTS.md 强制 commit 和写测试,按后端成本决定要不要先做 demo。适合已经在用 AI 写代码、但交付前还得自己当测试员的人。视频里的演示效果来自作者本人操作,能否复现取决于模型和项目,需自行判断。
文中的流程、插件建议与 demo 判断标准来自作者视频中的公开演示,诀.com 未独立验证;作者所述实现过程与报错修复属于个人经验,结果不保证复现。原始来源
原作者:马克的技术工作坊
本文对公开来源内容进行了结构化整理,原观点与内容归原作者所有。
查看原文