1. 从一段反复改到崩溃的 Prompt 说起如果你正在做 Agent 开发大概率经历过这个场景一段系统提示改了十几版每加一个工具调用规则就要重新测一遍模型偶尔还会把前面定好的输出格式忘掉。到了 2026 年Anthropic 把 Skills 体系推到台前后越来越多团队开始把「怎么完成任务」这件事从自然语言提示里抽出来写成一份结构化的 SKILL.md。它是什么简单说就是把任务目标、前置条件、执行步骤、工具调用时机、输出格式写成一份声明式文件Agent 按需读取、按步执行。适合谁适合正在做多步骤 Agent、需要团队协作维护提示逻辑、又不想每次换模型就重写一遍的开发者。Prompt 的问题不在于写得不好而在于它天生是「一次性对话」的形态上下文一长就漂移换个人接手就看不懂跨平台迁移基本等于重写。Skills 把这些问题拆开解决——渐进披露减少无效上下文文件化让它可以进 Git 做 Code Review结构化声明让工具调用和停止条件变得可审计。这篇不聊概念史直接给你一份可复制的 SKILL.md 骨架再配上用 TaoToken 统一 Key 跑通调用链的完整配置最后在 Cline 里加载验证看 Prompt 退场之后整条链路是不是真的走通了。2. TaoToken 前置一把 Key 打通 Skill 的模型调用Skill 本身只是行为规范真正执行时还是要落到模型 API 上。这里我用 TaoToken 做统一入口原因是它把 Anthropic 系模型和常见编码模型的调用收敛到同一个 Key 和同一个 Base URL 下SKILL.md 里声明的模型名不用跟着平台换来换去。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后在控制台生成 Key 即可。需要提前准备的东西不多一个 TaoToken 账号、一把 API Key、本地装好 ClineVS Code 插件即可。API 地址统一用 https://taotoken.net/api 注意这个地址后面不加任何查询参数Key 走 Authorization 头传递。如果你还没生成 Key直接进控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 创建建议按项目分 Key方便后面排查是哪个 Skill 在消耗额度。注意SKILL.md 里不要硬编码 Key。Key 属于运行时配置应该放在 Cline 的 provider 设置或环境变量里SKILL.md 只声明「需要调用哪个模型、传什么参数」。3. 可复制的 SKILL.md 骨架下面这份骨架是我实测下来比较稳的结构字段命名尽量贴近 Anthropic Skills 的惯例同时留了扩展位。你可以直接复制成一个SKILL.md文件放在项目根目录的.skills/下。--- name: monthly-report-builder description: 根据清洗后的数据生成月度分析报告输出固定 JSON 结构 version: 1.0.0 model: claude-sonnet-4-20250514 tools: - read_file - run_sql - write_file --- # 任务目标 读取指定月份的数据表完成聚合分析输出一份结构化报告。 ## 前置条件 - 数据表已完成清洗字段包含 date、amount、category - 调用方需提供 month 参数格式 YYYY-MM - 若数据行数为 0直接返回空报告不进入分析步骤 ## 执行步骤 1. 校验 month 参数格式不合法则终止并返回错误码 E_PARAM 2. 调用 run_sql 拉取该月数据限制返回 10000 行以内 3. 按 category 分组求和计算环比 4. 若某分类环比波动超过 50%标记为异常项 5. 调用 write_file 输出报告路径为 reports/{month}.json ## 工具调用规则 - run_sql 仅在步骤 2 调用一次禁止在循环中重复查询 - write_file 失败时重试一次仍失败则返回 E_IO ## 输出格式 json { month: 2026-01, total: 0, categories: [], anomalies: [] }异常分支数据缺失返回 E_DATA附带缺失字段名超时返回 E_TIMEOUT不重试这份骨架的关键在于「渐进披露」Agent 先读 frontmatter 知道这个 Skill 干什么、用什么模型、有哪些工具进入执行步骤后才展开具体规则异常分支只在触发时才加载。相比把这一整套塞进系统提示上下文占用能压下来一大截。 ## 4. 在 Cline 中加载 Skill 并验证调用链 Cline 目前对 Skills 的支持是通过自定义指令加文件读取实现的。先在 VS Code 设置里把 provider 指向 TaoToken json { cline.apiProvider: openai, cline.openAiBaseUrl: https://taotoken.net/api, cline.openAiApiKey: sk-你的TaoToken密钥, cline.openAiModelId: claude-sonnet-4-20250514 }保存后重启 Cline。接着在项目里新建.skills/monthly-report-builder/SKILL.md把上一节的骨架贴进去。然后在 Cline 对话框里发一条指令让它读取这个 Skill 并执行读取 .skills/monthly-report-builder/SKILL.md 按其中的执行步骤处理 month2026-01 的数据 数据源用本地 data/2026-01.csv。Cline 会先读 SKILL.md解析 frontmatter 里的 model 和 tools然后按步骤调用。实测下来它会在步骤 2 触发一次文件读取或 SQL 调用步骤 5 写出reports/2026-01.json。如果输出文件里categories数组有内容、anomalies字段存在说明整条链路走通了。想单独验证模型侧是否正常可以先用模型对话 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 发一条测试请求确认 Key 和模型名没问题再回到 Cline 里跑 Skill。如果你打算长期跑编码类 AgentCoding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 的额度模型更适合高频调用场景。5. 本篇常见错排查报 401 或 invalid api key九成是 Key 没带对或者 Base URL 写成了带路径的形式。确认cline.openAiBaseUrl是https://taotoken.net/api不要加/v1或结尾斜杠。Key 重新在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 生成一次再试。Skill 被读取但没执行步骤检查 SKILL.md 的 frontmatter 是否被正确解析。YAML 里tools必须是数组缩进用两个空格。如果 Cline 只读了文件没往下走通常是description写得太模糊模型判断「不需要执行」把任务目标写具体一点。工具调用报 unknown toolSKILL.md 里声明的工具名要和 Cline 实际暴露的工具名一致。Cline 默认提供read_file、write_file、execute_command等如果你写了run_sql但环境里没有对应工具就会报这个错。要么换成已有工具要么在 Cline 里配置 MCP 补上。输出格式对不上模型可能把 JSON 包在 markdown 代码块里返回。在 SKILL.md 的输出格式段加一句「直接返回 JSON不要包裹代码块」或者在 Cline 侧做一次解析容错。调用链中途断掉多半是上下文超了。Skills 的渐进披露能缓解但如果你的 SKILL.md 本身写了几千行还是会撑爆。把大 Skill 拆成多个小 Skill用组合方式调用。6. 把 Key 和 Skill 分开管后面少踩坑跑通之后你会发现真正需要长期维护的是 SKILL.md 这份文件而不是 Key。Key 属于基础设施换项目、换模型、换平台时只改配置SKILL.md 属于业务资产进 Git、做 Review、打版本号。两者分开之后Prompt 退场就不是一句口号而是你项目里实实在在发生的事——系统提示里不再堆规则只留一句「按 .skills/ 下的定义执行」。接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里有完整的参数说明和错误码对照遇到本文没覆盖的报错可以直接查。如果你用的是 Claude Code 那套工作流Anthropic 兼容入口 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_codeutm_campaignrewrite 也能直接对接SKILL.md 不用改。下一步建议你把手头最长的那段系统提示翻出来挑一个边界最清晰的任务先写成一份 SKILL.md 跑一遍感受一下调用链和输出稳定性的差别。
1. 从一段反复改到崩溃的 Prompt 说起如果你正在做 Agent 开发大概率经历过这个场景一段系统提示改了十几版每加一个工具调用规则就要重新测一遍模型偶尔还会把前面定好的输出格式忘掉。到了 2026 年Anthropic 把 Skills 体系推到台前后越来越多团队开始把「怎么完成任务」这件事从自然语言提示里抽出来写成一份结构化的 SKILL.md。它是什么简单说就是把任务目标、前置条件、执行步骤、工具调用时机、输出格式写成一份声明式文件Agent 按需读取、按步执行。适合谁适合正在做多步骤 Agent、需要团队协作维护提示逻辑、又不想每次换模型就重写一遍的开发者。Prompt 的问题不在于写得不好而在于它天生是「一次性对话」的形态上下文一长就漂移换个人接手就看不懂跨平台迁移基本等于重写。Skills 把这些问题拆开解决——渐进披露减少无效上下文文件化让它可以进 Git 做 Code Review结构化声明让工具调用和停止条件变得可审计。这篇不聊概念史直接给你一份可复制的 SKILL.md 骨架再配上用 TaoToken 统一 Key 跑通调用链的完整配置最后在 Cline 里加载验证看 Prompt 退场之后整条链路是不是真的走通了。2. TaoToken 前置一把 Key 打通 Skill 的模型调用Skill 本身只是行为规范真正执行时还是要落到模型 API 上。这里我用 TaoToken 做统一入口原因是它把 Anthropic 系模型和常见编码模型的调用收敛到同一个 Key 和同一个 Base URL 下SKILL.md 里声明的模型名不用跟着平台换来换去。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后在控制台生成 Key 即可。需要提前准备的东西不多一个 TaoToken 账号、一把 API Key、本地装好 ClineVS Code 插件即可。API 地址统一用 https://taotoken.net/api 注意这个地址后面不加任何查询参数Key 走 Authorization 头传递。如果你还没生成 Key直接进控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 创建建议按项目分 Key方便后面排查是哪个 Skill 在消耗额度。注意SKILL.md 里不要硬编码 Key。Key 属于运行时配置应该放在 Cline 的 provider 设置或环境变量里SKILL.md 只声明「需要调用哪个模型、传什么参数」。3. 可复制的 SKILL.md 骨架下面这份骨架是我实测下来比较稳的结构字段命名尽量贴近 Anthropic Skills 的惯例同时留了扩展位。你可以直接复制成一个SKILL.md文件放在项目根目录的.skills/下。--- name: monthly-report-builder description: 根据清洗后的数据生成月度分析报告输出固定 JSON 结构 version: 1.0.0 model: claude-sonnet-4-20250514 tools: - read_file - run_sql - write_file --- # 任务目标 读取指定月份的数据表完成聚合分析输出一份结构化报告。 ## 前置条件 - 数据表已完成清洗字段包含 date、amount、category - 调用方需提供 month 参数格式 YYYY-MM - 若数据行数为 0直接返回空报告不进入分析步骤 ## 执行步骤 1. 校验 month 参数格式不合法则终止并返回错误码 E_PARAM 2. 调用 run_sql 拉取该月数据限制返回 10000 行以内 3. 按 category 分组求和计算环比 4. 若某分类环比波动超过 50%标记为异常项 5. 调用 write_file 输出报告路径为 reports/{month}.json ## 工具调用规则 - run_sql 仅在步骤 2 调用一次禁止在循环中重复查询 - write_file 失败时重试一次仍失败则返回 E_IO ## 输出格式 json { month: 2026-01, total: 0, categories: [], anomalies: [] }异常分支数据缺失返回 E_DATA附带缺失字段名超时返回 E_TIMEOUT不重试这份骨架的关键在于「渐进披露」Agent 先读 frontmatter 知道这个 Skill 干什么、用什么模型、有哪些工具进入执行步骤后才展开具体规则异常分支只在触发时才加载。相比把这一整套塞进系统提示上下文占用能压下来一大截。 ## 4. 在 Cline 中加载 Skill 并验证调用链 Cline 目前对 Skills 的支持是通过自定义指令加文件读取实现的。先在 VS Code 设置里把 provider 指向 TaoToken json { cline.apiProvider: openai, cline.openAiBaseUrl: https://taotoken.net/api, cline.openAiApiKey: sk-你的TaoToken密钥, cline.openAiModelId: claude-sonnet-4-20250514 }保存后重启 Cline。接着在项目里新建.skills/monthly-report-builder/SKILL.md把上一节的骨架贴进去。然后在 Cline 对话框里发一条指令让它读取这个 Skill 并执行读取 .skills/monthly-report-builder/SKILL.md 按其中的执行步骤处理 month2026-01 的数据 数据源用本地 data/2026-01.csv。Cline 会先读 SKILL.md解析 frontmatter 里的 model 和 tools然后按步骤调用。实测下来它会在步骤 2 触发一次文件读取或 SQL 调用步骤 5 写出reports/2026-01.json。如果输出文件里categories数组有内容、anomalies字段存在说明整条链路走通了。想单独验证模型侧是否正常可以先用模型对话 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 发一条测试请求确认 Key 和模型名没问题再回到 Cline 里跑 Skill。如果你打算长期跑编码类 AgentCoding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 的额度模型更适合高频调用场景。5. 本篇常见错排查报 401 或 invalid api key九成是 Key 没带对或者 Base URL 写成了带路径的形式。确认cline.openAiBaseUrl是https://taotoken.net/api不要加/v1或结尾斜杠。Key 重新在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 生成一次再试。Skill 被读取但没执行步骤检查 SKILL.md 的 frontmatter 是否被正确解析。YAML 里tools必须是数组缩进用两个空格。如果 Cline 只读了文件没往下走通常是description写得太模糊模型判断「不需要执行」把任务目标写具体一点。工具调用报 unknown toolSKILL.md 里声明的工具名要和 Cline 实际暴露的工具名一致。Cline 默认提供read_file、write_file、execute_command等如果你写了run_sql但环境里没有对应工具就会报这个错。要么换成已有工具要么在 Cline 里配置 MCP 补上。输出格式对不上模型可能把 JSON 包在 markdown 代码块里返回。在 SKILL.md 的输出格式段加一句「直接返回 JSON不要包裹代码块」或者在 Cline 侧做一次解析容错。调用链中途断掉多半是上下文超了。Skills 的渐进披露能缓解但如果你的 SKILL.md 本身写了几千行还是会撑爆。把大 Skill 拆成多个小 Skill用组合方式调用。6. 把 Key 和 Skill 分开管后面少踩坑跑通之后你会发现真正需要长期维护的是 SKILL.md 这份文件而不是 Key。Key 属于基础设施换项目、换模型、换平台时只改配置SKILL.md 属于业务资产进 Git、做 Review、打版本号。两者分开之后Prompt 退场就不是一句口号而是你项目里实实在在发生的事——系统提示里不再堆规则只留一句「按 .skills/ 下的定义执行」。接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里有完整的参数说明和错误码对照遇到本文没覆盖的报错可以直接查。如果你用的是 Claude Code 那套工作流Anthropic 兼容入口 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_codeutm_campaignrewrite 也能直接对接SKILL.md 不用改。下一步建议你把手头最长的那段系统提示翻出来挑一个边界最清晰的任务先写成一份 SKILL.md 跑一遍感受一下调用链和输出稳定性的差别。
