Codex 拿到前端启动模板后,我会先看这 6 个失败信号

AI 时代程序员必备技能

Codex、Claude Code、Cursor、Hermes Agent、OpenClaw等工程化实战专栏 ,讲透 AI 如何接管脏活累活

上一篇给了一份前端任务启动模板。它把任务身份、项目边界、Skill 选择、冲突处理和交付证据放到了代码修改之前。

模板写完,并不代表任务已经稳了。

我会先看 Codex 的启动回复。只要里面出现几个信号,我就会让它停下来重写。这个阶段叫停成本最低。等它已经改了三四个文件,再去追问为什么引入新依赖,事情就麻烦了。

第一个信号,任务类型含糊

我最不放心的一种回复,是 Codex 同时把任务归到三四类。

比如它说这次任务既是页面生成,又是逻辑开发,又是页面验收,还需要规则复盘。听起来全面,实际没有主目标。主目标不清,后面所有 Skill 都会有理由进来。

我会要求它重写成这样。

主类型
- 逻辑开发
​
后备类型
- 页面验收
​
暂不进入
- 页面生成
- bug 修复
- 规则复盘

主类型只能有一个。后备类型要写触发条件。暂不进入的类型也要写出来,免得 Codex 后面自己打开。

第二个信号,项目边界靠猜

如果 Codex 没读项目,就直接写“使用 React、Tailwind、Vitest”,我会立刻拦住。

公开 Skill 里的技术栈只代表它自己的使用场景。当前项目用什么,要从仓库里找。入口文件、包管理器、组件库、请求封装、测试命令,都要有来源。

靠谱的回复通常长这样。

已确认
- package.json 中存在 Vue 相关依赖
- 页面目录已有同类列表页
- 请求入口使用现有 service 封装
​
待确认
- 当前模块是否已有测试入口
- 当前页面是否能本地打开

“待确认”可以保留。没有读到就标出来,比猜一个强。

第三个信号,Skill 选择没有排除项

只写采用了什么,不写排除了什么,这种回复我一般不会让它继续。

GitHub Skill 的风险经常藏在排除项里。web-artifacts-builder 为什么不进已有 Vue 项目,systematic-debugging 为什么不进普通新增功能,TDD 为什么只管纯逻辑,这些都要写明。

我期待看到这样的内容。

主 Skill
- test-driven-development
​
后备 Skill
- webapp-testing
​
排除
- web-artifacts-builder,因为当前任务在已有项目内修改
- systematic-debugging,因为当前没有可复现 bug

排除项让任务变窄。前端开发很多时候就是靠变窄才稳。

第四个信号,冲突被轻描淡写

Codex 有时会写一句“无明显冲突”。这句话我会追问。

外部 Skill 进入已有项目,通常至少会有一两个需要确认的点。技术栈、依赖、目录、测试入口、浏览器环境,哪怕最后都没问题,也应该被扫过一遍。

我会让它补冲突表。

冲突检查
- 外部 Skill 是否要求新技术栈
- 外部 Skill 是否要求新增依赖
- 外部 Skill 示例是否改变项目目录
- 外部 Skill 是否要求当前项目不存在的测试入口
- 浏览器验收是否依赖登录态或内网接口

如果这几项没有任何证据,所谓“无冲突”就只是口头判断。

第五个信号,交付证据和 Skill 对不上

TDD 任务最后没有测试结果,调试任务最后没有根因,浏览器验收任务最后没有路径,这都算失败信号。

我会提前把证据写到启动阶段。

主 Skill缺什么就要叫停
test-driven-development没有失败测试或行为样例
systematic-debugging没有复现和假设验证
webapp-testing没有页面路径和未覆盖项
web-artifacts-builder没有运行方式和构建说明
规则复盘模板没有采用、排除和冲突记录

这张表不用等交付时再看。启动阶段就要让 Codex 认领证据。它不愿意认领,后面大概率会用一句“已完成”糊过去。

第六个信号,没有未覆盖项

我现在很警惕那种过于完整的回复。

真实前端任务很少一开始就什么都能验证。页面可能要登录,接口可能要测试账号,某些边界数据本地造不出来,移动端尺寸也未必当场覆盖。启动回复里完全没有未覆盖项,反而说明 Codex 没有认真区分可验证和待复核。

我会要求它至少回答三件事。

未覆盖项
- 哪些路径现在能自动验证
- 哪些路径只能人工复核
- 哪些路径需要补账号、数据或环境

这三件事写清楚以后,交付时就好验。能自动跑的看结果,人工复核的照路径点,需要环境的先不冒充已验证。

我会这样叫停

发现失败信号以后,我不会直接替 Codex 改答案。我会让它重跑启动模板。

先暂停代码修改。
​
你的启动回复存在问题
- 任务主类型不清
- 项目边界缺少证据
- Skill 选择没有排除项
- 冲突检查过于简单
- 交付证据和主 Skill 对不上
- 未覆盖项没有列出
​
请重新输出启动结果。只修正启动结果,不修改代码。

这段话看起来有点硬,但对前端任务很有用。启动阶段越硬,代码阶段越轻。

写在最后

前端任务启动模板真正有价值的地方,是让我能在改代码前看到风险。

任务类型含糊、项目边界靠猜、Skill 没有排除项、冲突被带过、证据对不上、未覆盖项为空,这 6 个信号一出现,我就会先叫停。

模板要承担改代码前的小验收。这个小验收过了,后面的 TDD、调试、浏览器路径和规则复盘才有地方落脚。

下一篇可以把这套启动模板拿回具体前端任务里,用“新增筛选项”或“分页错位”走一遍,看 Codex 的启动回复应该怎样改到可执行。

本系列持续更新,继续围绕 Codex 和 GitHub Skills,拆前端开发里那些容易被一句“交给 AI”带过去的细节。

AI 时代程序员必备技能

Codex、Claude Code、Cursor、Hermes Agent、OpenClaw等工程化实战专栏 ,讲透 AI 如何接管脏活累活

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

百变梦仔

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值