1. 问题不是模板少而是 Agent 一次改了 app.json 和三个页面本文要解决的场景很具体你在 Cursor、Codex 或 Claude Code 里让 Agent 做小程序它一口气改了app.json、pages/index/index、pages/add/add结果真机报TypeError: Cannot read property amount of undefined同时你还要把《小程序提示词模板》用起来。现在可以把这套模板打包成 Agent Skillwechat-miniprogram-prompts让 Agent 先判断开发阶段再逐页生成提示词。模型调用走 TaoToken官网入口先放这里https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentblog_skill_intro 。Base URL 统一用https://taotoken.net/apiKey 先用YOUR_API_KEY占位。很多人卡住不是因为不会写提示词而是因为提示词和项目状态脱节。你明明只想改一个保存按钮Agent 却顺手动了全局配置你明明还在需求拆解阶段它已经开始给你堆页面代码。app.json不要同时改是这篇的硬规则。Skill 的价值不是替你敲完所有代码而是把“当前该用哪条模板、下一步该做什么、哪些坑不能踩”变成可路由的流程。下面按可复现路径走一遍先看SKILL.md与templates.md的目录再装到三端接着用 TaoToken 接管模型调用然后用财务工具小程序做一次完整演练最后给出/doctor验证和常见报错前后对照。2. wechat-miniprogram-prompts 的文件结构与 6 阶段路由Agent Skill 可以先理解成一份给助手的“岗位手册”。它不是一个单文件提示词而是一个文件夹。这个分享包里最关键的是两个文件SKILL.md规定什么时候触发、当前处于哪个开发阶段、Agent 该怎么追问、哪些行为要拒绝。templates.md收录 6 类模板和填好占位符的示例按需读取避免每次对话都把整本模板塞进上下文。目录结构建议先确认成这样wechat-miniprogram-prompts-package/ ├── README.md ├── install-all.ps1 ├── install-cursor.ps1 ├── install-codex.ps1 ├── install-claude.ps1 └── skill/ └── wechat-miniprogram-prompts/ ├── SKILL.md └── templates.md安装完成后SKILL.md和templates.md必须都在wechat-miniprogram-prompts目录下。少一个Agent 可能能识别命令但无法正确路由模板。6 个阶段可以压缩成下面这张表阶段典型触发语Agent 产出01 需求拆解“我想做一个财务工具小程序”追问目标用户、核心痛点、主体、云开发、MVP 功能02 页面结构“给 pages/index/index 设计页面结构”单页结构、数据字段、交互路径03 单功能实现“实现新增一笔支出”可复制提示词、验收标准、异常提示要求04 报错修复“保存按钮没反应真机报 TypeError”要求报错全文、复现步骤、相关文件05 合规检查“准备上线检查类目和隐私”类目、隐私、个人主体限制清单06 提审自查“准备提审”主功能可用、真机路径、行动清单推荐顺序是01 → 02 → 03 →04 按需→ 05 → 06。这个顺序最重要的作用是防止跳步。你还在 01 阶段就不要让 Agent 改app.json你在 02 阶段也应该一次只设计一个页面不要让它同时改全局配置和三个页面文件。Skill 里还会强调三条原则一次只推进一个页面报错必须给完整上下文和复现步骤模板不能替代真机自测。尤其第三条很多开发者会忽略。Agent 可以帮你生成提示词、整理功能清单、提醒合规点但真机上按钮能不能点、支付路径能不能走、隐私弹窗是否出现仍然要你自己走一遍。这里已经开始消耗模型 TokenSkill 路由、追问、生成填好占位符的提示词都会调用模型。所以安装后首次调用前建议先去 TaoToken 官网取 Keyhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentblog_skill_files 。拿到后替换YOUR_API_KEYBase URL 仍然用https://taotoken.net/api。3. 三端安装install-all.ps1、目录树与 /doctor 前后对照下载分享包后先把skill/wechat-miniprogram-prompts/复制到对应目录。文件夹名必须保持wechat-miniprogram-prompts不变因为 Claude Code 的斜杠命令名就来自目录名。Windows 用户可以在分享包目录内打开 PowerShell执行一键安装Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass .\install-all.ps1这个脚本会尝试把 Skill 装到 Cursor、Codex、Claude Code 三端。如果你想分端处理也可以单独执行.\install-cursor.ps1 .\install-codex.ps1 .\install-claude.ps1Cursor 的安装路径可以按个人级或项目级选择个人级~/.cursor/skills/wechat-miniprogram-prompts/ 项目级项目根/.cursor/skills/wechat-miniprogram-prompts/注意不要放到~/.cursor/skills-cursor/那是 Cursor 内置目录不是给外部 Skill 用的。安装后重启 Cursor或者至少新开一轮 Agent 对话。Codex 的路径是$CODEX_HOME/skills/wechat-miniprogram-prompts/如果$CODEX_HOME没有单独设置默认通常在~/.codex下。也就是说完整路径通常是~/.codex/skills/wechat-miniprogram-prompts/Claude Code 项目级路径是项目根/.claude/skills/wechat-miniprogram-prompts/安装后Claude Code 里的斜杠命令是/wechat-miniprogram-promptsClaude Code 会监听 skill 目录变化但如果目录是新建的而当前会话已经启动建议重启一次会话避免命令没有加载。验证时可以在 Claude Code 内执行claude /doctor修复前的典型情况是目录名对但文件没拷全或者拷到了错误位置。表现类似$ ls .claude/skills/wechat-miniprogram-prompts # 没有输出 $ /doctor # 输出里看不到 wechat-miniprogram-prompts修复后应该是$ ls .claude/skills/wechat-miniprogram-prompts SKILL.md templates.md $ /doctor # 能看到 wechat-miniprogram-prompts 被识别如果/doctor不识别优先检查三件事目录名是否为wechat-miniprogram-promptsSKILL.md是否在目录根层templates.md是否缺失。不要急着改 SKILL 内容先把文件位置放对。4. TaoToken 接管模型调用Claude Code 的 settings.json 与 ANTHROPIC_*安装 Skill 只是让它能被 Agent 发现真正生成提示词时还要有模型调用通道。首次调用模型前去 TaoToken 官网创建 Keyhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentblog_skill_key_setup 。把拿到的 Key 替换成YOUR_API_KEYBase URL 填https://taotoken.net/api。Claude Code 推荐用settings.json管理环境变量。个人级可以放在~/.claude/settings.json项目级可以放在项目根/.claude/settings.json。示例{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: 在 TaoToken 控制台复制的模型 ID } }如果你使用 CC Switch 管理多套模型配置记住三件套Base URLhttps://taotoken.net/apiAPI KeyYOUR_API_KEY模型 ID从 TaoToken 控制台复制不要凭记忆手写CC Switch 的作用是帮你切换配置不是绕过配置。切换完后回到 Claude Code新开一轮对话再运行/doctor看模型和 Skill 是否都正常。若出现 401先检查 Key 是否多了空格或换行若出现 404检查ANTHROPIC_BASE_URL是否误写成带尾斜杠或额外路径。本文统一要求是https://taotoken.net/api。这里要特别强调Claude Code 用ANTHROPIC_*但 Codex 不要套这套变量。两者配置格式不同混用会导致 Codex 读不到 Key或者把请求发到错误端点。5. Codex 用 config.toml不是 ANTHROPIC_*Codex 应该改config.toml通常放在~/.codex/config.toml。示例配置如下model_provider taotoken model 在 TaoToken 控制台复制的模型 ID [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api chat然后在本地设置环境变量。Windows PowerShell 当前会话可以用$env:TAOTOKEN_API_KEYYOUR_API_KEY如果希望持久化可以用setx TAOTOKEN_API_KEY YOUR_API_KEYmacOS 或 Linux 可以这样export TAOTOKEN_API_KEYYOUR_API_KEY设置完后新开终端执行codex如果 Codex 报鉴权失败先看config.toml里的env_key是否和实际环境变量名完全一致。上面写的是TAOTOKEN_API_KEY环境变量也要叫这个名字。不要写成ANTHROPIC_AUTH_TOKENCodex 不认这套。Skill 安装也要对应 Codex 的目录$CODEX_HOME/skills/wechat-miniprogram-prompts/在 Windows 上可以用下面命令检查文件是否存在Get-ChildItem $env:USERPROFILE\.codex\skills\wechat-miniprogram-prompts如果$CODEX_HOME已经自定义就把路径换成Get-ChildItem $env:CODEX_HOME\skills\wechat-miniprogram-prompts确认能看到SKILL.md和templates.md后下一轮 Codex 对话就能触发 Skill。你可以直接说“我想做一个记账小程序”观察它是否先进入 01 需求拆解而不是直接改文件。6. 财务工具小程序实战从“我想做”到提审自查的逐页生成下面用一个连贯案例看 Skill 怎么影响 Agent 行为。注意重点不是背模板全文而是看每一步的输入、路由和产出。第 1 步只有模糊想法。你说我想做一个财务工具小程序Skill 识别为 01 需求拆解。Agent 不会直接写页面而是先追问目标用户是谁核心问题是记账、预算还是报表个人主体还是企业主体是否使用云开发第一版最想保留的 1 到 2 个功能是什么。这个阶段会消耗 Token但能避免后面大改。第 2 步补充信息。你回复目标用户是个人痛点是记账流程太长不接云开发第一版只保留快速记账和月度统计。Agent 会输出一个结构化结果【选用模板】01 需求拆解 【可直接复制的提示词】已填好项目名称、用户、核心痛点、MVP 范围 【注意事项】不要一上来就说“帮我做一个小程序” 【下一步建议】需求确定后进入 02 页面结构你把提示词交给模型执行拿到功能清单、页面规划和 MVP 建议。这里仍然建议先复制提示词而不是让 Agent 直接改项目。第 3 步需求定了搭页面骨架。你说给 pages/index/index 设计页面结构Skill 路由到 02并提醒你一次只做一个页面别让它同时改app.json加三个页面。这就是标题里说的“app.json 别同时改”。页面结构阶段只处理当前页全局配置留到明确需要时再动。第 4 步实现单一功能。你说实现新增一笔支出的功能Skill 路由到 03生成的提示词自带验收标准主路径可走通异常有提示不破坏已有功能。你仍然要当 QA自己点一遍。Skill 不会替你省略真机测试。第 5 步出问题了。保存按钮没反应真机报TypeError: Cannot read property amount of undefinedSkill 路由到 04并强调报错全文、复现步骤、相关页面、数据初始值都要给完整别只说“坏了帮我修”。你可以这样组织页面pages/add/add 操作输入金额后点保存 预期写入本地存储并返回首页 实际按钮无反应 真机报错TypeError: Cannot read property amount of undefined 相关文件pages/add/add.js, pages/add/add.wxml第 6 步准备上线。功能差不多完成后进入 05 合规检查重点看类目、隐私、个人主体限制。准备提审时进入 06 提审自查检查主功能是否可用、真机测试路径是否完整、行动清单是否逐条打勾。提醒一句清单打勾后自己再用手机走 3 遍主路径。模板不能代替真机自测。Skill 默认只生成提示词不直接改代码。如果你确实需要开发可以明确说“直接帮我改这个页面”但三条原则和模板约束仍然生效尤其是一次只改一个页面。7. 安装后最常遇到的 6 个问题与修复第一个问题/doctor不识别 Skill。先检查 Claude Code 目录ls .claude/skills/wechat-miniprogram-prompts如果为空重新复制SKILL.md和templates.md。如果目录名被改成别的斜杠命令也会变建议改回wechat-miniprogram-prompts。第二个问题Cursor 不触发 Skill。安装后要重启 Cursor或至少新开一轮 Agent 对话。项目级路径是项目根/.cursor/skills/wechat-miniprogram-prompts/不要放进skills-cursor。第三个问题Codex 读不到 Key。检查~/.codex/config.toml里的env_key TAOTOKEN_API_KEY再检查终端是否真的有这个环境变量echo $env:TAOTOKEN_API_KEY第四个问题Claude Code 报 404 或连接错误。把ANTHROPIC_BASE_URL改回https://taotoken.net/api不要加尾斜杠不要凭感觉加多余路径。Key 用YOUR_API_KEY替换。第五个问题CC Switch 改错端。Claude Code 走settings.json和ANTHROPIC_*Codex 走config.toml和TAOTOKEN_API_KEY。不要把 Claude Code 的变量复制进 Codex。第六个问题真机仍然报TypeError: Cannot read property amount of undefined。回到 Skill 04 路由补全报错、复现步骤和页面数据初始值。不要在同一个请求里同时改app.json、首页和新增页。先修一个点再验证一个点。8. 文末 CTA模型对话 → Coding Plan → 创建 Key → Claude Code 文档如果你只想先验证 Skill 生成提示词的效果可以按这个顺序走先用模型对话跑一条“我想做一个财务工具小程序”看 Skill 是否进入 01 需求拆解https://taotoken.net/models/detail/chat?utm_sourcetaotoken_aicg_blog_endutm_contentblog_skill_chat跑通后如果你准备把 Cursor、Codex、Claude Code 的日常开发都接上可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentblog_skill_plan创建并管理 API Key替换配置里的YOUR_API_KEYhttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentblog_skill_keysClaude Code 的settings.json、ANTHROPIC_*和 CC Switch 配置参考 Claude Code 文档https://taotoken.net/doc/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_contentblog_skill_claude_docTaoToken 官网入口也放在这里方便你统一查看模型、Key 和控制台https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentblog_skill_footer最后建议安装完wechat-miniprogram-prompts后新开一轮对话说一句“我想做一个 XX 小程序”看 Agent 是先追问阶段还是直接改app.json。如果它开始逐页生成、提醒你一次只做一个页面并能在报错时要求完整复现步骤这套 Skill 就已经跑起来了。
