0基础入门！用 TaoToken 写一个 skill 调教你的 AI

1. 为什么你需要给 AI 写一份「skill 小抄」你有没有过这种体验让 AI 帮你写周报每次都要重复交代「分三段、每段 5 条、结尾带一句总结」让 AI 帮你格式化 Git 提交信息每次都要把规范重新贴一遍让 AI 帮你出小红书文案每次都要说「开头抓眼球、中间给干货、结尾留钩子」。说一次两次还行说十次二十次你自己都烦。问题的根源不在于 AI 笨而在于你没把「重复交代的东西」固化下来。skill 就是干这个的——它本质上是一份写给 AI 的「小抄」把角色定位、触发条件、输出格式、示例全部写清楚让 AI 一看就懂、一用就准。你不需要是程序员也不需要懂什么智能体框架只要会写清楚一段说明文字就能做出一个能反复用的 skill。这篇面向零基础开发者聚焦一件事用统一的 Key/API 通道 TaoToken 作为底座为你的 AI 工具编写自定义 skill并交付可复制的配置文件骨架含settings.json与config.toml示例最后触发一次 skill 调用、检查返回结果确认调教生效。适合谁适合所有被「每次都要重新交代一遍」折磨过的人以及想用一套 Key 打通多个 AI 工具、不想在多个平台之间来回切换的开发者。2. TaoToken 前置统一 Key 与 API 通道是什么在写 skill 之前先解决一个现实问题你手头可能有好几个 AI 工具每个工具都要单独配 Key、单独记地址、单独管额度。写一个 skill 想跨工具复用光配置就能耗掉半天。TaoToken 在这里扮演的角色是一个统一的 Key/API 通道——你申请一次 Key就能通过同一个 API 地址调用多种模型skill 配置文件里只需要维护一份凭证。官网入口在这里https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。API 基础地址是 https://taotoken.net/api 这个地址不加 UTM 参数配置时直接用。你需要提前准备的东西只有两样一个 TaoToken 账号以及一把 API Key。Key 在控制台的 API Keys 页面创建创建后复制保存后面写进配置文件里。这里要提醒一句Key 等同于密码不要提交到公开仓库也不要贴在聊天记录里。建议放在环境变量或者本地配置文件里用.gitignore排除掉。注意skill 的配置文件里只放 Key 的引用比如环境变量名不要把 Key 明文写死。后面给的settings.json和config.toml示例都会用环境变量占位。拿到 Key 之后先别急着写 skill。你可以先去模型对话页面发一条消息确认 Key 能正常用、额度没问题。这一步花不了一分钟但能帮你排除掉后面 80% 的「配置没错但就是不通」的困惑。模型对话入口https://taotoken.net/api?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。3. 可复制配置skill 配置文件骨架现在进入正题。一个 skill 的配置文件核心就两块一块告诉工具「用哪个 API、用哪把 Key」另一块告诉 AI「你是谁、什么时候用、怎么输出」。前者是settings.json后者是 skill 的正文通常放在SKILL.md或者config.toml的 prompt 字段里。先建目录结构。建议这样组织my-skill/ ├── settings.json ├── config.toml └── SKILL.mdsettings.json负责通道配置示例{ provider: taotoken, api_base: https://taotoken.net/api, api_key_env: TAOTOKEN_API_KEY, model: claude-sonnet, timeout_seconds: 60, max_retries: 2 }这里api_key_env写的是环境变量名不是 Key 本身。你在终端里这样设置export TAOTOKEN_API_KEY你的KeyWindows PowerShell 用$env:TAOTOKEN_API_KEY你的Keyconfig.toml负责 skill 的行为定义示例[skill] name git-commit-fmt description 把口语化描述转成 Conventional Commits 格式的提交信息 trigger 当用户提到提交信息、commit、git 提交或贴出一段口语化的代码改动描述时主动使用本 skill model claude-sonnet temperature 0.2 [skill.output] format type(scope): subject max_subject_length 50 lowercase true [skill.rules] types [feat, fix, docs, style, refactor, test, chore] verb_form 原形 no_explanation trueSKILL.md是给 AI 看的正文把角色、任务、触发条件、规则、输出格式、示例写清楚# 角色 你是 Git Commit Message 格式化助手。 # 任务 把用户输入的口语化代码改动描述转换成 Conventional Commits 格式。 # 触发条件 当用户提到「提交信息」「commit message」「git 提交」 或贴出一段口语化的代码改动描述时主动使用本 skill 即使用户没有明确点名也要主动使用。 # 规则 - type 必须从 feat/fix/docs/style/refactor/test/chore 中选一个 - subject 不超过 50 字符全部小写专有名词除外 - 用动词原形开头如 add / fix / update - 只输出一行 commit message不要解释不要 markdown 包裹 # 示例 示例 1 输入我把登录页面加上了忘记密码的链接 输出feat(auth): add forgot password link on login page 示例 2 输入修复了首页轮播图在 Safari 上不滚动的问题 输出fix(homepage): carousel not scrolling on safari 示例 3 输入把 README 里的安装步骤更新成最新版本 输出docs: update installation steps in readme三个文件的分工很清晰settings.json管通道config.toml管参数SKILL.md管行为。你换一个 skill只需要改后两个通道配置不用动。这就是统一 Key 通道的价值——skill 可以随便加Key 只维护一份。4. 验证请求触发一次 skill 调用并检查返回配置写完必须验证。不验证的 skill 等于没写。验证分两步先确认通道通再确认 skill 生效。第一步用 curl 直接打一次 API确认 Key 和地址没问题curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-sonnet, messages: [ {role: system, content: 你是 Git Commit Message 格式化助手。把口语化描述转成 type(scope): subject 格式只输出一行。}, {role: user, content: 我刚才把购物车页面的删除按钮颜色从灰色改成了红色而且加了二次确认弹窗} ], temperature: 0.2 }如果返回里能看到类似feat(cart): change delete button color and add confirmation的内容说明通道和 prompt 都通了。如果返回 401检查 Key 有没有设对返回 404检查地址是不是https://taotoken.net/api返回超时检查网络和timeout_seconds。第二步把 skill 装进你的工具里触发一次真实调用。以支持 skill 目录的工具为例把my-skill/放到工具的 skills 目录下重启工具然后输入帮我写个 commit message我把用户头像上传的大小限制从 2MB 改成了 5MB预期返回feat(upload): increase avatar size limit to 5mb检查三件事格式对不对有没有type(scope): subject、有没有多余解释应该只有一行、大小写和动词形式对不对increase不是increased。三项都过skill 就算调教生效了。如果格式对但带了「好的这是您的 commit message」这种前缀说明no_explanation规则没被遵守回去把SKILL.md里的「只输出一行不要解释」再强调一遍并补一个反例。5. 本篇常见错排查配置 skill 最容易踩的坑我按出现频率排一下。Key 没生效最常见的是环境变量没导出或者导出后没重启终端/工具。settings.json里写的是api_key_env工具读的是环境变量不是文件里的值。验证方法在终端echo $TAOTOKEN_API_KEY看有没有输出。地址写错API 地址是https://taotoken.net/api不要多加/v1之外的路径也不要把官网地址当成 API 地址。官网是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 是https://taotoken.net/api两者别混。触发条件没写很多人以为创建了 skillAI 就会自动用。实际上触发是要明说的。trigger字段里一定要写清楚「什么样的输入该用这套规则」并加一句「即使用户没明确点名也要主动使用」。示例太单一三个示例全是修 bugAI 就以为这个 skill 只能修 bug。示例要覆盖不同场景——新功能、修 bug、文档更新各来一个AI 才能学会泛化。规则太抽象写「输出要专业」等于没写。要写「subject 不超过 50 字符全部小写动词原形开头」。能给模板就给模板能给字段就给字段。prompt 太长超过 1500 字AI 容易「看后忘前」。长内容拆到SKILL.md的附录或者知识库里主 prompt 保持精简。不测试就上线写完至少拿 3 到 5 个真实场景测一遍。80% 的「AI 不听话」其实是 prompt 没写清楚。提示排障时优先看返回的 HTTP 状态码和错误信息比盲目改配置快得多。接入相关的文档在 https://taotoken.net/api?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content Key 管理在 https://taotoken.net/api?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。6. 把 skill 用起来从单次调用到长期编码skill 调通之后真正的价值在于「反复用」。你写一个 commit 格式化 skill以后每次提交都不用再想格式你写一个周报 skill每周五直接丢给 AI 就行。skill 越多你重复交代的次数越少。如果你只是偶尔用一下模型对话页面就够了https://taotoken.net/api?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你要把 skill 接进日常编码流程比如让 AI 在写代码时自动遵守你的规范那更适合用 Coding Plan把 skill 和编码工作流绑在一起https://taotoken.net/api?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。长期跑 Agent 任务的话Coding Plan 的额度模型比单次调用更划算。最后说一个我自己的经验skill 不要一次写太大。先写一个只做一件事的小 skill跑通、验证、用顺再往上加规则。一个能稳定输出一行 commit message 的 skill比一个「什么都能干但什么都不精」的万能助手有用得多。你写完第一个 skill 之后会发现脑子里那些模糊的流程被迫写清楚了——这个副作用比省下的重复劳动更值钱。