1. 为什么要把跑通的流程固化成 Skill你大概遇到过这种场景某个脚本调了半天终于跑通数据清洗、接口调用、结果落盘一条龙走完心里想着「下次直接复用」。结果过两周再来一遍命令忘了、参数顺序记混、环境变量漏配又得从头翻聊天记录。Claude Code 的 Agent Skills 就是解决这个问题的——它能把一次完整跑通的流程沉淀成一个可被斜杠命令触发的技能包。Skill 本质上是一个带 YAML 头部的 Markdown 文件放在约定目录里Claude Code 在 Agent 模式下会自动识别并按需加载。它和普通提示词的区别在于提示词是临时的、跟着对话走的Skill 是落盘的、可 git 提交、可分发、可迭代的。适合谁适合那些已经用 Claude Code 跑通过至少一条完整工作流、想把它变成团队资产或自己长期复用的人。这篇不讲空泛概念直接给你一份可复制的 SKILL.md 骨架、目录配置以及加载后触发一次完整流程的验证动作。核心检索词就三个Skill、SKILL.md、Agent Skills。下面所有操作都在 Claude Code 里完成普通网页聊天窗口加载不了本地 skill 文件这点先记住。2. TaoToken 前置给 Claude Code 接上稳定通道Claude Code 要跑起来得先有可用的模型接入。我这边用的是 TaoToken 的 API 通道官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。它兼容 Anthropic 的接口格式Claude Code 配置起来比较顺。先拿 Key。进控制台创建 API Key地址是 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。创建后复制那串 sk- 开头的密钥只显示一次丢了就重建。然后在终端里配置环境变量。Claude Code 读取的是 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 这两个变量export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的密钥想持久化就写进 shell 配置文件比如~/.zshrc或~/.bashrc追加同样两行再source一下。验证通道是否通可以先用模型对话页面发一条消息试试 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。能正常返回说明 Key 和通道没问题再进 Claude Code。注意环境变量名别写错Claude Code 认的是 ANTHROPIC_ 前缀写成别的它读不到。改完变量记得新开一个终端窗口旧窗口不会自动刷新。3. 可复制配置SKILL.md 骨架与目录结构Skill 的目录约定很固定。项目级放在.claude/skills/你的技能名/SKILL.md跟着项目走能 git 提交给团队用户全局放在~/.claude/skills/你的技能名/SKILL.md本机所有项目都能用。技能名必须小写加连字符不能有空格和大写字母比如data-clean-report这种。先建目录mkdir -p .claude/skills/data-clean-report然后创建 SKILL.md。下面这份骨架可以直接复制改--- name:>claude进去后敲/data-clean-report如果补全列表里出现了说明目录和 YAML 头部都读到了。没出现的话八成是路径不对或 name 字段格式有问题回到第 5 节排查。第二步造一份测试数据触发完整流程mkdir -p input output printf date,category,amount\n2024-01-01,A,100\n2024-01-02,B,200\n,A,\n2024-01-03,B,300\n input/raw.csv第三步在 Claude Code 里发一句自然语言看它是否自动加载 Skill 并执行帮我清洗一下 raw.csv 并出个汇总预期结果是Claude 识别到触发条件加载>cat output/summary.csv正常应该看到按 category 分组的两行汇总全空行被剔除日期格式统一。如果它没走 Skill 而是自己临时写代码说明 description 的触发词没覆盖到你的说法回去把「清洗」「汇总」这类词补进 description。提示验证时保持对话上下文完整别中途清空历史。Skill 加载依赖当前会话状态清空后可能得重新触发。5. 本篇常见错排查斜杠命令不出现。先查路径项目级必须是.claude/skills/技能名/SKILL.md少一层目录就读不到。再查 name 字段大写字母、空格、下划线都会导致解析失败只允许小写和连字符。Skill 加载了但步骤乱序。Instructions 写得不够结构化。把每步拆成独立编号动词开头明确输入输出。别写「处理一下数据」这种要写「读取 X转换 Y写入 Z」。触发词命中率低。description 太窄。把你平时会说的几种表达都塞进去比如「清洗数据」「整理 CSV」「出报告」「汇总统计」用顿号或逗号隔开。脚本路径找不到。Skill 里的相对路径是相对于 SKILL.md 所在目录不是项目根目录。引用脚本时写scripts/clean.py别写./scripts/clean.py或绝对路径。改了 SKILL.md 不生效。Claude Code 有缓存退出重进一次会话即可。改完记得保存文件编辑器没保存的话读到的还是旧内容。报错后静默跳过。这是 Instructions 没写异常处理。在最后加一条「任一步骤报错则停止并输出堆栈」避免它自作主张继续跑出脏结果。6. 从一次性操作到可迭代资产跑通验证后这个 Skill 就成了你项目里的一份可提交资产。团队其他人 clone 下来配好 TaoToken 的 Key直接/data-clean-report就能复现整套流程不用再问你怎么配环境。后续流程有变动改 SKILL.md 里的 Instructions 就行版本跟着 git 走。想长期做编码和 Agent 工作流可以考虑 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 配合 Skill 沉淀会更顺。接入细节和参数说明看文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。Claude Code 相关的接入配置在 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_codeutm_campaignrewrite 也有说明。最后给个实用习惯每跑通一条新流程顺手问 Claude Code 一句「把我们刚才做的打包成 skill」它会复盘本轮对话输出一份 SKILL.md 草稿你只需微调 description 和路径就能落盘。这样积累下来你的.claude/skills/目录就是一套越长越厚的个人工作流库。
