1. 从「每周重复交代」到「一句话触发」Agent Skills 到底解决什么问题如果你刚接触 Claude Code大概率经历过这种循环每次让它写周报、整理会议纪要、生成 PPT都要把格式要求、语气偏好、输出结构重新讲一遍。讲完这次下次开新会话又得从头来。这不是你记性不好而是 Claude Code 默认只记得当前上下文跨会话的「个人习惯」需要一种持久化机制来承载。Agent Skills 就是干这个的。你可以把它理解成给 Claude Code 装的一份「技能说明书」把某类任务的执行步骤、参考资料、触发方式打包成一个目录放进指定位置后Claude Code 在遇到匹配场景时会自动加载并执行。它和普通 Prompt 最大的区别在于——Prompt 是一次性的口头交代Skill 是可复用、可版本管理、可分享的文件资产。适合谁用三类人最受益。第一类是每周有固定重复任务的开发者比如写周报、生成接口文档、跑代码审查清单第二类是团队里想把「老员工经验」沉淀下来的技术负责人新人装一个 Skill 就能按统一规范产出第三类是喜欢折腾自动化的人把调用外部 API、生成 pptx 这类操作封装成脚本让 Claude Code 按需触发。这篇是「小白指北」系列的第三篇前两篇讲了基础接入和常用命令。这次我们聚焦落地先讲清 SKILL.md 的结构再给一份可直接复制的配置模板然后完整走一遍「生成 pptx」技能的触发验证。中间会说明如何通过 TaoToken 统一 Key 和 API 通道接入避免多个模型服务来回切换的麻烦。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end API 地址是 https://taotoken.net/api 后面配置里会用到。我试过把周报、PPT 大纲、代码注释规范各做成一个 Skill实测下来最直观的变化是以前每次要写 200 字交代背景现在一句/weekly-report 本周完成3个需求就能跑起来。下面从结构开始拆。2. TaoToken 前置准备统一 Key 与 API 通道让 Skill 调用不迷路在写 SKILL.md 之前得先把「Claude Code 怎么连上模型」这件事理顺。很多小白卡在这一步Skill 写好了触发时却报401或local proxy failed八成是 Key 或 Base URL 没配对。TaoToken 在这里的角色是统一入口。你不需要为每个模型单独记一套地址和密钥而是用同一个 API Key、同一个 Base URL 去访问不同模型。对 Skill 来说这很重要——因为 Skill 里的脚本可能调用不同能力比如文本生成用 A 模型图片生成用 B 模型如果每个都要单独配环境变量维护成本会很高。先拿 Key。打开 https://taotoken.net/api-keys 登录后创建一个 API Key复制保存。注意这个 Key 只在创建时完整显示一次丢了就重新建一个。然后确认你的 Claude Code 配置。Claude Code 读取的是环境变量或配置文件里的 Base URL 和 Key。推荐用配置文件方式路径通常在用户目录下的.claude相关配置里。如果你用的是 settings 形式可以写成这样{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥 } }如果你更习惯用auth.json方式Codex 类工具常见结构类似{ baseURL: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥 }这里三件套要记牢Base URL 填https://taotoken.net/apiKey 填你刚创建的Model ID 按你实际要用的模型填比如claude-sonnet-4-20250514这类具体标识。三者缺一不可少一个就会在请求阶段报错。配置完成后建议先做一次最小验证确认通道是通的curl https://taotoken.net/api/v1/messages \ -H x-api-key: sk-你的TaoToken密钥 \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-20250514, max_tokens: 64, messages: [{role: user, content: 回复 ok}] }返回里能看到content字段且有文本说明 Key 和通道都正常。这一步别跳过后面 Skill 触发失败时你就能快速判断是「通道问题」还是「Skill 本身问题」。关于模型选择和额度可以在 https://taotoken.net/models 查看当前可用列表。如果你打算长期跑编码类 Agent 任务Coding Plan 会更划算入口在 https://taotoken.net/coding-plan 。接入文档在 https://taotoken.net/doc 遇到参数不确定时翻一下比瞎试快。3. 可复制配置SKILL.md 结构拆解与 pptx 技能模板现在进入正题。一个 Skill 的本质是一个目录Claude Code 会在特定路径下扫描它。典型结构长这样my-skill/ ├── SKILL.md ├── reference/ │ └── template.md └── scripts/ └── helper.pySKILL.md是必需的主文档分两部分头部元信息name、description和正文工作流。reference/放参考资料比如模板、语气指南。scripts/放可执行脚本比如调用外部 API 的 Python 文件。先看头部。它用 YAML front matter 写法必须包含name和description--- name: pptx-generator description: 将 Markdown 文章转换为 pptx 演示文稿。当用户要求生成 PPT、演示文稿、slides 时触发。 ---description很关键Claude Code 靠它判断「当前任务该不该调用这个 Skill」。写得太窄会漏触发太宽会误触发。建议把典型触发词写进去比如「生成 PPT」「转成 slides」「做演示文稿」。正文部分就是工作流说明书。用自然语言写清步骤Claude Code 会按这个顺序执行。下面是一份可直接复制的 pptx 技能模板--- name: pptx-generator description: 将 Markdown 文章转换为 pptx 演示文稿。当用户要求生成 PPT、演示文稿、slides 时触发。 --- # PPTX 生成技能 ## 触发条件 用户说「生成 PPT」「转成 slides」「做演示文稿」「把这篇转 PPT」时启用。 ## 执行步骤 1. 读取用户指定的 Markdown 文件若未指定则询问文件路径。 2. 按二级标题##拆分章节每个章节生成一页幻灯片。 3. 每页结构标题取二级标题文本正文取该章节前 3 条要点。 4. 调用 scripts/build_pptx.py 生成文件输出到当前目录。 5. 生成后告知用户文件路径和页数。 ## 参考资料 - reference/slide-style.md幻灯片配色与字体规范 - reference/outline-rules.md大纲拆分规则 ## 注意事项 - 单页正文不超过 5 行超出则拆分为多页。 - 代码块内容单独成页保留等宽字体。reference/slide-style.md可以写你们团队的配色比如主色#1F6FEB、标题字号 28、正文字号 18。scripts/build_pptx.py用python-pptx库实现核心逻辑是读 Markdown、按标题切分、逐页写入。脚本里如果需要调用模型做摘要就用前面配好的 TaoToken 通道把 Base URL 和 Key 从环境变量读进来不要硬编码。把整个pptx-generator目录放到 Claude Code 的 Skill 扫描路径下通常是项目内.claude/skills/或用户级 skills 目录具体以你版本为准。放好后重启会话让 Claude Code 重新扫描。这里提醒一个坑目录名和name字段建议保持一致都叫pptx-generator。不一致时某些版本会以目录名为准导致你按name找找不到。4. 验证请求一次完整的 pptx 技能触发与结果检查配置放好了怎么确认它真的生效分三步走。第一步确认 Skill 被识别。在 Claude Code 里输入/看候选列表如果出现pptx-generator或/pptx说明扫描成功。如果没有检查目录路径和SKILL.md的 front matter 格式——YAML 的---必须是文件第一行前面不能有空行。第二步主动触发。准备一个测试 Markdown 文件demo.md## 背景 这是一段测试内容用于验证 pptx 技能。 ## 方案 方案 A 成本低。 方案 B 扩展性好。 ## 结论 建议先跑方案 A。然后在 Claude Code 里输入/pptx-generator 把 demo.md 转成 PPT或者更自然一点把 demo.md 转成演示文稿两种都应该触发。前者是显式调用后者靠description匹配。如果显式能触发、自然语言不能说明description写得不够贴近口语回去补几个触发词。第三步检查结果。正常情况下 Claude Code 会依次执行读文件、拆章节、调脚本、输出 pptx。完成后你应该在当前目录看到demo.pptx用 PowerPoint 或 WPS 打开确认三页内容对应三个二级标题。如果脚本调用失败重点看报错。常见的是ModuleNotFoundError: No module named pptx这是环境缺库跑pip install python-pptx即可。如果是401或local proxy failed回到第 2 节检查 Base URL 和 Key确认ANTHROPIC_BASE_URL没有多写斜杠、Key 没有多余空格。验证通过后你可以把demo.md换成真实文章再跑一次。实测下来一篇 3000 字的文章拆成 8 到 12 页比较合适太多会碎太少会挤。这个页数规则可以写进reference/outline-rules.md让 Skill 自己遵守。想先手动体验模型对话确认通道可以去 https://taotoken.net/chat 试一句接入细节查 https://taotoken.net/doc 。5. 本篇常见错排查401、local proxy failed、reading choices 与 OAuthSkill 跑不起来九成是下面几类错。逐个对照。401 Unauthorized。最直接的原因是 Key 无效或没带上。检查三处ANTHROPIC_API_KEY是否填了完整 Key请求头里是否用了正确的字段名Anthropic 风格是x-api-keyOpenAI 风格是Authorization: BearerKey 是否被复制时带了换行或空格。如果用的是 TaoToken确认 Key 是在 https://taotoken.net/api-keys 创建的且没有过期或被删。local proxy failed。这个报错通常出现在你本地起了代理层、但代理层连不上上游时。排查顺序先确认ANTHROPIC_BASE_URL填的是https://taotoken.net/api而不是某个本地地址再确认本地没有残留的代理进程占用端口最后用第 2 节的 curl 命令直连测试curl 通了说明通道没问题问题在 Claude Code 配置读取上。reading choices of undefined。这是典型的响应结构不匹配。你用的客户端按 OpenAI 格式解析choices字段但实际返回的是 Anthropic 格式的content。解决办法是确认客户端和 Base URL 的协议一致Anthropic 协议走/v1/messagesOpenAI 协议走/v1/chat/completions。TaoToken 的 API 地址是 https://taotoken.net/api 具体路径按你客户端要求拼。OAuth 相关报错。如果你用的是需要 OAuth 登录的工具比如某些 Claude Code 发行版报 OAuth 失败时先确认是否应该改用 API Key 方式。API Key 方式更稳定适合 Skill 这种自动化场景。配置里把 OAuth 相关字段清掉只保留 Base URL 和 Key。Skill 不触发。不是报错但很常见。检查SKILL.md的description是否包含用户实际会说的词检查目录是否在扫描路径内检查 front matter 的---是否顶格。改完重启会话。脚本执行权限。scripts/下的.py或.sh如果没有执行权限会静默失败。Linux/macOS 下跑chmod x scripts/build_pptx.py。把这几类错记下来下次遇到直接对号入座比从头猜快得多。6. 把绝招沉淀成 Skill从 pptx 到你的个人工作流pptx 只是一个例子。真正有价值的是把你自己反复做的事封装起来。判断标准很简单如果某个任务你每周至少做一次且步骤基本固定它就值得做成 Skill。比如代码审查。你可以写一个code-review技能SKILL.md里规定检查项命名规范、错误处理、日志埋点、单元测试覆盖。reference/放团队编码规范。触发词写「审查代码」「review 这个文件」。以后一句/code-review src/main.py就能跑完整套检查。再比如接口文档生成。把 OpenAPI 模板放进reference/脚本负责解析代码注释并填充Skill 负责调度。新人入职装一个产出的文档格式和老人一致。沉淀 Skill 的过程其实是在把你的隐性经验显性化。写SKILL.md时你会被迫想清楚第一步做什么、第二步做什么、哪些情况要特殊处理。这个思考本身就有价值。如果你打算长期跑这类 Agent 任务Coding Plan 比按量付费更省心入口在 https://taotoken.net/coding-plan 。模型对话体验在 https://taotoken.net/chat 。接入文档和参数说明在 https://taotoken.net/doc 遇到配置问题先翻文档再动手改。下一篇会带你从零实现一个自己的 Skill并介绍怎么用社区里现成的技能包。先把这篇的 pptx 跑通你就有了第一个可复用的绝招。