企业官网建设流程全解析

1. 为什么我决定把 AgentSkill 全链路跑一遍

ClaudeCode 的 AgentSkill 机制，简单说就是给大模型配一本“随时能翻的说明书”。你可以把常用规则、输出格式、触发条件写进 Skill，模型在匹配到相关任务时自动加载，不用每次对话都重复交代。它适合谁？适合已经在用 ClaudeCode 做日常开发、写文档、做会议纪要，但每次都要手动贴一大段提示词的人。我试过把会议总结、代码审查、周报生成这三类高频任务做成 Skill，效率提升非常明显。

但问题也随之而来：Skill 里会挂 Reference 文件（按需读取的参考资料）和 Script 脚本（自动执行的代码），这些调用最终都要走模型 API。如果你本地同时开了好几个项目，每个项目各自配一套 Key 和通道，管理起来就很乱。更麻烦的是，Skill 触发 Script 执行时，如果 API 通道不稳定，脚本跑到一半断了，排查起来很痛苦。

所以这篇要解决的核心问题是：用 TaoToken 统一 Key 和 API 通道，把 ClaudeCode 的 AgentSkill 从定义、Reference 加载到 Script 执行整条链路跑通。我会给出 settings.json 和 config.toml 的可复制骨架、Skill 目录结构示例，以及一次完整的 Skill 调用验证动作。你跟着做，本地就能跑起来。

2. TaoToken 前置准备：统一 Key 与 API 通道

TaoToken 在这里的角色是“统一入口”。你不需要在每个项目里分别配不同的模型通道，而是用同一个 Key、同一个 API 地址，让 ClaudeCode 的所有 Skill 调用都走这条通道。这样做的好处是：Skill 触发 Reference 读取或 Script 执行时，请求路径一致，出问题只需要查一个地方。

先拿到 Key。打开 https://taotoken.net/api-keys ，创建一个 API Key，复制保存。注意这个 Key 只在创建时显示一次，丢了就得重新建。

然后确认你的 API 基础地址是 https://taotoken.net/api 。这个地址后面会写进 ClaudeCode 的配置文件里。如果你用的是 ClaudeCode 的 Anthropic 兼容模式，还需要确认模型名称映射，具体可以参考 https://taotoken.net/doc 里的接入说明。

注意：Key 不要硬编码在 Skill 的 SKILL.md 里，也不要提交到 Git。统一放在环境变量或 ClaudeCode 的配置文件里，Skill 只负责定义规则，不负责管凭证。

接下来是配置文件。ClaudeCode 支持 settings.json 和 config.toml 两种配置方式，我建议两个都准备好，因为不同版本的 ClaudeCode 读取优先级不一样。settings.json 放在用户目录的 .claude 文件夹下，config.toml 放在项目根目录或用户配置目录下。

settings.json 骨架：

{ "api": { "base_url": "https://taotoken.net/api", "api_key": "sk-你的TaoTokenKey", "model": "claude-sonnet-4-20250514", "timeout": 120 }, "skills": { "enabled": true, "global_dir": "~/.claude/skills", "project_dir": ".claude/skills" } }

config.toml 骨架：

[api] base_url = "https://taotoken.net/api" api_key = "sk-你的TaoTokenKey" model = "claude-sonnet-4-20250514" timeout = 120 [skills] enabled = true global_dir = "~/.claude/skills" project_dir = ".claude/skills"

这两个文件里的 base_url 和 api_key 是核心。base_url 指向 TaoToken 的 API 地址，api_key 用你刚才创建的那个。model 字段填你实际要用的模型名，如果你不确定，可以去 https://taotoken.net/models 看当前支持的模型列表。

配好之后，ClaudeCode 启动时会读取这个配置，所有 Skill 的模型调用都会走 TaoToken 通道。你不需要在 SKILL.md 里再写任何 API 相关的信息。

3. 可复制配置：Skill 目录结构与 SKILL.md 骨架

AgentSkill 的目录结构分全局和局部两种。全局 Skill 放在 ~/.claude/skills 下，所有项目都能用；局部 Skill 放在项目根目录的 .claude/skills 下，只对当前项目生效。我建议把通用型 Skill（比如会议总结、代码审查）放全局，把项目专属的（比如某个业务的接口规范）放局部。

目录结构示例：

~/.claude/skills/ ├── 会议总结助手/ │ ├── SKILL.md │ ├── references/ │ │ └── 集团财务手册.md │ └── scripts/ │ └── upload.py └── 代码审查助手/ ├── SKILL.md └── references/ └── 编码规范.md

注意 SKILL.md 的文件名必须是大写的 SKILL，不能写成 skill.md 或 Skill.md。文件夹名称要和 SKILL.md 里的 name 字段一致。

SKILL.md 骨架：

--- name: 会议总结助手 description: 该技能用于根据会议录音或文字记录总结内容，输出参会人员、议题、决定三项 --- # 会议总结助手 ### 总结规则 请将会议内容总结为以下几点： - 参会人员 - 议题 - 决定 注意：每项都只能分别使用一句话来表述，不要分成多条。 ### 财务提醒规则 当会议内容涉及钱、预算、采购、费用等关键词时，读取 references/集团财务手册.md，并根据手册内容判断金额是否超标、明确审批人。 ### 上传规则 当用户提到上传、同步或发送到服务器时，执行 scripts/upload.py，将总结内容上传到指定服务器。

这个骨架里包含了三层信息：元数据层（name 和 description）、指令层（总结规则、财务提醒规则、上传规则）、资源层（references 和 scripts 的引用）。元数据层始终加载，指令层按需加载，资源层按需中的按需加载。

Reference 文件示例，references/集团财务手册.md：

# 集团财务手册 ## 费用报销标准 - 单笔金额 500 元以下：部门经理审批 - 单笔金额 500 至 2000 元：总监审批 - 单笔金额 2000 元以上：财务总监审批 ## 采购流程 - 采购金额超过 1000 元需三家比价 - 采购金额超过 5000 元需签订正式合同

Script 文件示例，scripts/upload.py：

import sys import json import requests def upload_summary(content, endpoint): payload = {"summary": content} resp = requests.post(endpoint, json=payload, timeout=30) return resp.status_code, resp.text if __name__ == "__main__": summary = sys.stdin.read() endpoint = "https://your-server.example.com/api/upload" code, text = upload_summary(summary, endpoint) print(f"status={code}") print(text)

Script 的关键点是：它只被执行，不会被读取到模型上下文里，所以不消耗 token。ClaudeCode 只关心脚本怎么运行、运行结果是什么。你可以在脚本里做任何自动化操作，比如上传文件、写数据库、发通知。

4. 验证请求：一次完整的 Skill 调用

配置和文件都准备好之后，打开 ClaudeCode，输入/会议总结助手，然后粘贴一段会议内容。我用一段简化版的会议记录来演示：

李姐：今天主要定老王博客项目的技术栈。小王你先说。 小王：我建议用 Next.js 14 加 Tailwind CSS，开发体验好，SEO 也友好。 老张：我觉得 Django 更稳，部署简单，成本低。 李姐：那这样，后端用 Django REST framework 只出 API，前端用 Next.js，前后端分离。预算方面，服务器和数据库加起来每月不超过 800 元。 小王：没问题，我来搭前端。 老张：我来做后端和数据库设计。 李姐：好，散会。

这段内容里包含了技术栈决策和预算信息，所以会触发两个规则：总结规则和财务提醒规则。

ClaudeCode 的处理流程是这样的：首先匹配到“会议总结助手”这个 Skill，加载元数据层；然后发现用户输入和 Skill 描述匹配，加载指令层；接着在指令层里发现“预算”关键词，触发财务提醒规则，请求读取 references/集团财务手册.md；读取后根据手册内容判断 800 元属于 500 至 2000 元区间，需要总监审批；最后输出总结和财务提醒。

预期输出结果：

● 根据会议总结助手的规则，我将会议内容总结如下： 参会人员：李姐、小王、老张三人参与技术讨论会议。 议题：确定老王个人博客项目的技术栈方案，要求功能简单、稳定、易维护、快速上线。 决定：采用前后端分离架构，后端使用 Django REST framework 提供 API，前端使用 Next.js 14 实现页面展示。 财务提醒：本次会议提到服务器和数据库每月预算不超过 800 元，根据集团财务手册，单笔金额 500 至 2000 元需总监审批。请确认审批人。

如果你看到类似输出，说明 Skill 定义、Reference 加载、模型调用整条链路都通了。这时候你可以再测试 Script 执行：在对话里说“把总结上传到服务器”，ClaudeCode 会请求执行 scripts/upload.py，你同意后脚本运行，返回上传结果。

验证 API 通道是否走的是 TaoToken，可以看 ClaudeCode 的日志输出，或者在 TaoToken 的 console 里查看请求记录。打开 https://taotoken.net/console ，能看到每次 Skill 调用产生的请求，包括模型名称、token 消耗、响应时间。如果请求记录里出现了你的 Skill 调用，说明通道配置正确。

5. 本篇常见错排查

第一个坑：SKILL.md 文件名不对。必须是全大写 SKILL.md，写成 skill.md 在 Linux 和 macOS 上可能能识别，但在某些 ClaudeCode 版本里会直接忽略。文件夹名称也要和 name 字段一致，否则 Skill 列表里显示不出来。

第二个坑：Reference 文件路径写错。SKILL.md 里引用 references/集团财务手册.md 时，路径是相对于 SKILL.md 所在目录的。如果你把 Reference 文件放在别的地方，要么改路径，要么把文件移进 references 文件夹。路径里不要用绝对路径，换台机器就失效了。

第三个坑：Script 没有执行权限。在 Linux 和 macOS 上，upload.py 需要 chmod +x 才能直接执行。如果你在 SKILL.md 里写的是 python scripts/upload.py，那不需要执行权限，但需要确保 python 命令在 PATH 里。我建议统一用 python 显式调用，避免权限问题。

第四个坑：API Key 没生效。检查 settings.json 和 config.toml 里的 api_key 是否填对，base_url 是否是 https://taotoken.net/api 。如果 ClaudeCode 报 401 或 403，大概率是 Key 错了或者过期了。去 https://taotoken.net/api-keys 重新创建一个，替换掉配置文件里的旧 Key。

第五个坑：Skill 触发了但模型没按规则输出。这种情况通常是指令层写得不够明确。比如你写了“总结会议内容”，但没规定输出格式，模型就会自由发挥。解决办法是把规则写具体，像上面骨架里那样，明确列出“参会人员、议题、决定”三项，并加上“每项只能一句话”的约束。

第六个坑：Script 执行超时。默认 timeout 是 120 秒，如果你的脚本要处理大文件或调用外部服务，可能会超时。可以在 settings.json 里把 timeout 调大，比如 300。但更推荐的做法是让脚本尽快返回，把耗时操作放到后台队列里。

6. 接入文档与后续操作

整条链路跑通之后，你可能会想调整模型、换 Key、或者把 Skill 分享给团队。这些操作都围绕同一个入口：TaoToken 的 API 通道。你不需要改 Skill 文件，只需要改配置文件里的 base_url 和 api_key，所有 Skill 调用会自动走新通道。

如果你在排障过程中遇到接入问题，比如 ClaudeCode 报连接错误、模型名称不识别、或者 Skill 加载失败，先去 https://taotoken.net/doc 看接入文档，里面有针对 ClaudeCode 的配置说明和常见错误码解释。文档里也写了如何用 Anthropic 兼容模式接入，如果你用的是 ClaudeCode 的 Anthropic 通道，可以参考 https://taotoken.net/claude-code-anthropic 这个页面。

验证模型是否正常工作，可以用 https://taotoken.net/chat 做一次简单对话，确认 Key 和通道没问题。如果对话正常但 Skill 不触发，那就是 Skill 文件本身的问题，回到第 5 节排查。

长期用 ClaudeCode 做编码和 Agent 任务的话，可以考虑 Coding Plan，具体在 https://taotoken.net/coding-plan 看。它适合高频调用、多项目并行的场景，比按量计费更划算。我自己的做法是：日常轻量任务用按量 Key，重度的 Skill 批量执行和 Script 自动化走 Coding Plan，两边分开管理，账单也清楚。

最后提醒一点：Skill 里的 Script 虽然不消耗 token，但它执行的操作用户要自己负责。比如上传脚本会把内容发到你的服务器，确保 endpoint 是你自己的、可信的地址。Reference 文件里也不要放敏感信息，因为读取后会进入模型上下文。把这些边界划清楚，AgentSkill 用起来就很顺手了。