别让Codex从空白开始写页面：用GitHub skill立工程骨架，配TaoToken统一Key通道

1. 为什么 Codex 写前端总从空白页开始你让 Codex 写一个登录页它不会先问你项目用什么技术栈而是直接开写。第一行import React from react第二行开始堆useState样式随手写几个 Tailwind 类名路径别名没配就用相对路径../../components/Button。页面能跑但交付出去之后你会发现这个页面和项目里其他页面完全不像一个团队写的。我试过让 Codex 连续生成三个页面结果三个页面的目录结构、状态管理方式、组件拆分粒度全都不一样。第一个页面把表单逻辑写在组件里第二个抽了个useFormhook第三个直接用了受控组件加onChange回调。这不是 Codex 能力问题是它每次都在从零做决策——技术栈选什么、组件库用不用、别名怎么配、目录怎么分这些决策每次重新做一遍结果必然发散。前端项目冷启动的核心矛盾就在这里Codex 擅长写业务逻辑但不擅长替你做工程决策。你让它写一个页面它会写你让它在一个已有骨架里写页面它写得又快又稳。所以正确的做法不是让 Codex 从空白开始而是先给它一个工程骨架让它在这个骨架里填业务代码。GitHub 上有一类叫 skill 的东西正好解决这个问题。skill 不是插件不是依赖包它是一份带脚本和规则的目录告诉 Codex「这个项目长什么样、用什么技术栈、按什么流程走」。你把这个目录放进项目Codex 读完之后就会按骨架来写而不是每次重新发明轮子。这篇要交付的就是一套可复制的 skill 目录结构、一份config.toml骨架以及用 TaoToken 统一 Key 通道的配置方式。目标很明确让 Codex 基于工程骨架生成页面而不是从空白开始。适合正在用 Codex 做前端、但被「每次生成风格不一致」困扰的人。2. TaoToken 前置统一 Key 通道解决什么问题在讲 skill 目录之前先说 Key 通道的事。因为 skill 里会配 Codex 的调用参数而 Codex 每次请求都要走一个 API 端点。如果你用多个模型、多个项目、多个环境Key 管理会变成一件很烦的事。TaoToken 在这里的角色是统一入口。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 。你在这个平台上拿一个 Key就可以在 Codex 的配置里统一指向这个端点不用每个项目单独配一套。具体来说TaoToken 解决三个问题。第一Key 统一。你不需要在.env、config.toml、CI 变量里各放一份不同的 Key一个 Key 走所有环境。第二端点统一。Codex 的base_url指向https://taotoken.net/api模型名按平台支持的填切换模型不用改代码。第三额度可控。你在控制台能看到每个 Key 的用量方便排查是哪个项目在烧额度。拿 Key 的路径是进控制台创建 API Key复制出来。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite API Keys 管理页是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。这两个页面你收藏一下后面配config.toml的时候要用。注意Key 不要写进 skill 目录里提交到 Git。skill 目录是给 Codex 读的规则和脚本Key 应该放在环境变量或本地配置文件里用.gitignore排除。如果你还没决定用哪个模型可以先在模型对话页试一下 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 确认端点通不通、模型响应正不正常再写进 Codex 配置。长期做编码和 Agent 任务的话Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 里有套餐说明按自己的调用量选。3. 可复制的 skill 目录结构与 config.toml 骨架现在进入正题。skill 的本质是一个目录里面放三类东西规则文件告诉 Codex 怎么做、脚本替 Codex 做初始化、配置告诉 Codex 走哪个端点。下面这套结构你可以直接复制。web-skeleton-skill/ ├── SKILL.md ├── config.toml ├── scripts/ │ ├── init-project.sh │ └── verify-skeleton.sh └── templates/ ├── vite.config.ts ├── tailwind.config.js └── tsconfig.jsonSKILL.md是入口Codex 读的第一个文件。它不需要很长但要把技术栈、目录约定、执行流程写清楚。下面是一份可用的骨架# Web Skeleton Skill ## 技术栈 - React 18 TypeScript - Vite 5 构建 - Tailwind CSS 3.4 - shadcn/ui 组件库 - 路径别名 / 指向 src/ ## 执行流程 1. 运行 scripts/init-project.sh 项目名 生成骨架 2. 在 src/pages/ 下新建页面文件 3. 组件放 src/components/工具函数放 src/lib/ 4. 不要新建第二套技术栈或组件体系 5. 完成后运行 scripts/verify-skeleton.sh 自检 ## 设计约束 - 避免过度居中布局、紫色渐变、清一色圆角 - 字体和圆角不要全靠一个模板 - 配色至少有两种以上层次config.toml是 Codex 的调用配置重点是base_url和api_key两项# config.toml - Codex 调用配置骨架 [model] provider openai-compatible base_url https://taotoken.net/api api_key ${TAOTOKEN_API_KEY} model gpt-4o [project] name web-skeleton root . skill_dir ./web-skeleton-skill [generation] temperature 0.3 max_tokens 8192这里api_key用环境变量引用不写死。你在终端里export TAOTOKEN_API_KEY你的KeyCodex 启动时自动读取。base_url指向 TaoToken 的 API 端点所有请求走这一个通道。scripts/init-project.sh是初始化脚本负责把templates/里的配置文件复制到新项目并安装依赖#!/usr/bin/env bash set -euo pipefail PROJECT_NAME${1:?请传入项目名} TARGET_DIR./${PROJECT_NAME} if [ -d $TARGET_DIR ]; then echo 目录已存在: $TARGET_DIR exit 1 fi mkdir -p $TARGET_DIR/src/pages $TARGET_DIR/src/components $TARGET_DIR/src/lib cp templates/vite.config.ts $TARGET_DIR/ cp templates/tailwind.config.js $TARGET_DIR/ cp templates/tsconfig.json $TARGET_DIR/ cd $TARGET_DIR npm create vitelatest . -- --template react-ts --force npm install npm install -D tailwindcss3.4 postcss autoprefixer npx tailwindcss init -p echo 骨架生成完成: $TARGET_DIR这个脚本做的事很直白建目录、拷配置、初始化 Vite、装 Tailwind。Codex 不需要自己决定用哪个构建工具脚本已经定好了。scripts/verify-skeleton.sh是自检脚本Codex 写完页面后跑一遍确认骨架没被破坏#!/usr/bin/env bash set -euo pipefail echo 检查目录结构... [ -d src/pages ] || { echo 缺少 src/pages; exit 1; } [ -d src/components ] || { echo 缺少 src/components; exit 1; } echo 检查路径别名... grep -q /\* tsconfig.json || { echo tsconfig 缺少 / 别名; exit 1; } echo 检查 Tailwind 配置... [ -f tailwind.config.js ] || { echo 缺少 tailwind.config.js; exit 1; } echo 骨架自检通过这三个文件加两个脚本就是一套最小可用的 skill。你把它放进项目根目录Codex 读SKILL.md之后就知道该按什么流程走。4. 验证请求Codex 调用 skill 后的成功结果配好之后要验证。验证分两步先确认 API 通道通再确认 Codex 按 skill 执行。第一步用 curl 测 TaoToken 端点curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: gpt-4o, messages: [{role: user, content: 回复 ok}], max_tokens: 10 }返回里如果有choices字段和内容说明 Key 和端点都正常。如果返回 401检查 Key 有没有复制全返回 404检查base_url是不是写成了https://taotoken.net/api而不是别的路径。第二步让 Codex 执行 skill。你在 Codex 里给的任务应该这样写按 web-skeleton-skill/SKILL.md 执行。 先运行 scripts/init-project.sh my-app 初始化骨架。 骨架生成后在 src/pages/ 下新建 Dashboard.tsx。 使用已有的 Tailwind 和 shadcn/ui 约定不要新建技术栈。 完成后运行 scripts/verify-skeleton.sh 自检。Codex 执行完之后你应该看到这样的结果my-app/ ├── src/ │ ├── pages/ │ │ └── Dashboard.tsx │ ├── components/ │ └── lib/ ├── vite.config.ts ├── tailwind.config.js └── tsconfig.jsonDashboard.tsx里应该 import 了/components/...而不是../../components/...样式用的是 Tailwind 类名没有自己写 CSS 文件。跑npm run dev能起来页面能渲染。如果 Codex 生成的页面里出现了import styled from styled-components或者自己建了src/styles/目录说明它没读 skill 或者读了没遵守。这时候你要在任务里加一句「不要引入 styled-components样式统一用 Tailwind」把约束写死。验证通过的标准就三条目录结构对、路径别名对、能跑起来。三条都满足说明 skill 生效了。5. 本篇常见错排查配 skill 和 Key 通道的过程中有几个错我踩过列出来你对照。错误一Codex 没读 SKILL.md 就开写。表现是它直接生成页面代码没有先跑init-project.sh。原因是任务描述里没明确让它先读 skill。解决方法是把「先读 SKILL.md」写进任务第一句或者用 Codex 的--skill参数显式指定 skill 目录。错误二base_url写错导致 404。TaoToken 的 API 端点是https://taotoken.net/api不是https://taotoken.net/api/v1。有些客户端会自动补/v1有些不会。你在config.toml里写base_url https://taotoken.net/api让客户端自己拼路径。如果还是 404检查是不是多写了斜杠。错误三Key 写进 config.toml 提交了。这是安全问题。config.toml里用${TAOTOKEN_API_KEY}引用环境变量本地.env文件加进.gitignore。如果你已经提交了去控制台把那个 Key 删掉重新生成一个。错误四skill 脚本没有执行权限。init-project.sh复制过去之后可能没有x权限Codex 跑的时候报Permission denied。解决方法是chmod x scripts/*.sh或者在任务里让 Codex 用bash scripts/init-project.sh调用。错误五Tailwind 版本冲突。模板里写的是 Tailwind 3.4但npm install tailwindcss默认装最新版可能是 4.x配置方式不一样。脚本里要写死tailwindcss3.4避免版本漂移。错误六路径别名在 Vite 里没配。tsconfig.json里配了/别名但vite.config.ts里没配resolve.alias运行时报模块找不到。两个地方都要配缺一不可。提示排查顺序建议是先测 API 通道curl再测 skill 脚本手动跑一遍最后测 Codex 集成。这样能快速定位是 Key 问题、脚本问题还是 Codex 理解问题。6. 把 Key 通道和 skill 接进日常工作流骨架立起来之后日常用法就固定了。每次新页面任务你给 Codex 的指令模板是按 web-skeleton-skill/SKILL.md 执行。 在 src/pages/ 下新建 页面名.tsx。 使用已有技术栈和组件约定。 完成后运行 verify-skeleton.sh。Key 通道那边你只需要维护一个环境变量TAOTOKEN_API_KEY。换模型的时候改config.toml里的model字段端点不动。多项目共用同一个 Key额度在控制台统一看。如果你要接 CI把TAOTOKEN_API_KEY配成 CI 的 secretconfig.toml里的${TAOTOKEN_API_KEY}会自动读取。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有不同客户端的配置示例Codex 的配置可以对照着改。长期做编码任务的话Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 里有按量套餐比单次调用划算。Claude Code 用户看 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite 里面有 Anthropic 兼容端点的配置方式。最后说一个实际经验skill 目录不要写太大。我见过有人把整个团队的编码规范塞进 SKILL.md结果 Codex 读完之后反而不知道重点在哪。skill 的作用是定骨架不是定所有细节。骨架定好之后业务代码让 Codex 自由发挥这样它写得快你也省心。