Model Switching Tool Free

SKILL.md

---
slug: model-switching-tool-free
name: model-switching-tool-free
version: 1.0.0
displayName: 模型切换工具(免费版)
summary: 个人开发者的三层Claude模型切换指南,Haiku→Sonnet→Opus节省50-90%成本。
license: Proprietary
edition: free
description: '模型切换工具(免费版)为个人开发者提供三层Claude模型切换指南,从最便宜的Haiku起步,仅在必要时升级,帮助节省50-90%的API成本。核心能力:

  - 三层切换:Haiku → Sonnet → Opus

  - 黄金规则:30秒人类思考阈值

  - 成本对比:Haiku 1x → Sonnet 12x → Opus 60x

  - 快速决策树与参考卡

  - 基础子Agent与定时任务切换


  适用场景:

  - 个人项目API成本优化

  - 子Agent任务分发

  - 定时任务模型选择


  差异化:

  - 免费版聚焦三层切...'
tags:
- Development
- AI
- 模型切换
- 成本优化
- Claude
tools:
- - read
- exec
homepage: https://skillhub.cn
pricing_tier: L3
pricing_model: per_use
suggested_price: 29.9
tools: ["read", "write", "exec"]
tags: "工具,效率,自动化"
---
# 模型切换工具(免费版)

## 概述

模型切换工具(免费版)为个人开发者提供三层Claude模型切换指南。核心原则是:**从最便宜的Haiku起步,仅在必要时升级。** 错误的模型选择要么浪费金钱,要么浪费时间——Haiku用于简单任务,Sonnet用于标准工作,Opus用于复杂决策。正确切换可节省50-90%的API成本。

当你在请求中提及 模型切换、成本优化、子Agent分发、定时任务模型选择 等关键词时,本工具会自动激活,根据任务复杂度推荐合适的模型层级。

本版本聚焦三层切换决策与个人使用场景。如需成本分析仪表盘、批量切换、自定义规则与监控告警,请升级至 PRO 版本。

## 核心能力

| 能力 | 说明 |
|---|---|
| 三层切换 | Haiku → Sonnet → Opus 决策框架 |
| 黄金规则 | 30秒人类思考阈值决定是否升级 |
| 成本对比 | Haiku 1x → Sonnet 12x → Opus 60x 相对成本 |
| 决策树 | 快速判断应使用哪一层 |
| 参考卡 | 可打印的速查卡 |
| 子Agent切换 | 子Agent任务分发模型选择 |
| 定时任务切换 | cron任务默认使用Haiku |
**技术实现要点**：核心能力基于`input_params`参数与`output_format`配置实现,支持创建/查询/修改/删除等操作模式,通过`config_options`进行运行时配置。

### 核心功能执行
用`input_params`参数进行配置。

**输入**: 用户提供核心功能执行所需的指令和必要参数。
**处理**: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回核心功能执行的响应数据,包含状态码、结果和日志。
- 执行此能力时使用`input_params`参数,支持创建/查询/导出操作

### 参数配置与调用
用`config_options`参数进行配置。

**输入**: 用户提供参数配置与调用所需的指令和必要参数。
**处理**: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回参数配置与调用的响应数据,包含状态码、结果和日志。
- 执行此能力时使用`config_options`参数,支持修改/重置/导入操作

### 结果处理与输出
用`output_format`参数进行配置。

**输入**: 用户提供结果处理与输出所需的指令和必要参数。
**处理**: 解析结果处理与输出的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回结果处理与输出的响应数据,包含状态码、结果和日志。
- 执行此能力时使用`output_format`参数,支持导出/保存/转换操作
**能力覆盖范围**：本skill的核心能力覆盖以下场景关键词：个人开发者的三层、Claude、模型切换指南、模型切换工具、免费版、为个人开发者提供、从最便宜的、仅在必要时升级、帮助节省、API、快速决策树与参考、基础子、与定时任务切换等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

## 使用场景

### 场景一:个人项目日常对话切换

用户希望日常对话尽量用便宜模型,降低成本。

```text
用户: 今天天气怎么样?
工具: 💚 HAIKU — 简单事实查询,使用Haiku
# ...
用户: 帮我写一个REST API端点
工具: 💛 SONNET — 代码生成,使用Sonnet
# ...
用户: 设计一个多租户的数据库schema
工具: ❤️ OPUS — 架构决策,使用Opus
```

### 场景二:子Agent任务分发

用户有多个子Agent各司其职,希望按任务复杂度分发模型。

```javascript
// 例行监控 — 用Haiku
sessions_spawn(task="检查备份状态", model="haiku")
// ...
// 标准代码工作 — 用Sonnet
sessions_spawn(task="构建REST API端点", model="sonnet")
// ...
// 架构决策 — 用Opus
sessions_spawn(task="设计多租户数据库schema", model="opus")
```

### 场景三:定时任务模型选择

用户配置定时任务,希望默认用最便宜的模型。

```json
{
  "payload": {
    "kind": "agentTurn",
    "model": "haiku"
  }
}
```

定时任务默认用Haiku,除非任务确实需要推理能力。

## 不适用场景

以下场景模型切换工具(免费版)不适合处理：

- 需要100%确定性的关键决策
- 医疗诊断
- 法律判决

## 触发条件

需要AI模型调用、智能对话、Agent编排、LLM应用时使用。不适用于非本工具能力范围的需求。

## 快速开始

1. 阅读## 核心能力章节了解skill功能
2. 按## 依赖说明配置环境
3. 执行所需能力对应的命令
4. 参考## 错误处理章节处理异常
5. 查看## FAQ解答常见疑问

### 1. 掌握黄金规则

> 如果一个人类需要超过30秒的专注思考,从Haiku升级到Sonnet。
> 如果任务涉及架构、复杂权衡或深度推理,升级到Opus。

### 2. 成本对比速览

| 模型 | 输入价格 | 输出价格 | 相对成本 |
|:-----|:-----|:-----|:-----|
| Haiku | $0.25/M | $1.25/M | 1x(基线) |
| Sonnet | $3.00/M | $15.00/M | 12x |
| Opus | $15.00/M | $75.00/M | 60x |

**核心结论:** 错误的模型选择要么浪费金钱,要么浪费时间。Haiku用于简单,Sonnet用于标准,Opus用于复杂。

### 3. 使用决策树

```text
是问候、查询、状态检查或1-2句回答?
  是 → HAIKU
  否 ↓
# ...
是代码、分析、规划、写作或多步骤?
  是 → SONNET
  否 ↓
# ...
是架构、深度推理或关键决策?
  是 → OPUS
  否 → 默认SONNET,卡住再升级
```

## 示例

### 适用场景

- 事实问答:"什么是X"、"谁是Y"、"什么时候Z"
- 快速查询:定义、单位换算、短翻译
- 状态检查:日历、文件读取、会话监控
- 心跳:周期性检查、HEARTBEAT_OK响应
- 记忆与提醒:"记住这个"、"提醒我..."
- 闲聊:问候、寒暄、确认
- 简单文件操作:读取、列出、基础写入
- 一句话任务:1-2句能回答的任何事

Haiku禁止做的事:

- 写超过10行代码
- 创建对比表格
- 写超过3段
- 多步骤分析
- 写报告或提案

### Sonnet适用场景(主力)

代码与技术:

- 代码生成:写函数、构建功能、脚本
- 代码审查:PR审查、质量检查
- 调试:标准bug排查
- 文档:README、注释、用户指南

分析与规划:

- 分析与评估:对比选项、评估权衡
- 规划:项目计划、路线图、任务拆解
- 研究综合:结合多源信息
- 多步骤推理:"先...再...最后"

写作与内容:

- 长文写作:报告、提案、文章(>3段)
- 创意写作:博客、描述、文案
- 摘要:长文档、转录稿
- 结构化输出:表格、大纲、格式化文档

大多数真实用户对话属于这一层。

### Opus适用场景(复杂推理)

架构与设计:

- 系统架构决策
- 大型代码库重构
- 设计模式选择与权衡
- 数据库schema设计

深度分析:

- 复杂调试(多文件、竞态条件)
- 安全审查
- 性能优化策略
- 隐蔽bug根因分析

战略与创意:

- 战略规划:商业决策、路线图
- 细微判断:伦理、模糊性、竞争价值
- 深度研究:多源综合分析

## 最佳实践

### 1. 从便宜开始,按需升级

```text
原则:START CHEAP → SCALE ONLY WHEN NEEDED
# ...
默认用Haiku → 卡住或质量不足 → 升级Sonnet → 仍不足 → 升级Opus
```

### 2. 30秒思考阈值

判断升级的关键问题:**一个人类需要多少秒专注思考来回答这个任务?**

- <30秒:Haiku足够
- 30秒-2分钟:Sonnet
- >2分钟或涉及架构:Opus

### 3. 定时任务默认Haiku

定时任务通常不需要推理,默认用Haiku可大幅降低成本。仅当任务确实需要推理时才升级。

### 4. 子Agent分发按任务复杂度

```javascript
// 简单监控任务
sessions_spawn(task="检查服务健康", model="haiku")
// ...
// 标准开发任务
sessions_spawn(task="实现用户认证模块", model="sonnet")
// ...
// 复杂架构任务
sessions_spawn(task="设计微服务拆分方案", model="opus")
```

### 5. 可打印参考卡

```text
┌─────────────────────────────────────────┐
│         智能模型切换(免费版)          │
│        Haiku → Sonnet → Opus           │
├─────────────────────────────────────────┤
│  💚 HAIKU(最便宜)                     │
│  • 问候、状态检查、快速查询            │
│  • 事实问答、定义、提醒                │
│  • 简单文件操作、1-2句回答             │
├─────────────────────────────────────────┤
│  💛 SONNET(标准)                      │
│  • 代码>10行、调试                     │
│  • 分析、对比、规划                    │
│  • 报告、提案、长文写作                │
├─────────────────────────────────────────┤
│  ❤️ OPUS(复杂)                        │
│  • 架构决策                            │
│  • 复杂调试、多文件重构                │
│  • 战略规划、深度研究                  │
├─────────────────────────────────────────┤
│  💡 规则:人类>30秒思考 → 升级         │
│  💰 成本:Haiku 1x → Sonnet 12x → Opus 60x │
└─────────────────────────────────────────┘
```

## 常见问题

### Q1:免费版支持哪些模型?

免费版提供三层切换决策框架,面向Claude系列模型(Haiku/Sonnet/Opus)。实际可用模型取决于你的API权限,切换原则通用。

### Q2:如何判断任务需要哪一层?

参考"30秒思考阈值":人类需要<30秒思考用Haiku,30秒-2分钟用Sonnet,>2分钟或涉及架构用Opus。也可参考决策树与参考卡。

### Q3:免费版能否分析成本?

免费版提供成本对比与切换决策,不提供成本分析仪表盘。如需成本追踪、预算告警与优化报告,请使用PRO版。

### Q4:免费版与PRO版差异?

| 维度 | 免费版 | PRO版 |
|---:|---:|---:|
| 切换决策 | 三层决策树 | 三层+自定义规则 |
| 成本分析 | 不支持 | 仪表盘与告警 |
| 批量切换 | 不支持 | 批量任务分发 |
| 自定义规则 | 不支持 | 团队规则与策略 |
| 监控 | 不支持 | 实时监控与告警 |
| 支持 | 社区支持 | 优先支持 |

### Q5:模型价格会变化怎么办?

模型价格会随供应商调整,但三层切换原则(便宜→标准→复杂)通用。建议定期对照供应商最新定价更新成本对比表,切换框架不变。

## 依赖说明

### 运行环境

- **Agent平台**: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
- **操作系统**: Windows / macOS / Linux
- **API供应商**: 提供三层Claude模型选择的API权限

### 依赖详情

| 依赖项 | 类型 | 是否必需 | 获取方式 |
|:---:|:---:|:---:|:---:|
| LLM API | API | 必需 | 由Agent内置LLM提供 |
| Claude API | API | 必需 | 自行申请API Key |

### API Key 配置

- 本skill基于Markdown指令规范,无需额外API Key。
- 实际调用Claude API需要API Key,请按供应商文档配置环境变量(如 `ANTHROPIC_API_KEY`)。
- 建议为不同层级模型配置独立Key或使用同一Key,便于成本追踪。

### 可用性分类

- **分类**: MD+EXEC(纯Markdown指令,部分功能需exec命令行执行)
- **说明**: 基于Markdown的AI Skill,通过自然语言指令驱动Agent完成操作。免费版聚焦个人开发者的三层Claude模型切换决策。

## 错误处理

| 错误场景 | 原因 | 处理方式 |
|:------|------:|:------|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案 |

## 已知限制

- 需要API Key，无Key环境无法使用

## 输出格式
```json
{
  "success": true,
  "data": {
    "result": "模型切换工具(免费版)处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "model switching"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}
```