ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

个人开发者做小程序,Agent 的 Skill 流程接口选 TaoToken

个人开发者做小程序,Agent 的 Skill 流程接口选 TaoToken 1. 从 Claude Code 的一次返工说起Skill 是 Agent 的可加载说明书在 Claude Code 里让 Agent 给「随手记一笔」小程序补删除确认时它又把验收标准重问了一遍还顺手改了首页样式。问题不在模型能力而在每次任务都从零口述。把重复流程写成 Skill并把接口切到 TaoTokenhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentskill-introBase URL 设为 https://taotoken.net/api是我这轮最省返工的改动。个人开发者做工具小程序重复劳动比想象多拆需求、搭页面、修 Bug、提审前自查。这些流程每次都靠聊天框临时描述模型会反复确认Token 也会在来回拉扯里消耗。Skill 的价值不是让模型变聪明而是把已经验证过的步骤、边界和验收标准固定下来。TaoToken 在这套流程里提供统一的模型接口让 Agent 在 Claude Code、Codex 或 CC Switch 里都能指向同一个 Base URL。Skill 可以理解成给 Agent 用的可加载专项说明书。它不是新模型也不是换皮聊天框。更准确地说模型负责推理Agent 负责调工具和推进任务Skill 负责把某类任务的标准动作固化。三层对照层作用在小程序开发里的表现模型推理、判断理解需求、定位报错、生成方案Agent调工具、改文件、推进任务读项目、改页面、跑检查Skill固化的专项流程提审自查清单、修 Bug 复现步骤、页面组件规范容易混淆的三个词也要划清。普通提示词是这次粘进对话框的一段话用完就散很难留版本。Skill 在提示词外面多了结构通常包含触发时机、适用边界、步骤和输出格式能装、能复用、能改。插件、MCP、工具更偏“能不能碰到能力”Skill 管的是“碰到之后按什么标准做”。收一句工具决定手能伸多远Skill 决定手按什么规矩干活。为什么个人做小程序特别需要因为同功能问到第二遍、第三遍额度就在烧。把验收标准写成 SkillAgent 可以按清单自检再交差你更多是在验收而不是反复当人形说明书。尤其是提审前自查遗漏一条命名或类目说明可能就要多等一轮审核。Skill 把“怎样算过”写清楚Agent 才有机会在提交前自己发现缺口。2. TaoToken 接入前的准备Base URL、Key 与不要套错变量先到 TaoToken 官网获取 Keyhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentapi-key-setup 。拿到 Key 后统一使用 Base URLhttps://taotoken.net/api本文所有配置里的 Key 占位符都写作YOUR_API_KEY实际使用时替换成控制台创建的 Key。不要把它提交到公开仓库也不要写进前端代码。个人开发者常用做法是放在本地环境变量或工具私有配置里。这里有一个高频坑不同工具的配置变量不一样。Claude Code 走ANTHROPIC_*环境变量Codex 走config.tomlCC Switch 需要填三件套。不要把ANTHROPIC_BASE_URL或ANTHROPIC_API_KEY套到 Codex 配置里Codex 不读这套变量配了也不会生效反而容易误判为 Key 无效。准备阶段建议做三件事在 TaoToken 控制台创建一个专用 Key按项目区分方便后续排查额度消耗。确认 Base URL 是https://taotoken.net/api不要额外拼接/v1、/chat/completions等路径除非你使用的工具明确要求。在 Claude Code、Codex、CC Switch 里分别配置不要共用一份变量名。如果你还没决定用哪个模型可以先到模型对话页做几轮小程序需求拆解观察不同模型对验收标准的理解差异。文末会按顺序给出模型对话、Coding Plan、创建 Key 和 Claude Code 文档入口。3. Claude Code settings.json 可复制配置让 Agent 先读 SKILL.mdClaude Code 的配置可以放在settings.json里。下面是一份最小示例把 Base URL 指向 TaoTokenKey 用占位符代替{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: YOUR_API_KEY, ANTHROPIC_MODEL: claude-sonnet-4-5 } }实际模型名以 TaoToken 控制台当前可用列表为准。配置完成后在项目里触发一次简单对话确认没有 401 或 404。如果出现 401优先检查 Key 是否替换成了真实值如果出现 404检查 Base URL 是否多写了路径如果模型名报错回到控制台复制可用模型 ID。接下来是 Skill 的放置心智。不同编辑器或 Agent 工具对 Skill 的目录要求会变不必先死记某家产品的完整规范。你只要记住Skill 通常以文件夹形式存在里面有一份SKILL.md作为说明书首页。Claude Code 的当期目录要求请以你安装的版本为准本文给出的是通用骨架。一个常见流程是在任务描述里写明“先读skills/miniprogram-review/SKILL.md再按其中清单执行”。这样 Agent 不是直接开始改代码而是先加载说明书再进入步骤。对于提审自查、修 Bug、页面规范这类重复任务这一步能明显减少“它以为它懂了”的情况。如果你希望 Agent 在修改页面前先确认范围可以在配置或提示词里加一条约束涉及删除、支付、用户数据、提审信息的改动必须先输出计划并等待确认。Skill 不是权限放大器它只是流程说明书。重要操作仍然要自己确认。4. Codex config.toml 与 CC Switch 三件套不同工具分开配Codex 使用config.toml下面是可复制示例model gpt-5-codex model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY这里的环境变量是TAOTOKEN_API_KEY不是ANTHROPIC_API_KEY。设置方式由你本地终端决定例如在本地 shell 中导出export TAOTOKEN_API_KEYYOUR_API_KEY注意不要把这行命令提交到仓库也不要在公共 CI 日志里打印。Codex 的配置和 Claude Code 分开维护两个项目可以共用同一个 TaoToken Key但变量名不要混。CC Switch 可以理解为多配置切换工具核心是三件套Provider Name: TaoToken Base URL: https://taotoken.net/api API Key: YOUR_API_KEY Model: 按控制台可用列表选择不同工具的配置对比如下工具配置文件/位置关键字段常见错误Claude Codesettings.jsonANTHROPIC_BASE_URL、ANTHROPIC_API_KEY把 Codex 变量写进来Codexconfig.tomlbase_url、env_key误用ANTHROPIC_*CC Switch图形界面或配置项Base URL、API Key、Model漏填模型名或填错路径配好之后建议先用一个最小任务验证让 Agent 解释一段小程序报错或让它列出一个页面的验收清单。确认接口通、模型可用再进入 Skill 流程。这样排障范围小不会把配置问题和 Skill 问题混在一起。5. SKILL.md 骨架以「随手记一笔」小程序为例下面是一份可直接抄的迷你 Skill 骨架用「随手记一笔」做占位。它不依赖特定编辑器先写成人类可读的说明书再按你所用工具的要求转换成它认的SKILL.md格式。# 小程序提审自查 Skill ## 名称 随手记一笔-提审前自检 ## 适用场景 当「随手记一笔」小程序完成一轮修改准备提交审核前使用本 Skill 做范围核对和主路径自检。 ## 触发词 提审自查、审核前检查、发布前走查 ## 步骤 1. 核对第一版范围只做记录、列表、删除改不做支付、社交、电商。 2. 在真机走主路径新建一条记录、返回列表、删除记录。 3. 记录异常白屏、无响应、错文案、按钮遮挡。 4. 按未通过条目逐条修复修复后重走同一路径。 5. 核对小程序名称、类目、简介是否与实际功能一致。 ## 禁止 - 没有写清通过标准就宣布完成。 - 顺手修改无关页面。 - 用“感觉差不多”代替检查清单。 ## 输出格式 - 已通过 - 未通过每条附复现步骤 - 建议下一轮只改这份骨架的重点不是写得漂亮而是把“怎样算过”写清楚。没有 Skill 时验收标准每次都要重新念一遍有这份说明书后Agent 可以按清单自检再交差你更像在验收而不是反复当人形说明书。还可以按同样方法做第二个 Skill修 Bug 复现。骨架可以包含报错原文、复现路径、影响页面、禁止顺手重构、修复后回归范围。第三个 Skill 可以是页面组件规范按钮尺寸、间距、空状态、删除确认文案。高频场景先做一两个不要一次堆十几个。6. Skill 流程清单哪些步骤读 SKILL.md哪些只走接口这一节给出可复现产出一份 Skill 流程清单标注每个阶段是否加载SKILL.md以及是否直接调用模型接口。你可以把它贴到项目 README 或任务看板里。阶段是否读 SKILL.md是否调接口产出需求拆解是是范围清单、验收标准、不做的功能页面搭建是是页面结构、组件代码、空状态接口联调否涉及错误处理时读是字段说明、mock 数据、错误文案修 Bug是是复现步骤、修复记录、回归范围提审自查是否或少量自查报告、未通过条目文案润色否是标题、按钮、提示文案用户反馈分类否是标签、优先级、建议版本复盘是是Token 消耗、返工点、下轮改进解释一下边界读SKILL.md任务有固定流程、验收标准、禁止事项、输出格式时先加载说明书。比如需求拆解、页面搭建、修 Bug、提审自查、版本复盘。只走接口一次性、低风险、不需要固定流程的任务直接调用模型接口。比如文案润色、用户反馈分类、简单报错解释、字段名建议。混合模式先读SKILL.md再调接口执行。比如修 Bug先按说明书走复现步骤再让模型分析日志或生成修复方案。这个清单的好处是让 Token 花在关键处。拆需求和提审自查值得加载 Skill因为遗漏成本高文案润色和简单问答可以只走接口减少不必要上下文。你可以在 TaoToken 控制台按项目查看 Key 的消耗再根据清单调整哪些阶段需要更完整的 Skill。一个实际例子让 Agent 修「删除后列表未刷新」的 Bug。如果只走接口它可能直接改列表刷新逻辑但没走删除确认路径。如果先读SKILL.md它会先按复现步骤确认删除前状态、删除后状态、返回路径再定位问题。修复后还要走同一路径回归。这样返工更少Token 也不会花在反复解释验收标准上。7. 避坑弱模型、过时说明书、Skill 堆叠、权限边界第一条Skill 救不了弱模型。模型本身推理能力不足时说明书再漂亮也会执行歪。Agent 的调度能力再强最终判断仍依赖模型。所以选模型时不要只看价格至少在小程序需求拆解和 Bug 定位上做一轮对比。第二条过时说明书等于教坏 Agent。小程序规则、接口字段、提审口径都会变。今天写的类目说明下个月可能就不适用。Skill 要跟着改最好在每次提审后复盘一次把新增的坑写回SKILL.md。第三条别堆太多 Skill。Skill 太多可能抢触发Agent 不知道该加载哪一份。高频场景先做一两个比如提审自查和修 Bug 复现。等这两个稳定后再扩展页面规范、接口联调、文案检查。第四条权限留一手。Skill 不等于可以乱删库、乱提权、乱改生产配置。涉及删除数据、修改支付、发布审核的操作必须自己确认。Agent 可以生成命令和计划但执行权在你手里。SQL 和命令都由读者在本地环境执行不要让 Agent 直连生产库。还有一个实际坑不要把同一份 Key 暴露在多个工具里且不做区分。建议按项目或按工具创建 Key例如claude-code-local、codex-local、cc-switch-local。这样出现异常消耗时能快速定位是哪个工具或哪个 Skill 流程在调用。8. 文末 CTA模型对话 → Coding Plan → 创建 Key → Claude Code 文档总结一下模型是推理层Agent 是执行层Skill 是把执行标准固化的说明书。个人开发者做工具小程序拆需求、搭页面、修 Bug、提审自查都会消耗 Token。把重复流程写成 Skill再通过 TaoToken 统一 Base URL 和 Key可以让 Agent 在 Claude Code、Codex、CC Switch 里稳定工作。推荐按下面路径开始先到模型对话页做几轮需求拆解确认模型对小程序验收标准的理解https://taotoken.net/models/detail/chat?utm_sourcetaotoken_aicg_blog_endutm_contentskill-flow-chat如果准备把 Agent 接入日常开发查看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentskill-flow-plan创建自己的 API Key替换本文中的YOUR_API_KEYhttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentskill-flow-keysClaude Code 用户参考文档完成settings.json配置https://taotoken.net/doc/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_contentskill-flow-claude-doc需要统一入口时也可以先访问 TaoToken 官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentfinal-cta先把一个高频场景固化成 Skill比如提审自查。跑通一轮后再扩展第二个。Base URL 保持https://taotoken.net/apiKey 用YOUR_API_KEY占位不同工具分开配置。这样你的小程序开发流程会从“反复解释”变成“按清单验收”Token 也花得更值。
返回列表