1. 从 /doctor 只显示 0 个 skill 说起本地 Skill 与模型入口要分开看如果你在 Claude Code 里装了wechat-miniprogram-prompts结果/doctor里skills仍然是 0或者在 Codex 新会话里说“我想做一个小程序”Agent 没有加载六阶段路由而是直接开始猜页面又或者在 Cursor 里明明放了文件夹Agent 却完全不按SKILL.md的规则走——问题通常不在模型能力而在两件事Skill 目录层级放错以及模型入口没有指向 TaoToken。TaoToken 在这里只负责 Key 和模型入口你先到 TaoToken 官网 取出YOUR_API_KEY再把 Base URL 配成https://taotoken.net/api。Skill 本身是一个本地文件夹Cursor、Codex、Claude Code 三端共用同一份SKILL.md与templates.md。上一轮内容解决的是“模板在哪里”这一轮要解决的是“Agent 怎么自动找到模板、怎么按阶段路由、怎么在三端稳定跑起来”。原来的痛点很具体模板本身没问题但每次都要在长文里翻到对应小节占位符还要手动替换改着改着就不知道当前该用哪一条。把 6 类模板、三条原则、常见坑提醒和“该用哪条模板”的判断逻辑打包成一个 Agent Skill 后你只需要说一句“我想做一个财务工具小程序”Agent 就能先判断开发阶段再生成填好占位符的提示词。但这里有个容易被忽略的边界Skill 不提供模型额度也不代理模型请求。它只改变 Agent 的行为方式。真正消耗的是模型 Token而 Token 入口由 TaoToken 负责。也就是说安装 Skill、配置 Key、选择模型入口是三件事不要混在一起排查。下面按可复现的顺序拆开先看 Skill 文件结构再看三端安装路径然后配 Claude Code、Codex、CC Switch最后用/doctor做前后对照。2. wechat-miniprogram-prompts 的文件结构SKILL.md 负责路由templates.md 负责按需加载这份 Skill 的核心不是把 6 类模板全文塞进每一轮对话而是拆成两个层次SKILL.md放触发条件、三原则、六阶段路由表、Agent 行为规则和常见坑templates.md放模板原文和填好示例等 Agent 判断出阶段后再按需读取。这样做的好处是上下文更干净不会因为模板库太长导致每次对话都带着大量无关内容也能减少无效 Token 消耗。目录结构可以整理成下面这样wechat-miniprogram-prompts-package/ ├── README.md # 安装说明 ├── install-all.ps1 # 一键安装三端 ├── install-cursor.ps1 # 单独安装到 Cursor ├── install-codex.ps1 # 单独安装到 Codex ├── install-claude.ps1 # 单独安装到 Claude Code └── skill/ └── wechat-miniprogram-prompts/ ├── SKILL.md └── templates.md安装完成后一定要确认SKILL.md和templates.md都在目标目录下。很多“Skill 不生效”的情况实际是只复制了外层文件夹或者把SKILL.md放成了skill.md又或者目录名改成了wechat-miniprogram-prompt导致 Agent 扫描不到。SKILL.md可以写成类似下面的骨架。注意这不是全文模板而是给 Agent 看的岗位手册关键是让它在合适的时候触发而不是把全部内容一次性输出。--- name: wechat-miniprogram-prompts description: 微信小程序开发提示词路由。当用户提到小程序、页面结构、修 Bug、提审、合规检查时触发。 --- # WeChat MiniProgram Prompts ## 三条原则 1. 一次只推进一个页面或一个功能不并行改多个页面。 2. 先确认开发阶段再输出对应模板。 3. 模板只负责生成提示词不代替真机自测。 ## 六阶段路由 | 阶段 | 触发语句示例 | 输出重点 | | --- | --- | --- | | 01 需求拆解 | 我想做一个 XX 小程序 | 追问用户、场景、主体、云开发、MVP | | 02 页面结构 | 给 pages/index/index 设计结构 | 单页数据、方法、组件边界 | | 03 单功能实现 | 实现新增一笔支出 | 验收标准、异常提示、回归范围 | | 04 报错修复 | 保存没反应真机报错 | 报错全文、复现步骤、最小修复 | | 05 合规检查 | 准备上线 | 类目、隐私、个人主体限制 | | 06 提审自查 | 准备提审 | 主路径、真机测试、行动清单 |templates.md则保存真正要复制给模型的提示词。建议按 01 到 06 编号每个模板包含“适用场景”“提示词正文”“填好示例”“常见坑”。Agent 在路由到某阶段后只读对应小节而不是全量加载。这样你在 Cursor、Codex、Claude Code 三端复用时行为和输出格式保持一致。3. 三端安装路径Cursor、Codex、Claude Code 各放哪里三端通用不等于三端路径一样。同一个wechat-miniprogram-prompts文件夹复制到不同目录生效范围也不同。先给结论文件夹名必须保持wechat-miniprogram-prompts不变目录名通常就是 Skill 名或斜杠命令名。Windows 用户可以用一键脚本。在分享包根目录打开 PowerShell执行Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass .\install-all.ps1如果只想单独装某一端可以分别执行.\install-cursor.ps1 .\install-codex.ps1 .\install-claude.ps1这些命令都在你本地终端执行不要让 Agent 直接去改系统目录或生产项目目录。安装类操作最好由你自己确认路径后再跑尤其是团队项目避免误覆盖别人的 Skill 配置。Cursor 安装Cursor 有两种常用位置。个人 Skill所有项目可用~/.cursor/skills/wechat-miniprogram-prompts/项目 Skill团队共享可提交 git项目根/.cursor/skills/wechat-miniprogram-prompts/注意不要放到~/.cursor/skills-cursor/那是 Cursor 内置目录不是给你放自定义 Skill 的地方。安装后重启 Cursor或者至少新开一轮 Agent 对话让目录扫描重新生效。Codex 安装Codex 的个人 Skill 放在$CODEX_HOME/skills/wechat-miniprogram-prompts/默认$CODEX_HOME是~/.codex所以常见路径是~/.codex/skills/wechat-miniprogram-prompts/安装后下一轮对话即可使用。如果 Codex 仍然不加载先检查SKILL.md是否在wechat-miniprogram-prompts目录下而不是在skills根目录下。Claude Code 安装Claude Code 的项目 Skill 放在项目根/.claude/skills/wechat-miniprogram-prompts/斜杠命令是/wechat-miniprogram-prompts目录名即命令名。Claude Code 会自动监听 skill 目录变更如果目录是新建的而当前会话已经启动建议重启 Claude Code 会话。验证安装时在 Claude Code 内运行/doctor检查 skill 是否被识别。安装前可能显示 0 个 skills安装后应能看到wechat-miniprogram-prompts。4. 模型接入配置Claude Code settings.json、Codex config.toml、CC Switch 三件套Skill 装好后第一次调用模型前需要去 TaoToken 官网 取 Key。TaoToken 只负责 Key 和模型入口Base URL 统一用https://taotoken.net/api注意Base URL 不加 UTM 参数它是 API 请求地址UTM 链接只用于官网入口。Claude Codesettings.json 与 ANTHROPIC_*Claude Code 可以用项目级.claude/settings.json也可以用用户级~/.claude/settings.json。示例{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: YOUR_MODEL_ID } }把YOUR_API_KEY换成你在 TaoToken 控制台创建的 Key把YOUR_MODEL_ID换成你要用的模型 ID。改完后重启 Claude Code 会话再运行/doctor检查 Skill 和模型配置。如果你使用 CC Switch 管理多套配置可以按“三件套”填供应商名称TaoToken API KeyYOUR_API_KEY Base URLhttps://taotoken.net/api 模型在 TaoToken 模型列表中选CC Switch 适合在多个供应商或多个模型之间切换。但要注意它是给 Claude Code 这类使用ANTHROPIC_*的客户端做配置切换的不要把它那套环境变量名照搬到 Codex。Codexconfig.toml 独立配置Codex 读的是config.toml不要把ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN写进 Codex。示例model YOUR_CODEX_MODEL model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api responses然后在终端里设置环境变量。PowerShell$env:TAOTOKEN_API_KEYYOUR_API_KEYmacOS / Linuxexport TAOTOKEN_API_KEYYOUR_API_KEY如果你要让环境变量长期生效可以写入系统环境变量或 shell 配置文件。配置完成后Codex 新开会话检查是否走taotokenprovider。若仍然走旧供应商优先检查model_provider是否被其他配置覆盖以及env_key对应的变量是否真的存在。Cursor模型入口单独配Cursor 的 Skill 生效和模型入口是两套配置。Skill 放对目录后Agent 行为会变化但模型请求走哪里取决于你在 Cursor 里选择的模型供应商或自定义 API 配置。无论用哪端Base URL 都保持https://taotoken.net/apiKey 使用YOUR_API_KEY占位实际值从 TaoToken 控制台创建。不要把 Key 提交到 git也不要把包含真实 Key 的settings.json或config.toml推到公开仓库。5. 财务工具小程序实战六阶段路由产生的提示词长什么样下面用一个连贯案例展示 Skill 实际怎么工作。重点不是贴模板全文而是看 Agent 每一步会输出什么。假设你是小程序开发者用 Cursor、Codex 或 Claude Code 跑这个 Skill模型 Token 通过 TaoToken 入口消耗。第 1 步只有模糊想法你说我想做一个财务工具小程序Skill 识别为 01 需求拆解。它不会直接写代码而是列出还需要你补充的信息目标用户是谁核心问题是什么记账、预算还是报表个人主体还是企业主体是否使用云开发第一版最想有的 1 到 2 个功能是什么这一步的价值是阻止你在需求不清时直接进入实现。很多小程序项目返工不是因为代码难而是因为第一版范围没有收住。第 2 步补充信息后输出完整提示词你回复个人用户记账太麻烦不用云开发第一版要快速记账和月度统计。Agent 输出结构如下【选用模板】01 需求拆解 【可直接复制的提示词】 项目名称轻量记账 目标用户个人用户 核心问题记账步骤多月度统计不直观 技术边界不使用云开发 第一版功能快速记账、月度统计 【注意事项】不要一上来就说“帮我做小程序” 【下一步建议】需求确定后使用 02 页面结构你把提示词复制给模型可以得到功能清单、页面规划和 MVP 建议。注意这一步消耗的是模型 Token不是 Skill 本身。Skill 只是把提示词组织好模型入口仍然是 TaoToken 的 Base URL。第 3 步需求定了搭页面骨架你说给 pages/index/index 设计页面结构。Skill 路由到 02并提醒一次只做一个页面不要同时改app.json和三个页面。页面结构模板通常会要求输出数据字段、交互方法、组件拆分和空状态而不是直接给一大段页面代码。第 4 步实现单一功能你说实现新增一笔支出的功能。Skill 路由到 03生成的提示词自带验收标准主路径可以走通。异常输入有提示。不破坏已有功能。保存后列表能刷新。金额、分类、备注字段边界明确。你仍然要自己当 QA 点一遍。Skill 不会替你省略真机测试它只是让提示词更完整。第 5 步出问题了保存按钮没反应真机报错TypeError: Cannot read property amount of undefinedSkill 路由到 04并强调报错信息、复现步骤、机型、基础库版本要完整不要只说“坏了帮我修”。修复模板会要求先定位数据来源再给最小修改最后说明回归范围。第 6 步准备上线功能差不多做完进入 05 合规检查关注类目、隐私协议、个人主体限制。准备提审时进入 06 提审自查关注主功能可用、真机测试路径、10 分钟行动清单。提醒一句清单打勾后自己再用手机走 3 遍主路径。模板不能代替真机自测。6. /doctor 前后对照安装成功与 401、404、skill 未加载的排查表Claude Code 里最直接的验证方式是/doctor。安装前可能看到 skills 数量为 0安装后应该能看到wechat-miniprogram-prompts。你可以把前后输出记下来方便排查。安装前Skills - 0 loaded安装后Skills - wechat-miniprogram-prompts如果结果不符合按下面这张表排查。现象优先检查修复动作/doctor找不到 skill目录层级必须是.../skills/wechat-miniprogram-prompts/SKILL.mdClaude Code 斜杠命令不存在目录名目录名保持wechat-miniprogram-promptsCodex 不加载 Skill$CODEX_HOME检查~/.codex/skills/wechat-miniprogram-prompts/Cursor 不触发放错内置目录移到~/.cursor/skills/或项目.cursor/skills/模型请求 401API Key到 TaoToken 控制台创建 Key替换YOUR_API_KEY模型请求 404Base URL 或模型名Base URL 用https://taotoken.net/api模型名按控制台选择Codex 仍走旧供应商config.toml设置model_provider taotoken环境变量用TAOTOKEN_API_KEYClaude Code 不读新配置会话未重启重启 Claude Code再运行/doctorSkill 触发但输出不完整templates.md缺失确认两个文件都在同一 Skill 目录下如果你修改了配置但没有任何变化先确认改的是哪一级配置文件。Claude Code 有项目级和用户级Codex 有$CODEX_HOME/config.toml和环境变量Cursor 有工作区设置和全局设置。不同层级的优先级不同最稳的方式是只保留一套有效配置然后逐项验证。7. Token 消耗与上下文控制为什么 templates.md 要按需读取很多开发者第一次把模板库做成 Skill 时会把所有模板全文塞进SKILL.md结果每轮对话都带着大量无关内容。这样做的直接后果是上下文变长、响应变慢模型 Token 消耗也更难控制。更合理的方式是SKILL.md只保留触发条件、三原则、六阶段路由和常见坑templates.md保存完整模板由 Agent 在路由到具体阶段后再读取对应小节。从消耗角度看Skill 文件本身不调用模型不产生 Token 费用。真正消耗发生在Agent 读取SKILL.md理解触发条件和路由规则。Agent 根据阶段按需读取templates.md的某一段。模型生成提示词、追问或代码建议。你复制提示词继续对话产生后续上下文。所以安装 Skill 后首次调用模型前去 TaoToken 官网 取 Key 并配置 Base URL是必要步骤。不要在 Skill 文件里写死 Key也不要把真实 Key 提交到仓库。推荐做法是Skill 目录本地保存团队可共享 SKILL.md 和 templates.md Key通过环境变量或本地 settings.json 管理 Base URLhttps://taotoken.net/api 模型名按 TaoToken 控制台提供的模型列表选择另外三端行为尽量保持一致。Cursor、Codex、Claude Code 对 Skill 的扫描方式不同但SKILL.md的语义可以共用。建议在SKILL.md里把触发语句写清楚例如“我想做一个小程序”“提审前检查”“保存按钮没反应”“页面结构怎么设计”。触发越明确Agent 越不容易漏加载。8. 从模型对话到 Coding Plan把 Skill 跑起来的最短路径到这里一份三端通用的 Agent Skill 已经可以跑起来了。回顾一下最小闭环准备wechat-miniprogram-prompts文件夹包含SKILL.md和templates.md。用install-all.ps1或单独脚本安装到 Cursor、Codex、Claude Code。在 Claude Code 运行/doctor确认 Skill 被识别。到 TaoToken 创建 KeyClaude Code 用settings.json配ANTHROPIC_*Codex 用config.toml配TAOTOKEN_API_KEYCC Switch 按 API Key、Base URL、模型三件套切换。Base URL 统一使用https://taotoken.net/api。新开一轮对话说“我想做一个 XX 小程序”观察 Agent 是否按 01 到 06 路由。如果你还没开始配模型入口可以先在 模型对话 里试一下要用的模型确认长期要用 Skill 跑小程序开发再看 Coding Plan然后到 API Keys 创建YOUR_API_KEYClaude Code 的配置细节可以对照 Claude Code 文档。完整入口放在 TaoToken 官网Base URL 仍然是https://taotoken.net/api。最后提醒一句Skill 让 Agent 更懂“什么时候该做什么”但不会替你决定产品范围也不会替你完成真机自测。先用 01 阶段把需求收窄再用 02 到 04 推进页面、功能和修复最后用 05 和 06 做上线检查。三端装好后建议先用一个真实的小程序需求走一遍完整流程再决定是否需要调整SKILL.md里的触发语句和templates.md的模板顺序。 三端通用 Agent Skill：TaoToken 只负责 Key 和模型入口
1. 从 /doctor 只显示 0 个 skill 说起本地 Skill 与模型入口要分开看如果你在 Claude Code 里装了wechat-miniprogram-prompts结果/doctor里skills仍然是 0或者在 Codex 新会话里说“我想做一个小程序”Agent 没有加载六阶段路由而是直接开始猜页面又或者在 Cursor 里明明放了文件夹Agent 却完全不按SKILL.md的规则走——问题通常不在模型能力而在两件事Skill 目录层级放错以及模型入口没有指向 TaoToken。TaoToken 在这里只负责 Key 和模型入口你先到 TaoToken 官网 取出YOUR_API_KEY再把 Base URL 配成https://taotoken.net/api。Skill 本身是一个本地文件夹Cursor、Codex、Claude Code 三端共用同一份SKILL.md与templates.md。上一轮内容解决的是“模板在哪里”这一轮要解决的是“Agent 怎么自动找到模板、怎么按阶段路由、怎么在三端稳定跑起来”。原来的痛点很具体模板本身没问题但每次都要在长文里翻到对应小节占位符还要手动替换改着改着就不知道当前该用哪一条。把 6 类模板、三条原则、常见坑提醒和“该用哪条模板”的判断逻辑打包成一个 Agent Skill 后你只需要说一句“我想做一个财务工具小程序”Agent 就能先判断开发阶段再生成填好占位符的提示词。但这里有个容易被忽略的边界Skill 不提供模型额度也不代理模型请求。它只改变 Agent 的行为方式。真正消耗的是模型 Token而 Token 入口由 TaoToken 负责。也就是说安装 Skill、配置 Key、选择模型入口是三件事不要混在一起排查。下面按可复现的顺序拆开先看 Skill 文件结构再看三端安装路径然后配 Claude Code、Codex、CC Switch最后用/doctor做前后对照。2. wechat-miniprogram-prompts 的文件结构SKILL.md 负责路由templates.md 负责按需加载这份 Skill 的核心不是把 6 类模板全文塞进每一轮对话而是拆成两个层次SKILL.md放触发条件、三原则、六阶段路由表、Agent 行为规则和常见坑templates.md放模板原文和填好示例等 Agent 判断出阶段后再按需读取。这样做的好处是上下文更干净不会因为模板库太长导致每次对话都带着大量无关内容也能减少无效 Token 消耗。目录结构可以整理成下面这样wechat-miniprogram-prompts-package/ ├── README.md # 安装说明 ├── install-all.ps1 # 一键安装三端 ├── install-cursor.ps1 # 单独安装到 Cursor ├── install-codex.ps1 # 单独安装到 Codex ├── install-claude.ps1 # 单独安装到 Claude Code └── skill/ └── wechat-miniprogram-prompts/ ├── SKILL.md └── templates.md安装完成后一定要确认SKILL.md和templates.md都在目标目录下。很多“Skill 不生效”的情况实际是只复制了外层文件夹或者把SKILL.md放成了skill.md又或者目录名改成了wechat-miniprogram-prompt导致 Agent 扫描不到。SKILL.md可以写成类似下面的骨架。注意这不是全文模板而是给 Agent 看的岗位手册关键是让它在合适的时候触发而不是把全部内容一次性输出。--- name: wechat-miniprogram-prompts description: 微信小程序开发提示词路由。当用户提到小程序、页面结构、修 Bug、提审、合规检查时触发。 --- # WeChat MiniProgram Prompts ## 三条原则 1. 一次只推进一个页面或一个功能不并行改多个页面。 2. 先确认开发阶段再输出对应模板。 3. 模板只负责生成提示词不代替真机自测。 ## 六阶段路由 | 阶段 | 触发语句示例 | 输出重点 | | --- | --- | --- | | 01 需求拆解 | 我想做一个 XX 小程序 | 追问用户、场景、主体、云开发、MVP | | 02 页面结构 | 给 pages/index/index 设计结构 | 单页数据、方法、组件边界 | | 03 单功能实现 | 实现新增一笔支出 | 验收标准、异常提示、回归范围 | | 04 报错修复 | 保存没反应真机报错 | 报错全文、复现步骤、最小修复 | | 05 合规检查 | 准备上线 | 类目、隐私、个人主体限制 | | 06 提审自查 | 准备提审 | 主路径、真机测试、行动清单 |templates.md则保存真正要复制给模型的提示词。建议按 01 到 06 编号每个模板包含“适用场景”“提示词正文”“填好示例”“常见坑”。Agent 在路由到某阶段后只读对应小节而不是全量加载。这样你在 Cursor、Codex、Claude Code 三端复用时行为和输出格式保持一致。3. 三端安装路径Cursor、Codex、Claude Code 各放哪里三端通用不等于三端路径一样。同一个wechat-miniprogram-prompts文件夹复制到不同目录生效范围也不同。先给结论文件夹名必须保持wechat-miniprogram-prompts不变目录名通常就是 Skill 名或斜杠命令名。Windows 用户可以用一键脚本。在分享包根目录打开 PowerShell执行Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass .\install-all.ps1如果只想单独装某一端可以分别执行.\install-cursor.ps1 .\install-codex.ps1 .\install-claude.ps1这些命令都在你本地终端执行不要让 Agent 直接去改系统目录或生产项目目录。安装类操作最好由你自己确认路径后再跑尤其是团队项目避免误覆盖别人的 Skill 配置。Cursor 安装Cursor 有两种常用位置。个人 Skill所有项目可用~/.cursor/skills/wechat-miniprogram-prompts/项目 Skill团队共享可提交 git项目根/.cursor/skills/wechat-miniprogram-prompts/注意不要放到~/.cursor/skills-cursor/那是 Cursor 内置目录不是给你放自定义 Skill 的地方。安装后重启 Cursor或者至少新开一轮 Agent 对话让目录扫描重新生效。Codex 安装Codex 的个人 Skill 放在$CODEX_HOME/skills/wechat-miniprogram-prompts/默认$CODEX_HOME是~/.codex所以常见路径是~/.codex/skills/wechat-miniprogram-prompts/安装后下一轮对话即可使用。如果 Codex 仍然不加载先检查SKILL.md是否在wechat-miniprogram-prompts目录下而不是在skills根目录下。Claude Code 安装Claude Code 的项目 Skill 放在项目根/.claude/skills/wechat-miniprogram-prompts/斜杠命令是/wechat-miniprogram-prompts目录名即命令名。Claude Code 会自动监听 skill 目录变更如果目录是新建的而当前会话已经启动建议重启 Claude Code 会话。验证安装时在 Claude Code 内运行/doctor检查 skill 是否被识别。安装前可能显示 0 个 skills安装后应能看到wechat-miniprogram-prompts。4. 模型接入配置Claude Code settings.json、Codex config.toml、CC Switch 三件套Skill 装好后第一次调用模型前需要去 TaoToken 官网 取 Key。TaoToken 只负责 Key 和模型入口Base URL 统一用https://taotoken.net/api注意Base URL 不加 UTM 参数它是 API 请求地址UTM 链接只用于官网入口。Claude Codesettings.json 与 ANTHROPIC_*Claude Code 可以用项目级.claude/settings.json也可以用用户级~/.claude/settings.json。示例{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: YOUR_MODEL_ID } }把YOUR_API_KEY换成你在 TaoToken 控制台创建的 Key把YOUR_MODEL_ID换成你要用的模型 ID。改完后重启 Claude Code 会话再运行/doctor检查 Skill 和模型配置。如果你使用 CC Switch 管理多套配置可以按“三件套”填供应商名称TaoToken API KeyYOUR_API_KEY Base URLhttps://taotoken.net/api 模型在 TaoToken 模型列表中选CC Switch 适合在多个供应商或多个模型之间切换。但要注意它是给 Claude Code 这类使用ANTHROPIC_*的客户端做配置切换的不要把它那套环境变量名照搬到 Codex。Codexconfig.toml 独立配置Codex 读的是config.toml不要把ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN写进 Codex。示例model YOUR_CODEX_MODEL model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api responses然后在终端里设置环境变量。PowerShell$env:TAOTOKEN_API_KEYYOUR_API_KEYmacOS / Linuxexport TAOTOKEN_API_KEYYOUR_API_KEY如果你要让环境变量长期生效可以写入系统环境变量或 shell 配置文件。配置完成后Codex 新开会话检查是否走taotokenprovider。若仍然走旧供应商优先检查model_provider是否被其他配置覆盖以及env_key对应的变量是否真的存在。Cursor模型入口单独配Cursor 的 Skill 生效和模型入口是两套配置。Skill 放对目录后Agent 行为会变化但模型请求走哪里取决于你在 Cursor 里选择的模型供应商或自定义 API 配置。无论用哪端Base URL 都保持https://taotoken.net/apiKey 使用YOUR_API_KEY占位实际值从 TaoToken 控制台创建。不要把 Key 提交到 git也不要把包含真实 Key 的settings.json或config.toml推到公开仓库。5. 财务工具小程序实战六阶段路由产生的提示词长什么样下面用一个连贯案例展示 Skill 实际怎么工作。重点不是贴模板全文而是看 Agent 每一步会输出什么。假设你是小程序开发者用 Cursor、Codex 或 Claude Code 跑这个 Skill模型 Token 通过 TaoToken 入口消耗。第 1 步只有模糊想法你说我想做一个财务工具小程序Skill 识别为 01 需求拆解。它不会直接写代码而是列出还需要你补充的信息目标用户是谁核心问题是什么记账、预算还是报表个人主体还是企业主体是否使用云开发第一版最想有的 1 到 2 个功能是什么这一步的价值是阻止你在需求不清时直接进入实现。很多小程序项目返工不是因为代码难而是因为第一版范围没有收住。第 2 步补充信息后输出完整提示词你回复个人用户记账太麻烦不用云开发第一版要快速记账和月度统计。Agent 输出结构如下【选用模板】01 需求拆解 【可直接复制的提示词】 项目名称轻量记账 目标用户个人用户 核心问题记账步骤多月度统计不直观 技术边界不使用云开发 第一版功能快速记账、月度统计 【注意事项】不要一上来就说“帮我做小程序” 【下一步建议】需求确定后使用 02 页面结构你把提示词复制给模型可以得到功能清单、页面规划和 MVP 建议。注意这一步消耗的是模型 Token不是 Skill 本身。Skill 只是把提示词组织好模型入口仍然是 TaoToken 的 Base URL。第 3 步需求定了搭页面骨架你说给 pages/index/index 设计页面结构。Skill 路由到 02并提醒一次只做一个页面不要同时改app.json和三个页面。页面结构模板通常会要求输出数据字段、交互方法、组件拆分和空状态而不是直接给一大段页面代码。第 4 步实现单一功能你说实现新增一笔支出的功能。Skill 路由到 03生成的提示词自带验收标准主路径可以走通。异常输入有提示。不破坏已有功能。保存后列表能刷新。金额、分类、备注字段边界明确。你仍然要自己当 QA 点一遍。Skill 不会替你省略真机测试它只是让提示词更完整。第 5 步出问题了保存按钮没反应真机报错TypeError: Cannot read property amount of undefinedSkill 路由到 04并强调报错信息、复现步骤、机型、基础库版本要完整不要只说“坏了帮我修”。修复模板会要求先定位数据来源再给最小修改最后说明回归范围。第 6 步准备上线功能差不多做完进入 05 合规检查关注类目、隐私协议、个人主体限制。准备提审时进入 06 提审自查关注主功能可用、真机测试路径、10 分钟行动清单。提醒一句清单打勾后自己再用手机走 3 遍主路径。模板不能代替真机自测。6. /doctor 前后对照安装成功与 401、404、skill 未加载的排查表Claude Code 里最直接的验证方式是/doctor。安装前可能看到 skills 数量为 0安装后应该能看到wechat-miniprogram-prompts。你可以把前后输出记下来方便排查。安装前Skills - 0 loaded安装后Skills - wechat-miniprogram-prompts如果结果不符合按下面这张表排查。现象优先检查修复动作/doctor找不到 skill目录层级必须是.../skills/wechat-miniprogram-prompts/SKILL.mdClaude Code 斜杠命令不存在目录名目录名保持wechat-miniprogram-promptsCodex 不加载 Skill$CODEX_HOME检查~/.codex/skills/wechat-miniprogram-prompts/Cursor 不触发放错内置目录移到~/.cursor/skills/或项目.cursor/skills/模型请求 401API Key到 TaoToken 控制台创建 Key替换YOUR_API_KEY模型请求 404Base URL 或模型名Base URL 用https://taotoken.net/api模型名按控制台选择Codex 仍走旧供应商config.toml设置model_provider taotoken环境变量用TAOTOKEN_API_KEYClaude Code 不读新配置会话未重启重启 Claude Code再运行/doctorSkill 触发但输出不完整templates.md缺失确认两个文件都在同一 Skill 目录下如果你修改了配置但没有任何变化先确认改的是哪一级配置文件。Claude Code 有项目级和用户级Codex 有$CODEX_HOME/config.toml和环境变量Cursor 有工作区设置和全局设置。不同层级的优先级不同最稳的方式是只保留一套有效配置然后逐项验证。7. Token 消耗与上下文控制为什么 templates.md 要按需读取很多开发者第一次把模板库做成 Skill 时会把所有模板全文塞进SKILL.md结果每轮对话都带着大量无关内容。这样做的直接后果是上下文变长、响应变慢模型 Token 消耗也更难控制。更合理的方式是SKILL.md只保留触发条件、三原则、六阶段路由和常见坑templates.md保存完整模板由 Agent 在路由到具体阶段后再读取对应小节。从消耗角度看Skill 文件本身不调用模型不产生 Token 费用。真正消耗发生在Agent 读取SKILL.md理解触发条件和路由规则。Agent 根据阶段按需读取templates.md的某一段。模型生成提示词、追问或代码建议。你复制提示词继续对话产生后续上下文。所以安装 Skill 后首次调用模型前去 TaoToken 官网 取 Key 并配置 Base URL是必要步骤。不要在 Skill 文件里写死 Key也不要把真实 Key 提交到仓库。推荐做法是Skill 目录本地保存团队可共享 SKILL.md 和 templates.md Key通过环境变量或本地 settings.json 管理 Base URLhttps://taotoken.net/api 模型名按 TaoToken 控制台提供的模型列表选择另外三端行为尽量保持一致。Cursor、Codex、Claude Code 对 Skill 的扫描方式不同但SKILL.md的语义可以共用。建议在SKILL.md里把触发语句写清楚例如“我想做一个小程序”“提审前检查”“保存按钮没反应”“页面结构怎么设计”。触发越明确Agent 越不容易漏加载。8. 从模型对话到 Coding Plan把 Skill 跑起来的最短路径到这里一份三端通用的 Agent Skill 已经可以跑起来了。回顾一下最小闭环准备wechat-miniprogram-prompts文件夹包含SKILL.md和templates.md。用install-all.ps1或单独脚本安装到 Cursor、Codex、Claude Code。在 Claude Code 运行/doctor确认 Skill 被识别。到 TaoToken 创建 KeyClaude Code 用settings.json配ANTHROPIC_*Codex 用config.toml配TAOTOKEN_API_KEYCC Switch 按 API Key、Base URL、模型三件套切换。Base URL 统一使用https://taotoken.net/api。新开一轮对话说“我想做一个 XX 小程序”观察 Agent 是否按 01 到 06 路由。如果你还没开始配模型入口可以先在 模型对话 里试一下要用的模型确认长期要用 Skill 跑小程序开发再看 Coding Plan然后到 API Keys 创建YOUR_API_KEYClaude Code 的配置细节可以对照 Claude Code 文档。完整入口放在 TaoToken 官网Base URL 仍然是https://taotoken.net/api。最后提醒一句Skill 让 Agent 更懂“什么时候该做什么”但不会替你决定产品范围也不会替你完成真机自测。先用 01 阶段把需求收窄再用 02 到 04 推进页面、功能和修复最后用 05 和 06 做上线检查。三端装好后建议先用一个真实的小程序需求走一遍完整流程再决定是否需要调整SKILL.md里的触发语句和templates.md的模板顺序。