尧图网页设计 
1. 为什么 2026 年大家都在聊 Agent Skills如果你最近刷技术社区会发现一个词反复出现Agent Skills。它是什么简单说就是把「你希望 AI 怎么干活」写成一份 Markdown 文件放在指定目录里AI 编程工具在需要时自动读取并执行。它解决的是一个老问题模型本身很聪明但不知道你们团队的规范、流程和偏好每次都要重复交代。Agent Skills 最早由 Anthropic 作为开放标准发布核心载体是一个叫SKILL.md的文件。一个 Skill 就是一个文件夹里面至少有一个SKILL.md包含 YAML frontmatter名称、描述和 Markdown 正文具体指令。你还可以往里面塞脚本、模板、参考文档让 AI 按需加载。它适合谁三类人最该关注一是每天用 AI 写代码但总觉得「不够懂我」的开发者二是想把团队规范固化下来、避免每个人输出风格不一致的技术负责人三是做 UI/UX 设计、想让 AI 直接产出高质量界面代码的产品同学。谷歌 Antigravity IDE 对 Agent Skills 的支持让这件事从「概念」变成了「今天就能上手」。我实测下来最大的感受是以前你要在对话里写一大段 prompt 告诉 AI「按这个规范来」现在你写一次SKILL.md之后所有对话自动生效。而且因为它是文件可以进 Git、可以 review、可以跨工具复用。这就是为什么说 2026 是 Skills 元年——它把「提示词」从一次性消耗品变成了可管理的知识资产。接下来我会从环境安装讲起带你写第一个SKILL.md配置 Antigravity调用 UI UX Pro Max Skills最后用 TaoToken 统一 Key 打通多工具鉴权。每一步都有可复制的代码和配置。2. Antigravity 安装与 Skills 目录结构详解Antigravity 是谷歌推出的 AI 编程 IDE支持 Agent Skills 的方式和官方文档一致。安装本身不复杂关键是搞清楚 Skills 放哪里、目录怎么组织。2.1 安装 Antigravity IDE从官网下载对应平台的安装包安装完成后首次启动会让你登录谷歌账号。登录后进入主界面你会看到一个类似 VS Code 的布局左侧是文件树右侧是 AI 对话面板。安装完成后建议先确认版本号。在终端执行antigravity --version如果提示命令不存在说明你需要把 Antigravity 的 bin 目录加入 PATH。macOS 下通常是export PATH$PATH:/Applications/Antigravity.app/Contents/Resources/binWindows 下在系统环境变量里添加安装目录的bin文件夹即可。2.2 Skills 的两种存放位置Antigravity 支持两种级别的 Skills位置作用范围适用场景workspace-root/.agent/skills/skill-folder/工作区级别项目特定的工作流如团队部署流程、测试规范~/.gemini/antigravity/skills/skill-folder/全局级别跨项目的个人工具或通用工具工作区级别的 Skills 只在你打开那个项目时生效适合放「这个项目的代码审查规则」。全局级别的 Skills 对所有项目生效适合放「我个人的写作风格」或「通用的 Git 提交规范」。我建议新手先从全局级别开始写一个简单的 Skill 验证流程跑通再往工作区级别迁移。2.3 创建一个 Skill 的最小结构一个 Skill 文件夹的最小结构就是.agent/skills/ └── my-skill/ └── SKILL.mdSKILL.md是唯一必需的文件。它的开头必须是 YAML frontmatter用三个减号包裹--- name: my-skill description: Helps with a specific task. Use when you need to do X or Y. ---然后是 Markdown 正文写清楚这个 Skill 什么时候用、怎么用。Antigravity 的智能体会在对话开始时加载所有 Skills 的 name 和 description大约 100 tokens当你的任务描述匹配到某个 Skill 的 description 时才会读取完整的SKILL.md内容。这个机制叫「渐进式披露」目的是节省上下文窗口。2.4 Frontmatter 字段规范与 Antigravity 的差异这里有一个容易踩的坑Agent Skills 开放标准和 Antigravity 实现在name字段上有差异。字段Agent Skills 标准Antigravity 实现说明name必需可选1-64 字符小写字母、数字和连字符。Antigravity 允许省略默认使用文件夹名description必需必需描述技能功能和触发场景最多 1024 字符license可选可选许可证信息compatibility可选可选环境要求说明最多 500 字符metadata可选可选自定义键值对allowed-tools可选实验性可选实验性预授权工具列表写description的时候用第三人称包含帮助智能体识别任务的关键词。好的例子是「Generates unit tests for Python code using pytest conventions.」差的例子是「Helps with tests.」。后者太模糊智能体无法判断什么时候该用。2.5 推荐的文件夹结构虽然SKILL.md是唯一必需的文件但你可以加入额外资源.agent/skills/my-skill/ ├── SKILL.md # 主指令文件必需 ├── scripts/ # 辅助脚本可选 ├── examples/ # 参考实现可选 └── resources/ # 模板和其他资源可选Agent Skills 规范推荐scripts/、references/、assets/Antigravity 文档用scripts/、examples/、resources/两者兼容。你按哪个来都行关键是保持一致。3. 可复制的 SKILL.md 模板与 Antigravity 配置片段这一节给你可以直接复制粘贴的配置。我会先给一个通用的SKILL.md模板再给 Antigravity 的 settings 配置片段最后演示如何通过 TaoToken 统一 Key 完成鉴权。3.1 通用 SKILL.md 模板把下面这段保存为.agent/skills/code-review/SKILL.md--- name: code-review description: Reviews code changes for bugs, style issues, and best practices. Use when reviewing PRs or checking code quality. --- # Code Review Skill When reviewing code, follow these steps: ## Review checklist 1. **Correctness**: Does the code do what its supposed to? 2. **Edge cases**: Are error conditions handled? 3. **Style**: Does it follow project conventions? 4. **Performance**: Are there obvious inefficiencies? ## How to provide feedback - Be specific about what needs to change - Explain why, not just what - Suggest alternatives when possible这个模板的结构是frontmatter 定义触发条件正文分「检查清单」和「反馈方式」两部分。智能体读到这个 Skill 后会按照清单逐项检查并按你指定的方式给出反馈。3.2 Antigravity settings 配置片段Antigravity 的配置文件通常位于用户目录下的.gemini/antigravity/settings.json。如果你要通过 TaoToken 统一 Key 来调用模型需要在这里配置 Base URL 和 API Key。{ antigravity.modelProvider: { baseUrl: https://taotoken.net/api, apiKey: sk-your-taotoken-key, modelId: claude-sonnet-4-20250514 }, antigravity.skills.enabled: true, antigravity.skills.globalPath: ~/.gemini/antigravity/skills, antigravity.skills.workspacePath: .agent/skills }三件套必须写全Base URL 是https://taotoken.net/apiAPI Key 从 TaoToken 控制台获取Model ID 填你要用的模型标识。少任何一个都会导致鉴权失败。如果你用的是 Cline 或 Claude Code 这类工具配置方式类似。Cline 的 MCP 配置里同样需要填 Base URL、Key 和 Model ID。Codex 的auth.json也是同样的三件套逻辑。3.3 通过 TaoToken 获取统一 KeyTaoToken 的作用是让你用一个 Key 访问多个模型通道不用为每个工具单独申请和轮换密钥。获取步骤打开https://taotoken.net/api-keys登录后创建一个新的 API Key。复制生成的sk-开头的字符串粘贴到上面 settings.json 的apiKey字段。如果你还没有账号可以先到https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册。注册后在控制台可以看到余额和用量统计。3.4 UI UX Pro Max Skills 的安装配置UI UX Pro Max 是一个专门用于生成高质量 UI 代码的 Skill 集合。官方提供了 CLI 工具一键安装npm install -g uipro-cli cd /path/to/your/project uipro init --ai claude--ai参数可以填claude、cursor、windsurf、copilot或all。如果你用的是 Antigravity选claude兼容模式即可因为 Antigravity 的 Skill 格式和 Claude Code 一致。安装完成后你的项目目录下会多出一个.agent/skills/ui-ux-pro-max/文件夹里面包含SKILL.md和相关的模板资源。3.5 验证配置是否生效在 Antigravity 的终端里执行ls -la .agent/skills/你应该能看到code-review和ui-ux-pro-max两个文件夹。然后打开 Antigravity 的 AI 对话面板输入列出当前可用的 Skills如果配置正确智能体会返回它加载到的 Skill 名称和描述列表。这一步很关键能确认 Skills 目录被正确识别。4. 调用验证与 UI UX Pro Max 实测结果配置完成后最重要的是验证调用链路是否通畅。这一节我会演示完整的调用过程包括普通 Skill 调用和 UI UX Pro Max 的实际效果。4.1 验证 API 通道是否通畅先用一个最简单的请求确认 TaoToken 的 API 通道能通。在终端执行curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-your-taotoken-key \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: 回复 OK}], max_tokens: 10 }如果返回的 JSON 里有choices字段且内容包含OK说明 Key 和通道都正常。如果返回 401检查 Key 是否复制完整如果返回local proxy failed检查 Base URL 是否写成了https://taotoken.net/api而不是其他地址。4.2 在 Antigravity 中调用 code-review Skill打开一个包含代码的项目在 AI 对话面板输入请用 code-review 技能审查 src/utils/format.js 这个文件智能体会自动匹配到code-reviewSkill读取完整的SKILL.md然后按照检查清单逐项审查。你会看到它输出类似这样的结构## 审查结果 ### 正确性 - 第 12 行的日期格式化没有处理时区建议使用 Intl.DateTimeFormat ### 边界情况 - 第 25 行没有处理空字符串输入建议加一个 early return ### 风格 - 第 8 行使用了 var建议改为 const这就是 Skill 的价值你不用每次告诉它「检查正确性、边界、风格、性能」它自动按你定义的流程走。4.3 UI UX Pro Max 实测生成 SwiftUI Todo App这是最让我意外的部分。在 Antigravity 对话面板输入/ui-ux-pro-max Build a complete Todo List app using SwiftUI with: - Add new tasks with title and optional due date - Mark tasks as complete/incomplete - Swipe to delete tasks - Filter by: All, Active, Completed - Persist data locally using SwiftData - Dark mode support - Clean minimalist aesthetic Target: iOS 17智能体会加载 UI UX Pro Max Skill然后开始生成代码。实测下来它输出的不是一个简单的列表页面而是包含完整数据模型、视图层、持久化逻辑的项目结构。生成的Task.swift数据模型import SwiftData import Foundation Model final class Task { var title: String var notes: String? var dueDate: Date? var isCompleted: Bool var createdAt: Date init(title: String, notes: String? nil, dueDate: Date? nil) { self.title title self.notes notes self.dueDate dueDate self.isCompleted false self.createdAt Date() } }生成的TaskListView.swift主视图import SwiftUI import SwiftData struct TaskListView: View { Environment(\.modelContext) private var context Query private var tasks: [Task] State private var filter: FilterType .all var filteredTasks: [Task] { switch filter { case .all: return tasks case .active: return tasks.filter { !$0.isCompleted } case .completed: return tasks.filter { $0.isCompleted } } } var body: some View { NavigationStack { List { ForEach(filteredTasks) { task in TaskRow(task: task) } .onDelete(perform: deleteTasks) } .navigationTitle(Tasks) .toolbar { ToolbarItem(placement: .topBarTrailing) { Picker(Filter, selection: $filter) { Text(All).tag(FilterType.all) Text(Active).tag(FilterType.active) Text(Completed).tag(FilterType.completed) } .pickerStyle(.segmented) } } } } private func deleteTasks(at offsets: IndexSet) { for index in offsets { context.delete(filteredTasks[index]) } } }实测结果超出预期的地方在于它自动处理了 SwiftData 的Model宏、Query数据绑定、以及NavigationStack的工具栏布局。这些细节如果手动写至少要查半小时文档。4.4 验证 Skill 是否被正确触发如果你不确定某个 Skill 有没有被加载可以在对话里直接问你刚才使用了哪个 Skill为什么选择它智能体会解释它的判断逻辑。这个技巧在调试 Skill 触发问题时特别有用。如果它说「没有匹配到 Skill」说明你的description写得不够具体需要加入更多任务关键词。5. 常见报错排查与修复方法这一节整理我在配置过程中实际遇到的报错以及对应的修复方法。每个报错都给出具体现象和解决步骤。5.1 401 Unauthorized现象调用 API 时返回{error: {message: Invalid API key, type: authentication_error}}。原因通常是 Key 复制不完整或者 Key 前面多了空格。检查settings.json里的apiKey字段确保是完整的sk-开头字符串没有换行符。另一个可能你在 TaoToken 控制台创建 Key 后没有复制关掉页面就再也看不到了。这种情况只能重新创建一个。5.2 local proxy failed现象Antigravity 提示local proxy failed to connect。这个报错通常是因为 Base URL 配置错误。检查settings.json里的baseUrl是否写成了https://taotoken.net/api。注意不要写成https://taotoken.net/api/v1因为 SDK 会自动拼接/v1/chat/completions。多写一层会导致 404。如果 Base URL 正确但仍然报错检查你的网络是否能正常访问taotoken.net。在终端执行curl -I https://taotoken.net/api如果返回 200 或 401说明网络通畅如果超时检查 DNS 或防火墙设置。5.3 reading choices 报错现象返回的 JSON 解析失败提示cannot read property choices of undefined。这说明 API 返回的结构和你预期的不同。最常见的原因是 Model ID 写错了。比如你填了claude-sonnet-4但实际可用的 ID 是claude-sonnet-4-20250514。在 TaoToken 的模型列表页面确认可用的 Model ID然后更新settings.json。另一个原因请求体里缺少messages字段或者messages格式不对。确保是[{role: user, content: ...}]这样的数组结构。5.4 OAuth 相关报错现象Antigravity 提示OAuth token expired或failed to refresh token。Antigravity 本身需要谷歌账号登录这个 OAuth 和 TaoToken 的 API Key 是两套独立的鉴权体系。如果 Antigravity 的登录态过期重新登录谷歌账号即可。如果 TaoToken 的 Key 过期通常不会除非你手动删除去控制台重新生成。两者不要混淆Antigravity 的 OAuth 管的是 IDE 本身的登录TaoToken 的 Key 管的是模型 API 的调用。5.5 Skill 没有被触发现象你在对话里提到了某个任务但智能体没有加载对应的 Skill。排查步骤第一确认SKILL.md的 frontmatter 格式正确三个减号不能少。第二确认description里包含了任务的关键词。第三在对话里显式提及 Skill 名称比如「请使用 code-review 技能」。如果还是不行检查 Skills 目录路径是否正确。工作区级别的 Skills 必须在workspace-root/.agent/skills/下全局级别的必须在~/.gemini/antigravity/skills/下。路径错了智能体扫描不到。5.6 UI UX Pro Max 安装后不生效现象执行了uipro init --ai claude但对话里输入/ui-ux-pro-max没有反应。检查安装目录uipro init默认会在当前目录创建.agent/skills/ui-ux-pro-max/。如果你在错误的目录执行了命令Skill 会装到别的地方。用find . -name SKILL.md确认文件位置。另外/ui-ux-pro-max是一个 prompt 前缀不是 Skill 名称。Skill 的实际名称在SKILL.md的 frontmatter 里定义。你可以打开那个文件确认name字段的值。6. 用 TaoToken 统一 Key 打通多工具鉴权当你同时使用 Antigravity、Claude Code、Cline 等多个工具时最烦的事情是每个工具都要单独配置 Key而且不同工具的 Key 格式和轮换策略不一样。TaoToken 的价值就是用一个 Key 打通所有工具。6.1 为什么需要统一 Key假设你手上有三个工具Antigravity 用来写代码Claude Code 用来做代码审查Cline 用来跑 MCP 工具。如果每个工具都直连不同的模型提供商你需要管理三套 Key、三套账单、三套用量统计。任何一个 Key 泄露或过期都要单独处理。用 TaoToken 之后你只需要一个 Key。所有工具都指向https://taotoken.net/api用同一个sk-开头的字符串鉴权。用量在 TaoToken 控制台统一查看余额统一充值。6.2 在 Claude Code 中配置 TaoTokenClaude Code 的配置文件通常位于~/.claude/settings.json。添加以下内容{ apiProvider: { baseUrl: https://taotoken.net/api, apiKey: sk-your-taotoken-key, model: claude-sonnet-4-20250514 } }如果你用的是 Claude Code 的 Anthropic 兼容模式Base URL 保持不变Model ID 填 Claude 系列即可。6.3 在 Cline MCP 中配置 TaoTokenCline 的 MCP 配置在 VS Code 的settings.json里。找到cline.mcpServers字段添加{ cline.mcpServers: { taotoken: { command: npx, args: [-y, taotoken/mcp-server], env: { TAOTOKEN_BASE_URL: https://taotoken.net/api, TAOTOKEN_API_KEY: sk-your-taotoken-key, TAOTOKEN_MODEL_ID: claude-sonnet-4-20250514 } } } }三件套再次出现Base URL、API Key、Model ID。缺一不可。6.4 在 Codex auth.json 中配置 TaoTokenCodex 的鉴权文件在~/.codex/auth.json。内容格式{ base_url: https://taotoken.net/api, api_key: sk-your-taotoken-key, model_id: claude-sonnet-4-20250514 }保存后重启 Codex它会自动读取这个文件。6.5 验证多工具共用同一个 Key配置完成后分别在三个工具里发一条测试消息。然后打开 TaoToken 控制台的用量页面你应该能看到三条请求记录都来自同一个 Key。这说明统一鉴权生效了。如果某个工具没有出现在用量记录里说明它的配置没有指向 TaoToken。检查该工具的 Base URL 是否写成了https://taotoken.net/api。6.6 长期编码场景建议用 Coding Plan如果你每天都要用 AI 写代码按量计费可能不如包月划算。TaoToken 的 Coding Plan 提供固定额度的调用次数适合长期编码和 Agent 场景。在控制台的https://taotoken.net/console页面可以查看和切换套餐。对于偶尔用一下的场景按量计费更灵活。对于每天写代码超过 2 小时的场景Coding Plan 通常更省。6.7 安全建议不要在公开的 Git 仓库里提交包含 API Key 的配置文件。把settings.json和auth.json加入.gitignore。如果团队协作需要共享配置用环境变量代替硬编码export TAOTOKEN_API_KEYsk-your-key然后在配置文件里引用${TAOTOKEN_API_KEY}。这样 Key 不会进入版本历史。到这里从 Antigravity 安装、SKILL.md 编写、UI UX Pro Max 调用到 TaoToken 统一 Key 打通多工具鉴权的完整链路就跑通了。你可以先从写一个简单的 code-review Skill 开始验证流程后再逐步加入更复杂的脚本和模板。 2026年Agent Skills元年开启！谷歌Antigravity从安装到调用保姆级教程，UI UX Pro Max Skills实测超预期，TaoToken统一Key打通全流程
1. 为什么 2026 年大家都在聊 Agent Skills如果你最近刷技术社区会发现一个词反复出现Agent Skills。它是什么简单说就是把「你希望 AI 怎么干活」写成一份 Markdown 文件放在指定目录里AI 编程工具在需要时自动读取并执行。它解决的是一个老问题模型本身很聪明但不知道你们团队的规范、流程和偏好每次都要重复交代。Agent Skills 最早由 Anthropic 作为开放标准发布核心载体是一个叫SKILL.md的文件。一个 Skill 就是一个文件夹里面至少有一个SKILL.md包含 YAML frontmatter名称、描述和 Markdown 正文具体指令。你还可以往里面塞脚本、模板、参考文档让 AI 按需加载。它适合谁三类人最该关注一是每天用 AI 写代码但总觉得「不够懂我」的开发者二是想把团队规范固化下来、避免每个人输出风格不一致的技术负责人三是做 UI/UX 设计、想让 AI 直接产出高质量界面代码的产品同学。谷歌 Antigravity IDE 对 Agent Skills 的支持让这件事从「概念」变成了「今天就能上手」。我实测下来最大的感受是以前你要在对话里写一大段 prompt 告诉 AI「按这个规范来」现在你写一次SKILL.md之后所有对话自动生效。而且因为它是文件可以进 Git、可以 review、可以跨工具复用。这就是为什么说 2026 是 Skills 元年——它把「提示词」从一次性消耗品变成了可管理的知识资产。接下来我会从环境安装讲起带你写第一个SKILL.md配置 Antigravity调用 UI UX Pro Max Skills最后用 TaoToken 统一 Key 打通多工具鉴权。每一步都有可复制的代码和配置。2. Antigravity 安装与 Skills 目录结构详解Antigravity 是谷歌推出的 AI 编程 IDE支持 Agent Skills 的方式和官方文档一致。安装本身不复杂关键是搞清楚 Skills 放哪里、目录怎么组织。2.1 安装 Antigravity IDE从官网下载对应平台的安装包安装完成后首次启动会让你登录谷歌账号。登录后进入主界面你会看到一个类似 VS Code 的布局左侧是文件树右侧是 AI 对话面板。安装完成后建议先确认版本号。在终端执行antigravity --version如果提示命令不存在说明你需要把 Antigravity 的 bin 目录加入 PATH。macOS 下通常是export PATH$PATH:/Applications/Antigravity.app/Contents/Resources/binWindows 下在系统环境变量里添加安装目录的bin文件夹即可。2.2 Skills 的两种存放位置Antigravity 支持两种级别的 Skills位置作用范围适用场景workspace-root/.agent/skills/skill-folder/工作区级别项目特定的工作流如团队部署流程、测试规范~/.gemini/antigravity/skills/skill-folder/全局级别跨项目的个人工具或通用工具工作区级别的 Skills 只在你打开那个项目时生效适合放「这个项目的代码审查规则」。全局级别的 Skills 对所有项目生效适合放「我个人的写作风格」或「通用的 Git 提交规范」。我建议新手先从全局级别开始写一个简单的 Skill 验证流程跑通再往工作区级别迁移。2.3 创建一个 Skill 的最小结构一个 Skill 文件夹的最小结构就是.agent/skills/ └── my-skill/ └── SKILL.mdSKILL.md是唯一必需的文件。它的开头必须是 YAML frontmatter用三个减号包裹--- name: my-skill description: Helps with a specific task. Use when you need to do X or Y. ---然后是 Markdown 正文写清楚这个 Skill 什么时候用、怎么用。Antigravity 的智能体会在对话开始时加载所有 Skills 的 name 和 description大约 100 tokens当你的任务描述匹配到某个 Skill 的 description 时才会读取完整的SKILL.md内容。这个机制叫「渐进式披露」目的是节省上下文窗口。2.4 Frontmatter 字段规范与 Antigravity 的差异这里有一个容易踩的坑Agent Skills 开放标准和 Antigravity 实现在name字段上有差异。字段Agent Skills 标准Antigravity 实现说明name必需可选1-64 字符小写字母、数字和连字符。Antigravity 允许省略默认使用文件夹名description必需必需描述技能功能和触发场景最多 1024 字符license可选可选许可证信息compatibility可选可选环境要求说明最多 500 字符metadata可选可选自定义键值对allowed-tools可选实验性可选实验性预授权工具列表写description的时候用第三人称包含帮助智能体识别任务的关键词。好的例子是「Generates unit tests for Python code using pytest conventions.」差的例子是「Helps with tests.」。后者太模糊智能体无法判断什么时候该用。2.5 推荐的文件夹结构虽然SKILL.md是唯一必需的文件但你可以加入额外资源.agent/skills/my-skill/ ├── SKILL.md # 主指令文件必需 ├── scripts/ # 辅助脚本可选 ├── examples/ # 参考实现可选 └── resources/ # 模板和其他资源可选Agent Skills 规范推荐scripts/、references/、assets/Antigravity 文档用scripts/、examples/、resources/两者兼容。你按哪个来都行关键是保持一致。3. 可复制的 SKILL.md 模板与 Antigravity 配置片段这一节给你可以直接复制粘贴的配置。我会先给一个通用的SKILL.md模板再给 Antigravity 的 settings 配置片段最后演示如何通过 TaoToken 统一 Key 完成鉴权。3.1 通用 SKILL.md 模板把下面这段保存为.agent/skills/code-review/SKILL.md--- name: code-review description: Reviews code changes for bugs, style issues, and best practices. Use when reviewing PRs or checking code quality. --- # Code Review Skill When reviewing code, follow these steps: ## Review checklist 1. **Correctness**: Does the code do what its supposed to? 2. **Edge cases**: Are error conditions handled? 3. **Style**: Does it follow project conventions? 4. **Performance**: Are there obvious inefficiencies? ## How to provide feedback - Be specific about what needs to change - Explain why, not just what - Suggest alternatives when possible这个模板的结构是frontmatter 定义触发条件正文分「检查清单」和「反馈方式」两部分。智能体读到这个 Skill 后会按照清单逐项检查并按你指定的方式给出反馈。3.2 Antigravity settings 配置片段Antigravity 的配置文件通常位于用户目录下的.gemini/antigravity/settings.json。如果你要通过 TaoToken 统一 Key 来调用模型需要在这里配置 Base URL 和 API Key。{ antigravity.modelProvider: { baseUrl: https://taotoken.net/api, apiKey: sk-your-taotoken-key, modelId: claude-sonnet-4-20250514 }, antigravity.skills.enabled: true, antigravity.skills.globalPath: ~/.gemini/antigravity/skills, antigravity.skills.workspacePath: .agent/skills }三件套必须写全Base URL 是https://taotoken.net/apiAPI Key 从 TaoToken 控制台获取Model ID 填你要用的模型标识。少任何一个都会导致鉴权失败。如果你用的是 Cline 或 Claude Code 这类工具配置方式类似。Cline 的 MCP 配置里同样需要填 Base URL、Key 和 Model ID。Codex 的auth.json也是同样的三件套逻辑。3.3 通过 TaoToken 获取统一 KeyTaoToken 的作用是让你用一个 Key 访问多个模型通道不用为每个工具单独申请和轮换密钥。获取步骤打开https://taotoken.net/api-keys登录后创建一个新的 API Key。复制生成的sk-开头的字符串粘贴到上面 settings.json 的apiKey字段。如果你还没有账号可以先到https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册。注册后在控制台可以看到余额和用量统计。3.4 UI UX Pro Max Skills 的安装配置UI UX Pro Max 是一个专门用于生成高质量 UI 代码的 Skill 集合。官方提供了 CLI 工具一键安装npm install -g uipro-cli cd /path/to/your/project uipro init --ai claude--ai参数可以填claude、cursor、windsurf、copilot或all。如果你用的是 Antigravity选claude兼容模式即可因为 Antigravity 的 Skill 格式和 Claude Code 一致。安装完成后你的项目目录下会多出一个.agent/skills/ui-ux-pro-max/文件夹里面包含SKILL.md和相关的模板资源。3.5 验证配置是否生效在 Antigravity 的终端里执行ls -la .agent/skills/你应该能看到code-review和ui-ux-pro-max两个文件夹。然后打开 Antigravity 的 AI 对话面板输入列出当前可用的 Skills如果配置正确智能体会返回它加载到的 Skill 名称和描述列表。这一步很关键能确认 Skills 目录被正确识别。4. 调用验证与 UI UX Pro Max 实测结果配置完成后最重要的是验证调用链路是否通畅。这一节我会演示完整的调用过程包括普通 Skill 调用和 UI UX Pro Max 的实际效果。4.1 验证 API 通道是否通畅先用一个最简单的请求确认 TaoToken 的 API 通道能通。在终端执行curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-your-taotoken-key \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: 回复 OK}], max_tokens: 10 }如果返回的 JSON 里有choices字段且内容包含OK说明 Key 和通道都正常。如果返回 401检查 Key 是否复制完整如果返回local proxy failed检查 Base URL 是否写成了https://taotoken.net/api而不是其他地址。4.2 在 Antigravity 中调用 code-review Skill打开一个包含代码的项目在 AI 对话面板输入请用 code-review 技能审查 src/utils/format.js 这个文件智能体会自动匹配到code-reviewSkill读取完整的SKILL.md然后按照检查清单逐项审查。你会看到它输出类似这样的结构## 审查结果 ### 正确性 - 第 12 行的日期格式化没有处理时区建议使用 Intl.DateTimeFormat ### 边界情况 - 第 25 行没有处理空字符串输入建议加一个 early return ### 风格 - 第 8 行使用了 var建议改为 const这就是 Skill 的价值你不用每次告诉它「检查正确性、边界、风格、性能」它自动按你定义的流程走。4.3 UI UX Pro Max 实测生成 SwiftUI Todo App这是最让我意外的部分。在 Antigravity 对话面板输入/ui-ux-pro-max Build a complete Todo List app using SwiftUI with: - Add new tasks with title and optional due date - Mark tasks as complete/incomplete - Swipe to delete tasks - Filter by: All, Active, Completed - Persist data locally using SwiftData - Dark mode support - Clean minimalist aesthetic Target: iOS 17智能体会加载 UI UX Pro Max Skill然后开始生成代码。实测下来它输出的不是一个简单的列表页面而是包含完整数据模型、视图层、持久化逻辑的项目结构。生成的Task.swift数据模型import SwiftData import Foundation Model final class Task { var title: String var notes: String? var dueDate: Date? var isCompleted: Bool var createdAt: Date init(title: String, notes: String? nil, dueDate: Date? nil) { self.title title self.notes notes self.dueDate dueDate self.isCompleted false self.createdAt Date() } }生成的TaskListView.swift主视图import SwiftUI import SwiftData struct TaskListView: View { Environment(\.modelContext) private var context Query private var tasks: [Task] State private var filter: FilterType .all var filteredTasks: [Task] { switch filter { case .all: return tasks case .active: return tasks.filter { !$0.isCompleted } case .completed: return tasks.filter { $0.isCompleted } } } var body: some View { NavigationStack { List { ForEach(filteredTasks) { task in TaskRow(task: task) } .onDelete(perform: deleteTasks) } .navigationTitle(Tasks) .toolbar { ToolbarItem(placement: .topBarTrailing) { Picker(Filter, selection: $filter) { Text(All).tag(FilterType.all) Text(Active).tag(FilterType.active) Text(Completed).tag(FilterType.completed) } .pickerStyle(.segmented) } } } } private func deleteTasks(at offsets: IndexSet) { for index in offsets { context.delete(filteredTasks[index]) } } }实测结果超出预期的地方在于它自动处理了 SwiftData 的Model宏、Query数据绑定、以及NavigationStack的工具栏布局。这些细节如果手动写至少要查半小时文档。4.4 验证 Skill 是否被正确触发如果你不确定某个 Skill 有没有被加载可以在对话里直接问你刚才使用了哪个 Skill为什么选择它智能体会解释它的判断逻辑。这个技巧在调试 Skill 触发问题时特别有用。如果它说「没有匹配到 Skill」说明你的description写得不够具体需要加入更多任务关键词。5. 常见报错排查与修复方法这一节整理我在配置过程中实际遇到的报错以及对应的修复方法。每个报错都给出具体现象和解决步骤。5.1 401 Unauthorized现象调用 API 时返回{error: {message: Invalid API key, type: authentication_error}}。原因通常是 Key 复制不完整或者 Key 前面多了空格。检查settings.json里的apiKey字段确保是完整的sk-开头字符串没有换行符。另一个可能你在 TaoToken 控制台创建 Key 后没有复制关掉页面就再也看不到了。这种情况只能重新创建一个。5.2 local proxy failed现象Antigravity 提示local proxy failed to connect。这个报错通常是因为 Base URL 配置错误。检查settings.json里的baseUrl是否写成了https://taotoken.net/api。注意不要写成https://taotoken.net/api/v1因为 SDK 会自动拼接/v1/chat/completions。多写一层会导致 404。如果 Base URL 正确但仍然报错检查你的网络是否能正常访问taotoken.net。在终端执行curl -I https://taotoken.net/api如果返回 200 或 401说明网络通畅如果超时检查 DNS 或防火墙设置。5.3 reading choices 报错现象返回的 JSON 解析失败提示cannot read property choices of undefined。这说明 API 返回的结构和你预期的不同。最常见的原因是 Model ID 写错了。比如你填了claude-sonnet-4但实际可用的 ID 是claude-sonnet-4-20250514。在 TaoToken 的模型列表页面确认可用的 Model ID然后更新settings.json。另一个原因请求体里缺少messages字段或者messages格式不对。确保是[{role: user, content: ...}]这样的数组结构。5.4 OAuth 相关报错现象Antigravity 提示OAuth token expired或failed to refresh token。Antigravity 本身需要谷歌账号登录这个 OAuth 和 TaoToken 的 API Key 是两套独立的鉴权体系。如果 Antigravity 的登录态过期重新登录谷歌账号即可。如果 TaoToken 的 Key 过期通常不会除非你手动删除去控制台重新生成。两者不要混淆Antigravity 的 OAuth 管的是 IDE 本身的登录TaoToken 的 Key 管的是模型 API 的调用。5.5 Skill 没有被触发现象你在对话里提到了某个任务但智能体没有加载对应的 Skill。排查步骤第一确认SKILL.md的 frontmatter 格式正确三个减号不能少。第二确认description里包含了任务的关键词。第三在对话里显式提及 Skill 名称比如「请使用 code-review 技能」。如果还是不行检查 Skills 目录路径是否正确。工作区级别的 Skills 必须在workspace-root/.agent/skills/下全局级别的必须在~/.gemini/antigravity/skills/下。路径错了智能体扫描不到。5.6 UI UX Pro Max 安装后不生效现象执行了uipro init --ai claude但对话里输入/ui-ux-pro-max没有反应。检查安装目录uipro init默认会在当前目录创建.agent/skills/ui-ux-pro-max/。如果你在错误的目录执行了命令Skill 会装到别的地方。用find . -name SKILL.md确认文件位置。另外/ui-ux-pro-max是一个 prompt 前缀不是 Skill 名称。Skill 的实际名称在SKILL.md的 frontmatter 里定义。你可以打开那个文件确认name字段的值。6. 用 TaoToken 统一 Key 打通多工具鉴权当你同时使用 Antigravity、Claude Code、Cline 等多个工具时最烦的事情是每个工具都要单独配置 Key而且不同工具的 Key 格式和轮换策略不一样。TaoToken 的价值就是用一个 Key 打通所有工具。6.1 为什么需要统一 Key假设你手上有三个工具Antigravity 用来写代码Claude Code 用来做代码审查Cline 用来跑 MCP 工具。如果每个工具都直连不同的模型提供商你需要管理三套 Key、三套账单、三套用量统计。任何一个 Key 泄露或过期都要单独处理。用 TaoToken 之后你只需要一个 Key。所有工具都指向https://taotoken.net/api用同一个sk-开头的字符串鉴权。用量在 TaoToken 控制台统一查看余额统一充值。6.2 在 Claude Code 中配置 TaoTokenClaude Code 的配置文件通常位于~/.claude/settings.json。添加以下内容{ apiProvider: { baseUrl: https://taotoken.net/api, apiKey: sk-your-taotoken-key, model: claude-sonnet-4-20250514 } }如果你用的是 Claude Code 的 Anthropic 兼容模式Base URL 保持不变Model ID 填 Claude 系列即可。6.3 在 Cline MCP 中配置 TaoTokenCline 的 MCP 配置在 VS Code 的settings.json里。找到cline.mcpServers字段添加{ cline.mcpServers: { taotoken: { command: npx, args: [-y, taotoken/mcp-server], env: { TAOTOKEN_BASE_URL: https://taotoken.net/api, TAOTOKEN_API_KEY: sk-your-taotoken-key, TAOTOKEN_MODEL_ID: claude-sonnet-4-20250514 } } } }三件套再次出现Base URL、API Key、Model ID。缺一不可。6.4 在 Codex auth.json 中配置 TaoTokenCodex 的鉴权文件在~/.codex/auth.json。内容格式{ base_url: https://taotoken.net/api, api_key: sk-your-taotoken-key, model_id: claude-sonnet-4-20250514 }保存后重启 Codex它会自动读取这个文件。6.5 验证多工具共用同一个 Key配置完成后分别在三个工具里发一条测试消息。然后打开 TaoToken 控制台的用量页面你应该能看到三条请求记录都来自同一个 Key。这说明统一鉴权生效了。如果某个工具没有出现在用量记录里说明它的配置没有指向 TaoToken。检查该工具的 Base URL 是否写成了https://taotoken.net/api。6.6 长期编码场景建议用 Coding Plan如果你每天都要用 AI 写代码按量计费可能不如包月划算。TaoToken 的 Coding Plan 提供固定额度的调用次数适合长期编码和 Agent 场景。在控制台的https://taotoken.net/console页面可以查看和切换套餐。对于偶尔用一下的场景按量计费更灵活。对于每天写代码超过 2 小时的场景Coding Plan 通常更省。6.7 安全建议不要在公开的 Git 仓库里提交包含 API Key 的配置文件。把settings.json和auth.json加入.gitignore。如果团队协作需要共享配置用环境变量代替硬编码export TAOTOKEN_API_KEYsk-your-key然后在配置文件里引用${TAOTOKEN_API_KEY}。这样 Key 不会进入版本历史。到这里从 Antigravity 安装、SKILL.md 编写、UI UX Pro Max 调用到 TaoToken 统一 Key 打通多工具鉴权的完整链路就跑通了。你可以先从写一个简单的 code-review Skill 开始验证流程后再逐步加入更复杂的脚本和模板。