企业官网建设流程全解析

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_source=taotoken_aicg_blog_end&utm_content=blog_skill_intro 。Base URL 统一用https://taotoken.net/api，Key 先用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 个阶段可以压缩成下面这张表：

推荐顺序是01 → 02 → 03 →（04 按需）→ 05 → 06。这个顺序最重要的作用是防止跳步。你还在 01 阶段，就不要让 Agent 改app.json；你在 02 阶段，也应该一次只设计一个页面，不要让它同时改全局配置和三个页面文件。

Skill 里还会强调三条原则：一次只推进一个页面；报错必须给完整上下文和复现步骤；模板不能替代真机自测。尤其第三条，很多开发者会忽略。Agent 可以帮你生成提示词、整理功能清单、提醒合规点，但真机上按钮能不能点、支付路径能不能走、隐私弹窗是否出现，仍然要你自己走一遍。

这里已经开始消耗模型 Token：Skill 路由、追问、生成填好占位符的提示词，都会调用模型。所以安装后首次调用前，建议先去 TaoToken 官网取 Key：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=blog_skill_files 。拿到后替换YOUR_API_KEY，Base 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.ps1

Cursor 的安装路径可以按个人级或项目级选择：

个人级：~/.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-prompts

Claude 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-prompts；SKILL.md是否在目录根层；templates.md是否缺失。不要急着改 SKILL 内容，先把文件位置放对。

4. TaoToken 接管模型调用：Claude Code 的 settings.json 与 ANTHROPIC_*

安装 Skill 只是让它能被 Agent 发现，真正生成提示词时还要有模型调用通道。首次调用模型前，去 TaoToken 官网创建 Key：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=blog_skill_key_setup 。把拿到的 Key 替换成YOUR_API_KEY，Base 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 管理多套模型配置，记住三件套：

1. Base URL：https://taotoken.net/api
2. API Key：YOUR_API_KEY
3. 模型 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_KEY="YOUR_API_KEY"

如果希望持久化，可以用：

setx TAOTOKEN_API_KEY "YOUR_API_KEY"

macOS 或 Linux 可以这样：

export TAOTOKEN_API_KEY="YOUR_API_KEY"

设置完后新开终端，执行：

codex

如果 Codex 报鉴权失败，先看config.toml里的env_key是否和实际环境变量名完全一致。上面写的是TAOTOKEN_API_KEY，环境变量也要叫这个名字。不要写成ANTHROPIC_AUTH_TOKEN，Codex 不认这套。

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 undefined

Skill 路由到 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 生成提示词的效果，可以按这个顺序走：

1. 先用模型对话跑一条“我想做一个财务工具小程序”，看 Skill 是否进入 01 需求拆解：
   https://taotoken.net/models/detail/chat?utm_source=taotoken_aicg_blog_end&utm_content=blog_skill_chat

2. 跑通后，如果你准备把 Cursor、Codex、Claude Code 的日常开发都接上，可以看 Coding Plan：
   https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=blog_skill_plan

3. 创建并管理 API Key，替换配置里的YOUR_API_KEY：
   https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=blog_skill_keys

4. Claude Code 的settings.json、ANTHROPIC_*和 CC Switch 配置，参考 Claude Code 文档：
   https://taotoken.net/doc/ClaudeCodeAnthropic?utm_source=taotoken_aicg_blog_end&utm_content=blog_skill_claude_doc

TaoToken 官网入口也放在这里，方便你统一查看模型、Key 和控制台：
https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=blog_skill_footer

最后建议：安装完wechat-miniprogram-prompts后，新开一轮对话，说一句“我想做一个 XX 小程序”，看 Agent 是先追问阶段，还是直接改app.json。如果它开始逐页生成、提醒你一次只做一个页面，并能在报错时要求完整复现步骤，这套 Skill 就已经跑起来了。