我不再让 Codex 一口气改完整个页面:前端需求这样拆,才真正可验收
上一篇解决的是“信息怎么分层”这篇继续往下走需求已经讲清楚之后怎样把它拆成 Codex 可以逐步完成、我也能逐步验收的小任务很多人听到“拆任务”第一反应是按文件拆先改页面文件。再改接口文件。然后改类型定义。最后补样式。这种拆法对安排修改顺序有帮助但它有一个明显问题每一步都只是完成了某个文件不能证明某个用户行为已经可以工作。页面文件改完了查询不一定能用接口文件改完了参数不一定正确样式写完了窄屏下也不一定真的能操作。我现在更倾向于按“可观察的行为变化”拆任务。每完成一小块都能回答三个问题用户得到了什么新能力我用什么方式验证如果出错影响范围在哪里先明确小任务不是把大任务切碎成代码清单一个合格的小任务至少应该具备四个特征只有一个主要结果完成后能用一句话描述变化。有清楚的输入和边界知道会影响哪些行为不会影响哪些行为。能够独立验证不必等整页全部改完当前结果就能检查。失败容易回退方向不对时不需要从一堆混合改动中找问题。所以“修改UserList.vue”不是一个结果“状态筛选条件能够正确进入列表请求并在重置后恢复默认值”才是。前者描述代码位置后者描述业务行为。用一个后台列表需求演示怎样拆下面仍然是一个演示场景不代表我的真实项目在现有订单列表中增加订单状态和下单时间筛选完善重置行为增加导出入口同时不能破坏现有分页和权限逻辑。如果把它整个交给 AI它可能一次修改页面、接口、类型和样式。最后我们面对的是一大块差异筛选、分页、导出和权限只要有一项不对就要在所有改动里找原因。我会先把它拆成下面几个阶段。任务 0只理解现状不改代码目标画出当前列表的数据流找到查询条件、分页、权限和接口分别由哪里负责。要求 Codex 输出相关文件和各自职责。从点击查询到数据渲染的调用路径。重置和翻页时状态如何变化。导出能力是否已有相近实现。最容易被本次修改影响的位置。验收方式我能根据这份说明指出“筛选条件应该在哪里增加”“分页状态由谁维护”“权限逻辑不能在哪里绕开”。这一阶段很容易被嫌慢但如果连现状都没看清后面的拆分只是在猜。Codex 官方给出的代码库理解用例也强调修改前应先梳理模块职责、数据流、校验位置、隐藏依赖和需要执行的检查。对我来说这不是额外步骤而是后续任务边界的来源。任务 1只建立筛选状态不连接请求目标页面能够正确维护订单状态和时间范围并按照项目现有方式完成展示、清空和默认值处理。暂时不做不改接口参数。不实现导出。不调整分页。验收方式打开页面、修改筛选项、点击重置观察页面状态是否符合约定类型检查没有新增错误。有人可能觉得这一步太小但它把“表单状态问题”和“请求参数问题”分开了。后面如果查询不对我可以先确认页面状态是否正确不用同时怀疑所有环节。任务 2把筛选条件接入查询闭环目标点击查询后筛选条件按照接口约定转换为请求参数查询行为与现有分页规则保持一致。需要明确点击查询是否回到第一页。空条件是否发送。时间范围如何转换。请求失败后筛选条件是否保留。验收方式检查请求参数并分别验证有条件查询、空条件查询和请求失败三条路径。完成这一步时用户已经真正获得了一个可使用的新能力。即使导出还没做筛选功能也可以独立判断对错。任务 3单独修正重置与分页状态目标重置筛选、切换页码、修改每页数量时页面状态与请求参数保持一致。这部分看起来属于任务 2但我通常会在状态比较复杂时单独拆出来。因为查询能用不代表连续操作一定正确。验收路径可以写成设置筛选条件并查询。切换到第二页。点击重置。确认筛选条件清空、页码回到第一页、请求参数恢复默认。再次改变每页数量确认页码和列表数据同步更新。前端页面很多问题只有按顺序操作才会出现。把验收路径写出来比一句“保证分页正常”可靠得多。任务 4把导出当成独立业务流程目标在保留现有权限判断的前提下使用当前筛选条件发起导出并正确处理等待、成功和失败状态。为什么导出不应该顺手塞进查询任务因为它通常有不同的请求方式、等待时间、返回结果和错误处理。有些项目是直接下载文件有些项目会先创建任务再轮询结果。在没有看清现有实现之前AI 很容易按照自己熟悉的方式补一个下载逻辑。验收方式至少包括有权限时显示入口无权限时行为符合项目约定。导出参数与当前筛选条件一致。导出期间不能重复触发。成功、失败或取消后按钮状态能够恢复。任务 5最后做联合回归不再新增功能目标把筛选、重置、分页、权限和导出连起来验证清理无关改动。这一阶段不应该继续“顺手优化”。它只做三件事查看完整代码差异确认没有越界修改。运行项目已有的检查。按用户操作路径做页面回归。如果此时发现新的重构机会我会记录成后续任务而不是继续扩大当前差异。好的拆分顺序应该让风险逐步暴露上面的拆分不是唯一答案但顺序有一个基本逻辑理解现状 → 建立局部状态 → 接入单一行为 → 补齐连续状态 → 增加独立流程 → 联合回归每一步都以前一步的已验证结果为基础。如果任务 1 的筛选状态就不对不需要等导出做完再返工如果任务 2 的请求参数不对也不会把问题误判成分页组件故障。这就是小步修改真正节省时间的地方不是每一步写得更快而是错误更早出现、更容易定位。我不会按文件拆而会按“行为切片”拆可以用下面这张表快速区分不够有效的拆法更容易验收的拆法修改页面文件筛选状态能够正确设置和重置修改接口文件查询参数与页面条件一致修改分页组件查询、翻页和重置时页码规则一致增加导出方法导出完整覆盖等待、成功和失败路径调整样式在约定宽度下按钮可见、内容不遮挡文件仍然要列但它应该是影响范围不应该是任务目标。每个小任务都要带一张“验收卡”我会要求每个任务至少写清下面六项## 小任务目标 ​ - 本次只产生什么行为变化 ​ ## 前置条件 ​ - 已确认的项目现状 - 依赖哪个已完成任务 ​ ## 修改范围 ​ - 允许修改 - 禁止修改 ​ ## 本次不做 ​ - 明确排除的功能和优化 ​ ## 验收步骤 ​ 1. 2. 3. ​ ## 完成证据 ​ - 修改文件及原因 - 已运行的检查 - 页面验证结果 - 未验证项和剩余风险“完成证据”很重要。它能把“我认为写完了”变成“这些检查已经通过那些部分仍然未知”。拆到多小才合适看验证成本不看代码行数任务不是越小越好。如果一个改动只有三行却必须等另一个改动完成后才能观察结果硬拆成两个任务只会增加沟通成本。反过来一个改动即使涉及多个文件只要共同完成同一个行为而且能一次独立验收也可以保留在一个任务里。我通常用下面几个信号判断是否还要继续拆同一个任务里出现两个以上彼此独立的用户结果。不同部分需要不同的验证方式。某一部分失败时其他部分仍然可以成立。任务同时包含功能新增和大范围重构。无法用三到五步描述完整验收路径。满足其中两三项我就会认真考虑继续拆分。最后保留一个“停下来”的节点我现在不喜欢让 AI 拿到计划后无条件一路执行到底。在影响范围不清、现有实现与需求冲突、需要修改公共能力或无法运行关键检查时应该停下来报告而不是自行扩大假设。这个暂停点不是降低效率。真正拖慢开发的往往不是多确认一次而是 AI 已经沿着错误方向改完十几个文件我们才开始追第一处判断是怎么错的。到这里Day 2 的两篇文章就形成了一个完整链条上一篇把长需求的信息分层这一篇再把主任务拆成可验收的行为切片。下一篇会进入 Day 3提示词为什么不是越复杂越好。我要继续拆开“提示词”和“项目上下文”这两个经常被混用的概念并给出前端任务真正值得提供的上下文清单。本系列持续更新。后面会把这些方法逐步应用到 Vue3 列表、Element Plus 表单、页面调试和真实验收流程里。参考资料Codex 官方用例修改前先理解代码库、数据流与风险点Codex 官方用例通过可评估结果持续迭代复杂任务

相关新闻

Cortex-M内核全解析:从M0到M33的选型指南与开发实战

Cortex-M内核全解析:从M0到M33的选型指南与开发实战

1. 从选型困惑到架构认知:为什么需要理清Cortex-M家族 如果你刚开始接触嵌入式开发,或者正准备为一个新项目选择一款微控制器,面对琳琅满目的STM32、GD32、NXP LPC、华大HC等系列,以及它们背后标注的Cortex-M0、M3、M4、M7等内核型…

2026/7/31 7:38:45阅读更多 →
从0到1:第一篇博客and第一次沉浸式写代码

从0到1:第一篇博客and第一次沉浸式写代码

做C语言课程设计,选了最经典的扫雷项目。 本来以为逻辑很简单:两个棋盘、布雷、计算周围雷数、判断输赢,结果从中午写到下午,跟bug死磕了大约2个小时。最离谱的是:我明明设置了80个雷用来检验程序,运行出来…

2026/7/31 7:38:45阅读更多 →
【AI微服务开发革命】:20年架构师亲测的5大落地陷阱与避坑指南

【AI微服务开发革命】:20年架构师亲测的5大落地陷阱与避坑指南

更多请点击: https://intelliparadigm.com 第一章:AI微服务开发革命的范式跃迁 传统单体AI应用正被解耦为可独立部署、弹性伸缩、语义自治的微服务单元,这一转变不仅是架构演进,更是开发范式的根本性跃迁——从模型即服务&#x…

2026/7/31 7:38:45阅读更多 →
飞书文档批量导出工具:25分钟搞定700+文档备份

飞书文档批量导出工具:25分钟搞定700+文档备份

飞书文档批量导出工具:25分钟搞定700文档备份 【免费下载链接】feishu-doc-export 飞书文档导出服务 项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export 还在为手动下载飞书文档而烦恼吗?飞书文档批量导出工具让您彻底告别繁琐的手…

2026/7/31 8:53:02阅读更多 →
Tavily AI搜索API测评:技术调研与自动化文档检索实战

Tavily AI搜索API测评:技术调研与自动化文档检索实战

在技术调研和代码分析过程中,我们常常需要快速获取准确的技术文档、API说明或开源项目信息。传统方式要么依赖通用搜索引擎手动筛选,要么需要调用多个API进行数据整合,效率较低。近期,一个名为Tavily的AI搜索工具逐渐进入开发者视…

2026/7/31 8:53:02阅读更多 →
AI外呼系统从原理到实践:开源部署与合规落地指南

AI外呼系统从原理到实践:开源部署与合规落地指南

1. 先搞清楚 AI 外呼到底在解决什么问题 AI 外呼的核心是替代传统人工电话营销中的重复性初筛环节。它不是一个能完全模拟人类深度交流的系统,而是针对标准业务场景(例如课程续费提醒、服务满意度回访、活动通知)进行批量触达的工具。如果你接…

2026/7/31 8:53:02阅读更多 →
电商OLAP技术解析:从原理到精准营销实战

电商OLAP技术解析:从原理到精准营销实战

1. 电商精准营销背后的OLAP技术支撑 电商行业每天产生的用户行为数据、交易记录、商品信息等数据量级早已突破传统数据库的处理极限。某头部电商平台2023年数据显示,其单日产生的用户点击流数据就超过5TB,而传统基于行存储的关系型数据库在这种场景下进行…

2026/7/31 8:53:02阅读更多 →
嵌入式通信协议深度解析:从UART、SPI、I2C到CAN的实战选型指南

嵌入式通信协议深度解析:从UART、SPI、I2C到CAN的实战选型指南

1. 从“八股文”到实战:嵌入式通信协议的本质是什么? 每次面试,当面试官抛出“聊聊UART、SPI、I2C、CAN的区别”这个问题时,很多朋友的第一反应就是去背那些标准答案:全双工、半双工、同步、异步、几根线、速度多少。这…

2026/7/31 8:53:02阅读更多 →
C#操作Windows环境变量:从原理到实战的完整指南

C#操作Windows环境变量:从原理到实战的完整指南

1. 项目概述:为什么要在C#中操作Windows环境变量? 在Windows平台上进行C#开发,尤其是开发桌面应用、安装程序、系统工具或者需要与操作系统深度集成的服务时,操作环境变量是一个绕不开的课题。你可能遇到过这样的场景:…

2026/7/31 8:51:01阅读更多 →
覆盖国产 + 海外 + 开源模型,OpenClaw 2.7.9 Windows/Mac 双端部署详解

覆盖国产 + 海外 + 开源模型,OpenClaw 2.7.9 Windows/Mac 双端部署详解

🔹 工具基础介绍 OpenClaw 是开源生态中一款实用性较强的本地智能工具,凭借本地离线运行、可视化图形操作和任务自动化三大核心特性,赢得了众多用户的青睐。与普通在线对话AI工具不同,它属于能够直接操控本机软硬件的智能数字员工…

2026/7/30 15:03:16阅读更多 →
伺服阀焊完微漏毁整机?精密激光焊接三关锁住高压

伺服阀焊完微漏毁整机?精密激光焊接三关锁住高压

所谓液压伺服阀体的精密激光焊接,是用激光束对阀座壳体(通常为不锈钢或铝合金)进行密封焊接,使阀体在21-35MPa的高压液压油或压缩气体中长期运行而不发生介质泄漏。液压伺服阀是高端液压系统的"大脑"。从航空航天飞行控…

2026/7/30 12:22:27阅读更多 →
D2DX:三步实现《暗黑破坏神2》高清宽屏体验的终极指南

D2DX:三步实现《暗黑破坏神2》高清宽屏体验的终极指南

D2DX:三步实现《暗黑破坏神2》高清宽屏体验的终极指南 【免费下载链接】d2dx D2DX is a complete solution to make Diablo II run well on modern PCs, with high fps and better resolutions. 项目地址: https://gitcode.com/gh_mirrors/d2/d2dx 你是否还在…

2026/7/30 15:13:02阅读更多 →
物理复制比逻辑复制好在哪?数据库复制原理详解

物理复制比逻辑复制好在哪?数据库复制原理详解

数据库复制是把主库数据同步到备库的机制,分为逻辑复制和物理复制两种。逻辑复制传输的是 SQL 语句或行变更事件,物理复制传输的是存储引擎底层的物理日志。阿里云 PolarDB(云原生数据库)采用物理复制,在同步延迟、数据…

2026/7/31 0:00:40阅读更多 →
BilibiliDown:3分钟学会B站视频下载的终极指南

BilibiliDown:3分钟学会B站视频下载的终极指南

BilibiliDown:3分钟学会B站视频下载的终极指南 【免费下载链接】BilibiliDown (GUI-多平台支持) B站 哔哩哔哩 视频下载器。支持稍后再看、收藏夹、UP主视频批量下载|Bilibili Video Downloader 😳 项目地址: https://gitcode.com/gh_mirrors/bi/Bilib…

2026/7/31 0:00:41阅读更多 →
有哪些游戏数据AI平台?游戏行业Data+AI融合方案盘点

有哪些游戏数据AI平台?游戏行业Data+AI融合方案盘点

当前,游戏行业的“DataAI融合”已从概念验证进入价值落地阶段。根据IDC 2025年数据,中国AI游戏云市场规模已达18.6亿元;同时,游戏研发环节AI渗透率高达86%,生成式AI内容普及率超过50%。面对庞大的市场,游戏…

2026/7/31 0:00:41阅读更多 →
YOLOv8推理性能优化:从1.2FPS到35FPS的全链路加速实践

YOLOv8推理性能优化:从1.2FPS到35FPS的全链路加速实践

如果你在部署 YOLOv8 时,发现推理速度只有可怜的 1-2 FPS,而别人的演示视频却能跑到 30 FPS 以上,那么问题很可能不在模型本身,而在于你的整个处理链路。很多开发者拿到一个训练好的 YOLOv8 模型后,会直接使用官方示例…

2026/7/31 0:49:33阅读更多 →
Coze与Dify对比指南:低代码AI应用开发从入门到实战

Coze与Dify对比指南:低代码AI应用开发从入门到实战

1. 从零到一:为什么你需要了解 Coze 和 Dify?如果你对 AI 应用开发感兴趣,但一看到“大模型”、“智能体”、“工作流”这些词就头疼,觉得门槛太高,那这篇文章就是为你准备的。很多开发者,包括我自己&#…

2026/7/31 5:08:18阅读更多 →
AI生图工具怎么选?2026年6月版实测对比

AI生图工具怎么选?2026年6月版实测对比

做自媒体的朋友应该都有体会:配图一直是个让人头疼的问题。2026年,AI生图工具已经非常成熟了,但工具太多反而不知道怎么选。以下是截至2026年6月我对主流AI生图工具的实测对比。Midjourney V8.1:速度之王2026年6月11日&#xff0c…

2026/7/30 15:43:46阅读更多 →