Claude Code Skill开发入门指南：从零构建你的第一个AI技能

1次阅读

共计 1848 个字符，预计需要花费 5 分钟才能阅读完成。

Claude Code Skill 是部署在 Claude 对话平台上的可复用对话能力单元，相当于给 AI 安装的 ” 技能插件 ”。比如让 AI 具备查询天气、订餐、翻译等专项能力。与 AWS Lex/Dialogflow 相比，Claude 的特色在于：

更轻量的开发流程（无需单独配置 NLU 引擎）
原生支持多轮对话状态管理
与 Claude 知识库无缝集成

通过分析上百个新手项目，我们发现这三个问题最高频：

意图匹配失效：用户说 ” 明天会下雨吗 ” 但技能未触发
根本原因：训练样本不足（至少需要 20 条同义句）
解决方案：使用 ” 天气下雨降水暴雨 ” 等近义词扩展
对话状态丢失：用户问 ” 上海天气 ” 后又说 ” 那北京呢 ”，但系统要求重新确认城市

关键方法：用 sessionStorage 保存上下文

# 保存用户最后查询的城市
def handle_city(city):
    sessionStorage["last_city"] = city
    return get_weather(city)

异常流程崩溃：用户输入 ” 查下火星天气 ” 导致 API 报错

防御式编程示例：

def validate_city(city):
    if city not in SUPPORTED_CITIES:
        return {"error": f"暂不支持 {city} 的查询"}
    return None

在 Claude 开发者控制台完成：

技能 ID：weather_query
触发短语：” 查天气 ”、” 天气预报 ”、” 会下雨吗 ”
权限声明：需要位置权限（可选）

{
  "intents": [
    {
      "name": "QueryWeather",
      "samples": ["{city}天气怎么样",
        "明天 {city} 会下雨吗",
        "{city}最近三天天气预报"
      ],
      "slots": {"city": {"type": "AMAZON.City"}
      }
    }
  ]
}

from claude_sdk import ClaudeClient
import requests

client = ClaudeClient(api_key="your_key")

# 天气 API 封装
def get_weather(city, date="today"):
    params = {
        "city": city,
        "date": date,
        "key": "WEATHER_API_KEY"
    }
    resp = requests.get("https://api.weather.com/v3", params=params)
    return {"temp": resp.json()["temp"],
        "condition": resp.json()["condition"]
    }

# 对话处理器
@client.skill("weather_query")
def handler(event):
    intent = event["currentIntent"]

    if intent["name"] == "QueryWeather":
        city = intent["slots"].get("city") 
        or event["session"].get("last_city")

        if not city:
            return {"prompt": "请问要查询哪个城市的天气？"}

        weather = get_weather(city)
        return {"speak": f"{city}今天天气 {weather['condition']}，气温{weather['temp']} 度",
            "session": {"last_city": city}
        }