1. 为什么 Codex 启动回复合格前端改动还是不敢合并Codex 启动回复合格只说明它把任务边界、主 Skill、后备 Skill 和排除项讲清楚了。放到前端 TDD 场景里这顶多算“开工前对齐”离“可以合并”还差一段验收闭环。我见过太多类似情况启动回复里写着 TDD 做主 Skill、webapp-testing 做后备改完代码只回一句“已完成”测试怎么跑、页面路径怎么走、哪些 GitHub Skill 规则最后留下来全都没有交代。前端改动和纯后端改动不一样。后端接口改完跑一遍测试基本能判断行为对不对前端多了一层状态和交互输入框里的草稿值、已提交的查询条件、分页游标、重置动作任何一个环节错位页面看着能跑实际交互会变得很别扭。所以启动回复合格之后我会继续要求三类证据行为证据、测试日志、Git diff。这三类证据合在一起才能判断这次改动是否真的可审计、可合并。这篇聚焦 Codex 驱动前端 TDD 的验收闭环交付一份可复制的 TaoToken 统一 Key/API 配置骨架以及 webapp-testing Skill 的验证动作。适合正在用 Codex 做前端任务、但苦于“改完不知道对不对”的开发者。读完你可以在本地复现一套可审计的前端验收流程而不是只靠一句“已完成”拍脑袋。2. TaoToken 前置统一 Key 与 API 配置骨架在讲三类证据之前先把 TaoToken 的接入配置说清楚。Codex 要稳定跑前端 TDD模型调用这一层不能每次任务都换 Key、换地址。我习惯用 TaoToken 做统一入口官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 地址不加 UTM 参数。统一 Key 的好处很直接Codex 的 settings.json、config.toml、以及 webapp-testing Skill 里的模型调用全部指向同一个入口。这样验收时不会出现“测试环境用了一个 Key、页面验证用了另一个 Key”的混乱。下面给两份配置骨架一份给 Codex 的 settings.json一份给 config.toml你可以按自己的工具链选一份或两份都用。2.1 settings.json 配置骨架{ model_provider: taotoken, api_base: https://taotoken.net/api, api_key: sk-你的TaoToken统一Key, model: claude-sonnet-4-20250514, timeout_seconds: 120, max_retries: 2, skills: { primary: tdd, fallback: webapp-testing, excluded: [web-artifacts-builder, systematic-debugging] }, evidence_required: [behavior, page, rule] }这份骨架里api_base指向 TaoToken 的 API 地址api_key用你在控制台生成的统一 Key。skills字段把主 Skill 和后备 Skill 写死避免 Codex 每次任务重新选一遍。evidence_required是我自己加的字段用来提醒交付时必须带三类证据。2.2 config.toml 配置骨架[provider] name taotoken api_base https://taotoken.net/api api_key sk-你的TaoToken统一Key model claude-sonnet-4-20250514 timeout 120 retries 2 [skills] primary tdd fallback webapp-testing excluded [web-artifacts-builder, systematic-debugging] [evidence] required [behavior, page, rule] behavior_sample true page_path true rule_review true两份配置的核心字段一致区别只是格式。如果你用的是 Codex 的 coding-plan 模式建议把api_base和api_key放在环境变量里配置文件只引用变量名避免 Key 进 Git。TaoToken 的 API Keys 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 生成 Key 后直接填进配置即可。注意配置里的api_base必须是 https://taotoken.net/api 不要带 UTM 参数也不要拼成对话页地址。对话页是给模型对话用的API 地址是给程序调用的两者不要混。3. 可复制配置三类证据的交付要求配置好 TaoToken 之后下一步是把三类证据写进交付要求。启动回复通过后我会追加一段固定话术让 Codex 进入代码修改阶段时就知道交付标准。这段话术可以直接复制到你的任务描述里。启动回复已确认。现在可以进入代码修改。 交付时必须包含三类证据。 行为证据 - 若项目有测试入口提供最小测试及结果 - 若没有测试入口提供行为样例和对应代码位置 页面证据 - 提供查询、重置、翻页路径 - 标明自动验证或人工复核 - 标明未覆盖的账号、数据或环境 规则证据 - 列出采用的 GitHub Skill 规则 - 列出排除的 GitHub Skill 规则 - 说明哪些规则只留在本次任务记录这段话的作用是把启动模板的承诺带到交付阶段。Codex 如果只改代码、不交证据任务就没有结束。它如果交了证据但对不上主 Skill也要继续追问。比如主 Skill 是 TDD却没有行为样例后备 Skill 是 webapp-testing却没有页面路径。这些都说明前面的选择没有真正落地。3.1 行为证据草稿值与已提交条件要分开以“新增筛选项”为例核心不在界面上而在查询行为上。我会让 Codex 先拿 TDD 的思路交行为证据。项目有测试入口就写最小测试项目暂时没有测试入口就先交行为样例和对应代码位置不能为了这一个任务新装测试框架。行为证据清单如下输入筛选值后点击查询请求参数包含该值查询动作会让分页回到第一页点击重置后请求参数移除该值查询后翻页仍使用已提交筛选条件输入但未查询时翻页不使用草稿值这里有一个细节草稿值和已提交条件要分开。用户在输入框里打了字还没点查询此时翻页到底用不用这个新值多数后台列表会继续使用上一次已提交条件。Codex 如果把输入框值直接绑到请求参数里页面看着能跑交互会变得很别扭。这就是行为证据的价值它逼 Codex 先讲状态关系再讲代码实现。3.2 页面证据webapp-testing 的验证动作行为证据过了还要看页面。webapp-testing 在这里负责收尾。它不一定每次都要写完整自动化脚本。页面能本地打开、登录态可用、数据可控时可以走浏览器脚本条件不齐就写人工路径和未覆盖项。页面证据清单如下打开列表页确认新增筛选项显示在正确位置输入筛选值点击查询检查列表请求或页面结果是否使用该条件点击重置确认输入框清空重置后列表回到默认查询状态查询后翻页确认条件没有丢记录无法验证的账号、接口或数据条件这类证据不能只写“页面正常”。正常两个字太松。我更愿意看到具体路径点了什么输入了什么页面或请求发生了什么哪一步没法在当前环境确认。哪怕只是人工路径也比一句正常可靠。3.3 规则证据GitHub Skill 的去处任务结束以后我会让 Codex 回到 GitHub Skill 规则本身。新增筛选项这次借了 TDD 和 webapp-testing排除了 web-artifacts-builder 和 systematic-debugging。最后要记录哪些规则值得下次继续用。规则证据清单如下本次采用 TDD 的哪几条行为要求本次采用 webapp-testing 的哪些页面路径哪些 GitHub Skill 被排除排除原因是否仍然成立哪些规则只适合本次任务哪些规则可以下次继续用我不会把“新增筛选项要写这些行为样例”立刻塞进项目长期规则。它更适合先留在任务记录里。等同类任务再出现几次仍然稳定有效再考虑写成项目规则。规则进长期文档要克制写多了Codex 每次读任务都会背负一堆局部经验。4. 验证请求与成功结果三类证据怎么收配置和交付要求都就位后接下来是实际验证。我习惯分三步收证据先跑行为测试再看页面路径最后对 Git diff。4.1 行为测试与测试日志如果项目有测试入口让 Codex 跑最小测试并贴出日志。以 Jest 为例命令和输出大概是这样npx jest src/features/filter/__tests__/filter.spec.ts --verbosePASS src/features/filter/__tests__/filter.spec.ts 新增筛选项 ✓ 输入筛选值后点击查询请求参数包含该值 (12 ms) ✓ 查询动作会让分页回到第一页 (8 ms) ✓ 点击重置后请求参数移除该值 (6 ms) ✓ 查询后翻页仍使用已提交筛选条件 (10 ms) ✓ 输入但未查询时翻页不使用草稿值 (7 ms) Test Suites: 1 passed, 1 total Tests: 5 passed, 5 total Time: 2.341 s这份日志就是行为证据的硬凭证。如果项目没有测试入口就让 Codex 交行为样例和对应代码位置比如src/features/filter/useFilterQuery.ts第 42 行到第 68 行说明草稿值和已提交条件分别存在哪个 state 里。4.2 页面路径与截图页面证据我一般让 Codex 走 webapp-testing 的浏览器脚本或者给人工路径。浏览器脚本用 Playwright 的话大概是这样const { test, expect } require(playwright/test); test(新增筛选项查询与重置, async ({ page }) { await page.goto(http://localhost:3000/list); await page.fill([data-testidfilter-input], alpha); await page.click([data-testidfilter-submit]); await expect(page).toHaveURL(/page1/); await expect(page.locator([data-testidfilter-input])).toHaveValue(alpha); await page.click([data-testidfilter-reset]); await expect(page.locator([data-testidfilter-input])).toHaveValue(); });跑完之后截图和日志一起贴进任务记录。截图要能看到筛选框、查询按钮、列表结果和分页控件。如果登录态不可用就写人工路径标明哪一步没法在当前环境确认。4.3 Git diff 与规则证据最后一步是看 Git diff。我让 Codex 贴出改动文件列表和关键 diff确认没有引入新依赖、没有改公共封装、没有塞测试专用逻辑。git diff --stat git diff src/features/filter/useFilterQuery.tssrc/features/filter/useFilterQuery.ts | 28 ----- src/features/filter/FilterBar.tsx | 12 ---- src/features/filter/__tests__/filter.spec.ts | 45 3 files changed, 78 insertions(), 7 deletions(-)diff 里如果出现package.json新增依赖或者公共组件被大改就要追问原因。规则证据则跟着 diff 一起交本次采用 TDD 的哪几条行为要求采用 webapp-testing 的哪些页面路径排除了哪些 GitHub Skill排除原因是否仍然成立。5. 本篇常见错排查实际跑下来最容易出问题的地方集中在配置、Skill 选择和证据降级三块。下面按现象、原因、处理方式列出来。5.1 配置类报错现象可能原因处理方式401 Unauthorizedapi_key 填错或过期到 API Keys 页重新生成填进 settings.json404 Not Foundapi_base 拼成了对话页地址改成 https://taotoken.net/api超时无响应timeout 太短或网络抖动把 timeout_seconds 调到 120max_retries 设 2模型名不识别model 字段写了不存在的版本用配置骨架里的默认模型名或到文档页核对配置类问题基本都能通过核对 api_base 和 api_key 解决。如果你不确定当前 Key 是否可用可以先用模型对话页发一条测试消息确认 Key 有效后再填进配置文件。5.2 Skill 选择类问题主 Skill 是 TDD却没有行为样例后备 Skill 是 webapp-testing却没有页面路径。这两种情况说明前面的选择没有真正落地。处理方式是回到交付要求让 Codex 补齐对应证据。如果它说“项目没有测试入口”就让它交行为样例和代码位置而不是直接跳过行为证据。还有一种情况是 Codex 擅自引入新依赖来造证据。比如为了跑一个测试装了新的测试框架或者为了页面验证改了公共封装。这种要直接拒绝证据应该服务任务不能反过来改造项目。5.3 证据降级与边界我允许降级但降级要写清楚。测试入口找不到可以把 TDD 降级为行为样例页面依赖登录态可以把浏览器脚本降级为人工路径接口没有可控数据可以把结果验证降级为请求参数检查和待复核项。降级要把当前环境做不到的事说清楚。我不接受两种情况一种是没有证据还说已经验收另一种是为了制造证据引入新依赖、改公共封装或塞测试专用逻辑。前者是自欺后者是给项目埋雷。提示如果你在排障时发现是接入层的问题优先看 API Keys 和接入文档如果是模型行为不符合预期去模型对话页复现如果是长期编码任务考虑用 Coding Plan 统一管理。6. 把三类证据固定成你的验收习惯Codex 的启动回复合格以后任务还没有完成。前端改动需要三类证据往回收行为证据管状态和参数页面证据管真实路径规则证据管 GitHub Skill 的去处。三类证据合在一起才能判断这次新增筛选项是否真的可合并。我自己的做法是把这套流程固定下来每次 Codex 任务启动回复通过后先贴 TaoToken 配置骨架再贴三类证据交付要求最后按行为测试、页面路径、Git diff 的顺序收证据。跑顺了之后验收时间反而比“改完再看”更短因为问题在交付阶段就暴露了。下一篇可以换一个方向用“分页错位”来跑同一套模板。新增功能看状态bug 修复看根因两种任务的主 Skill 会变证据结构也会跟着变。如果你想把模型对话、Coding Plan 和 API Keys 统一管起来可以从 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 生成统一 Key再回到 https://taotoken.net/api 接入你的 Codex 工作流。