1. Codex 里写 Skill 最烦的不是写是每次都要重配 Key如果你已经在 Codex 里用上了 Agent Skills大概率经历过这个循环$skill-creator生成骨架改SKILL.md$skill-installer装好跑一次挺顺。然后换台机器、换个项目、或者团队里另一个人接手第一件事就是重新找 API Key、重新填settings.json、重新确认模型通道对不对。技能本身是可复用的但通道配置每次都要重来一遍。这篇就解决这一件事把 Codex 的 Agent Skills 工作流和 TaoToken 的统一 Key/API 通道接起来。具体会给你一份可直接复制的settings.json骨架、一份SKILL.md模板然后完整走一遍「用 skill-creator 生成 → 用 skill-installer 安装 → 在 settings.json 里接入 TaoToken → 发一次请求验证通道生效」的流程。适合已经在用 Codex、想把手上的 Skill 真正跑成稳定工作流的人也适合刚接触 Agent Skills、想一次把目录结构和配置搞对的新手。先说清楚三个东西的分工不然后面容易混。SKILL.md是技能本体用 YAML frontmatter 写name和description正文写具体步骤Codex 靠 description 决定要不要激活它。skill-creator是帮你生成这个骨架的入口skill-installer是安装精选技能的入口。而settings.json管的是另一层——模型走哪条通道、用哪个 Key、请求发到哪个地址。技能是「做什么」settings 是「通过谁做」。把这两层分开后面排障会轻松很多。2. 接入前先把 TaoToken 的通道准备好TaoToken 在这里扮演的角色是统一的 API 通道你不需要在 Codex 里为每个技能、每个项目单独维护一套模型接入信息而是把 Key 和 API 地址收敛到一处让 Codex 的请求统一走这条通道。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。动手前你需要拿到两样东西一个可用的 API Key以及确认你要用的模型名。Key 在控制台的 API Keys 页面创建地址是 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。创建时建议按用途命名比如codex-skills-dev这样以后要轮换或吊销时不会误伤别的项目。模型名这块如果你不确定当前有哪些可用模型可以直接在模型对话页面试一下地址是 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。在那边发一条消息确认能正常返回再把这个模型名填进 Codex 的配置里比盲填要稳。有一点要提前说清楚TaoToken 是 API 通道不是编辑器也不替代 Codex 本身。你的 Skill 逻辑、目录结构、触发词都还是写在 Codex 这边TaoToken 只负责让请求有地方可去、有 Key 可用。理解这一点后面配置就不会拧巴。3. 可复制的 settings.json 骨架与 SKILL.md 模板3.1 settings.json 骨架Codex 的配置可以放在项目级也可以放在用户级。项目级适合团队共享同一套通道用户级适合个人所有项目复用。下面这份骨架以项目级为例路径放在项目根目录下的.codex/settings.json如果你的 Codex 版本读取的是~/.codex/config.toml把对应字段迁过去即可字段语义一致。{ model: your-model-name, provider: { name: taotoken, base_url: https://taotoken.net/api, api_key_env: TAOTOKEN_API_KEY }, skills: { directories: [ .agents/skills, ~/.agents/skills ], auto_discover: true }, request: { timeout_ms: 120000, max_retries: 2 } }几个字段值得单独说。base_url填https://taotoken.net/api注意不要带末尾多余的路径否则拼接后容易 404。api_key_env指向环境变量名而不是把 Key 明文写进文件这样配置文件可以进 GitKey 留在本地环境里。skills.directories同时列了项目级和用户级两个目录Codex 会按顺序扫描项目级优先。环境变量这样设Linux/macOSexport TAOTOKEN_API_KEYsk-你的keyWindows PowerShell$env:TAOTOKEN_API_KEYsk-你的key想持久化就写进 shell 的 profile 文件或者用系统环境变量面板。不要把 Key 直接写进settings.json再提交到仓库这是最常见的翻车点。3.2 SKILL.md 模板下面这份模板可以直接拿去改。frontmatter 只保留name和description两个必填字段正文按「做什么 / 何时触发 / 步骤 / 输入输出 / 示例」五段来写。--- name: meeting-notes description: 把会议记录整理成结构化纪要。当用户提供会议原文、录音转写文本或要求生成会议纪要、行动项、跟进清单时触发。 --- # 会议纪要整理 ## 做什么 把零散的会议记录整理成包含决议、行动项、责任人和截止时间的结构化纪要。 ## 何时触发 - 用户粘贴一段会议原文并要求整理 - 用户说帮我写个会议纪要提取行动项 - 用户提供转写文本需要归纳 ## 步骤 1. 通读全文识别参会人、议题、结论三类信息 2. 按议题分段每段提炼一句结论 3. 抽取所有行动项标注责任人和时间 4. 输出固定格式未提及的字段写待确认 ## 输入输出 输入一段会议原文纯文本 输出Markdown 格式纪要含「议题」「结论」「行动项」三节 ## 示例 输入今天讨论了登录改版张三负责前端下周三前给稿…… 输出 ### 议题登录改版 结论确定改版方向 行动项 - 前端稿 - 张三 - 下周三description 的写法是触发准确率的关键。核心用途和触发关键词要放在前面因为 Codex 在渐进式披露时先读的就是这段。别写成「做会议相关的事」太宽泛会导致该触发时不触发、不该触发时乱触发。3.3 目录结构一个最小可用的 Skill 只需要一个文件.agents/skills/meeting-notes/ └── SKILL.md需要脚本或参考资料时再加scripts/和references/。项目级放.agents/skills/用户级放~/.agents/skills/这两个路径别写错写错了 Codex 扫不到表现就是「技能明明在但就是不触发」。4. 用 skill-creator 生成、skill-installer 安装并验证通道4.1 用 skill-creator 生成骨架在 Codex 里显式调用创建器$skill-creator 创建一个会议纪要整理技能Codex 会反过来问你几个问题这个技能做什么、什么时候触发、输入输出长什么样、要不要脚本。按实际情况答它会生成目录和SKILL.md草稿。生成后你手动把 description 按 3.2 的写法收紧一遍自动生成的描述通常偏宽。如果你已经有现成的重复流程也可以用录制回放的方式生成草稿再手工整理成 SKILL.md。自动生成的东西一定要过一遍尤其是触发条件那段。4.2 用 skill-installer 安装安装精选技能$skill-installer meeting-notes安装器会从对应来源拉取技能并放到技能目录。装完如果/skills里没看到先重启 Codex多数情况是发现机制还没刷新。也可以用/skills命令查看当前已识别的技能列表确认目标技能在不在。安装第三方技能前先看来源、看脚本、看它申请了什么权限。安装器不是「自动帮你判断安全性」的工具这一步得自己把关。4.3 验证通道是否生效技能装好、settings.json 配好之后发一次真实请求验证。最直接的方式是显式调用技能并给一段输入$meeting-notes 今天讨论了登录改版张三负责前端下周三前给稿李四跟进后端接口本周五完成。如果通道配置正确你会拿到一份结构化纪要。如果返回的是鉴权错误、连接超时或模型不存在说明问题出在 settings 那一层不是技能本身。这时候按第 5 节逐项排查。想单独确认通道通不通也可以先在模型对话页面发一条消息地址 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。那边能通、Codex 这边不通基本就是 settings.json 或环境变量的问题。4.4 长期编码场景的通道选择如果你不只是偶尔跑个技能而是把 Codex 当日常编码和 Agent 工作流的主力通道的稳定性和额度管理就变得重要。这种情况可以看一下 Coding Plan地址 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 它面向的就是长期、高频的编码类使用。接入方式和你上面配的 settings.json 是同一套换的是 Key 对应的套餐。5. 本篇常见错排查技能不触发。先查目录路径项目级必须是.agents/skills/用户级是~/.agents/skills/多一层少一层都扫不到。再查 description 有没有明确的触发句式比如「当用户……时触发」。最后用/skills确认 Codex 到底识别到了哪些技能。技能误触发。在agents/openai.yaml里设policy.allow_implicit_invocation: false关掉自动触发只保留显式$skill-name调用。或者在 description 里补负向说明写清楚「不要用于……」。401 或鉴权失败。九成是环境变量没生效。先echo $TAOTOKEN_API_KEY确认变量有值再确认settings.json里的api_key_env名字和实际变量名完全一致大小写也要对。改了环境变量记得重开终端或重启 Codex。404 或路径错误。检查base_url是不是写成了https://taotoken.net/api/带尾斜杠或者多拼了别的路径。正确值是https://taotoken.net/api。模型不存在。model字段填的名字和通道实际提供的对不上。去模型对话页面确认当前可用模型名再回填。改了配置不生效。Codex 对配置和技能的刷新不是实时的改完重启一次最稳。技能更新没显示同样先重启。Key 泄露风险。如果曾经把 Key 明文写进settings.json并提交过去控制台吊销旧 Key 重新生成一个地址 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 然后改用环境变量方式。多个技能同名。Codex 不会自动合并同名技能它们可能同时出现在选择器里。给技能起名时加前缀区分比如team-meeting-notes和personal-meeting-notes。6. 把通道和技能拆开维护后面省事整套流程跑下来最值得记住的一点是分层SKILL.md管技能逻辑settings.json管通道接入两者通过 Codex 的发现机制连起来。技能可以随便增删、分享、进 Git通道配置保持稳定不动。这样团队里换人、换机器只需要在新环境里设一次环境变量技能目录直接拉下来就能用。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有针对不同客户端的配置说明遇到字段对不上时以文档为准。Key 管理统一走 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 建议按项目或用途分开建 Key方便单独轮换。如果你用的是 Claude Code 那套 Anthropic 风格的接入对应入口在 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_anthropicutm_campaignrewrite 配置思路和这篇一致只是字段名不同。最后给一个实操建议先把settings.json和环境变量配通用模型对话页面确认通道没问题再去折腾 SKILL.md 的触发词。顺序反了的话技能不触发时你分不清是描述写得不好还是通道根本没通排障会绕远路。
