第 55 卷
第四篇:标准工作流
从需求到交付的完整链路
很多人刚开始用 Codex,会直接一句话丢给它:
帮我做一个网站。帮我改这个功能。帮我优化这个项目。
这样不是不行,但很容易出现一个问题: AI 改得很快,但你不知道它到底改了什么,也不知道能不能放心交付。
所以真正稳定的方式,不是让 Codex 一口气乱改,而是按照一套固定工作流来推进。
你可以把它理解成:
需求不是直接变成交付物,中间必须经过“理解、计划、修改、验证、检查、验收”这几步。
标准六步法
| 步骤 | 名称 | 简单来说 | 目的 |
|---|---|---|---|
| 1 | 需求拆解 | 先让 Codex 知道要做的项目是什么 | 避免不了解结构就乱改 |
| 2 | 制定计划 | 先列出要做什么,确认后再动手 | 避免一步改太多、方向跑偏 |
| 3 | 小步实现 | 一次只改一小块 | 降低出错概率,方便回滚 |
| 4 | 测试 | 改完后运行检查并手动验证 | 确认代码没有明显报错 |
| 5 | 代码审查 | 看 diff,检查改得对不对、有没有风险 | 防止 AI 改到不该改的地方 |
| 6 | 提交与复盘 | 提交代码并沉淀经验 | AI 负责执行,人负责拍板 |
第一步:需求拆解
在让 Codex 修改项目之前,第一件事不是写代码,而是先拆需求。
很多人用 Codex 容易翻车,不是因为 Codex 不会写代码,而是因为一开始需求没说清楚。
比如你只说:
帮我优化首页。
Codex 可能会理解成:
改 UI
改文案
甚至顺手删掉一些它觉得“没用”的代码
所以在正式动手前,应该先把需求拆成几个关键问题。
背景是什么
先说明这个任务为什么要做。
问题示例
| 现在项目处于什么阶段 | 这是一个已经上线的官网页面 |
|---|---|
| 当前遇到什么情况 | 首页转化率低,用户不知道产品卖点 |
| 为什么现在要改 | 准备发布新版,需要优化首屏表达 |
| 这个需求属于什么类型 | UI 优化 / Bug 修复 / 新功能 / 重构 |
要解决什么问题
需求要尽量具体,不要只写“优化”“美化”“改好一点”。
模糊说法更清楚的说法
| 优化首页 | 优化首页首屏标题、副标题和 CTA 按钮 |
|---|---|
| 页面不好看 | 调整卡片间距、字体层级和按钮样式 |
| 登录有问题 | 修复点击登录按钮后没有跳转的问题 |
| 做一个后台 | 新增用户列表页,包含搜索、筛选和分页 |
好的需求应该能回答:
这次到底要解决哪一个具体问题?
示例:
这次主要解决三个问题:
- 首屏标题表达不清楚
- CTA 按钮不明显
- 移动端首屏内容太拥挤
哪些文件可能相关
如果你知道大概文件位置,最好提前告诉 Codex。
这样可以减少它全项目乱找、乱改的概率。
| 改首页 | app/page.tsx、pages/index.tsx、components/Hero.tsx |
|---|---|
| 改样式 | globals.css、tailwind.config.js、相关组件文件 |
| 改登录 | login/page.tsx、auth.ts、middleware.ts |
| 改接口 | api 目录、server 目录、lib 目录 |
| 改文案 | 页面组件、配置文件、i18n 文件 |
哪些功能不能动
这一点非常重要。
Codex 很容易为了完成当前任务,顺手改掉其他地方。
所以要提前告诉它:
不能动的内容说明
| 登录逻辑 | 只改 UI,不改认证流程 |
|---|---|
| 接口地址 | 不要改 API 请求路径 |
| 数据结构 | 不要改数据库字段 |
| 路由结构 | 不要改已有页面路径 |
| 已有组件 | 除非必要,不要大规模重构 |
| 依赖版本 | 不要随便升级或新增依赖 |
这一步的核心是给 Codex 画边界。
什么结果算完成
不要只说“做完就行”,要告诉 Codex 什么叫完成。
需求类型完成标准
UI 优化页面视觉明显改善,移动端不乱
| Bug 修复 | 原来的报错消失,相关功能可正常使用 |
|---|---|
| 新功能 | 用户能完整走通操作流程 |
| 性能优化 | 构建正常,页面加载没有明显变慢 |
| 文案优化 | 标题、副标题、按钮文案更清楚 |
全站分卷索引 · 72 卷
- 1第 1 卷
- 2第 2 卷
- 3第 3 卷
- 4第 4 卷
- 5第 5 卷
- 6第 6 卷
- 7第 7 卷
- 8第 8 卷
- 9第 9 卷
- 10第 10 卷
- 11第 11 卷
- 12第 12 卷
- 13第 13 卷
- 14第 14 卷
- 15第 15 卷
- 16第 16 卷
- 17第 17 卷
- 18第 18 卷
- 19第 19 卷
- 20第 20 卷
- 21第 21 卷
- 22第 22 卷
- 23第 23 卷
- 24第 24 卷
- 25第 25 卷
- 26第 26 卷
- 27第 27 卷
- 28第 28 卷
- 29第 29 卷
- 30第 30 卷
- 31第 31 卷
- 32第 32 卷
- 33第 33 卷
- 34第 34 卷
- 35第 35 卷
- 36第 36 卷
- 37第 37 卷
- 38第 38 卷
- 39第 39 卷
- 40第 40 卷
- 41第 41 卷
- 42第 42 卷
- 43第 43 卷
- 44第 44 卷
- 45第 45 卷
- 46第 46 卷
- 47第 47 卷
- 48第 48 卷
- 49第 49 卷
- 50第 50 卷
- 51第 51 卷
- 52第 52 卷
- 53第 53 卷
- 54第 54 卷
- 55第 55 卷
- 56第 56 卷
- 57第 57 卷
- 58第 58 卷
- 59第 59 卷
- 60第 60 卷
- 61第 61 卷
- 62第 62 卷
- 63第 63 卷
- 64第 64 卷
- 65第 65 卷
- 66第 66 卷
- 67第 67 卷
- 68第 68 卷
- 69第 69 卷
- 70第 70 卷
- 71第 71 卷
- 72第 72 卷