上一篇给了一份前端任务启动模板。它把任务身份、项目边界、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”带过去的细节。

360

被折叠的 条评论
为什么被折叠?



