Claude官方Skills入门指南：从零构建你的第一个AI技能

1次阅读

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

Claude Skills 是构建在对话 AI 平台上的模块化能力单元，相比传统聊天机器人：1) 采用声明式配置而非硬编码逻辑 2) 支持动态技能组合而非单一对话流 3) 通过开放协议实现企业级集成。这种架构让开发者能像搭积木一样快速组装智能应用。

每个 Skill 都需要 manifest.json 文件定义基础属性，这相当于技能的身份证：

{
  "skill_id": "weather_pro",
  "name": "Weather Query",
  "description": "实时查询全球城市天气情况",
  "version": "1.0.0",
  "privacy_policy": "https://example.com/privacy",
  "apis": [
    {
      "name": "get_weather",
      "description": "获取指定城市天气数据",
      "parameters": {"city": {"type": "string", "required": true}
      }
    }
  ]
}

skill_id 需全局唯一且保持稳定
apis 字段声明对外暴露的服务接口
版本号遵循语义化规范（SemVer）

在 training_data.json 中定义 NLU 训练样本，采用插槽填充 (Slot Filling) 技术：

{
  "intents": [
    {
      "name": "query_weather",
      "utterances": ["查询 {city} 天气",
        "{city}现在多少度",
        "告诉我 {city} 的天气预报"
      ],
      "slots": {"city": {"type": "GEO_CITY"}
      }
    }
  ]
}

每个 intent 至少配置 10 条以上多样化表述
实体类型可使用系统预置（如 GEO_CITY）或自定义正则
通过 @ 符号可标注同义词（如 ” 北京 @帝都 ”）

Python 处理函数需继承 BaseSkill 类，关键代码示例：

from typing import Dict, Any
from claude_skill import BaseSkill
import requests
from cachetools import TTLCache

class WeatherSkill(BaseSkill):
    def __init__(self):
        self.cache = TTLCache(maxsize=100, ttl=3600)  # 1 小时缓存

    async def get_weather(self, params: Dict[str, Any]) -> Dict:
        city = params['city']
        try:
            # 优先读取缓存
            if city in self.cache:
                return self.cache[city]

            # 调用第三方 API
            api_key = self.get_config('WEATHER_API_KEY')
            url = f"https://api.weather.com/v3?city={city}&key={api_key}"
            resp = requests.get(url, timeout=5)
            resp.raise_for_status()

            # 标准化输出格式
            data = {"temperature": resp.json()['temp'],
                "condition": resp.json()['weather']
            }

            # 写入缓存
            self.cache[city] = data
            return data

        except requests.exceptions.RequestException as e:
            self.logger.error(f"API 调用失败: {str(e)}")
            return {"error": "天气服务暂时不可用"}

使用 async/await 支持高并发
通过 TTLCache 实现自动过期的内存缓存
敏感配置通过 get_config()动态加载

对于需要身份验证的场景，推荐 OAuth2.0 授权码模式：

在 manifest 中声明权限需求

"oauth_config": {"scopes": ["weather:read"],
  "authorization_url": "https://auth.example.com/oauth"
}

处理回调时验证 state 参数防 CSRF
使用 httpx 实现令牌自动刷新

预加载高频城市数据
使用 CDN 加速静态资源
实现 Health Check 接口

通过 session_id 保持上下文：

async def handle_message(self, message: str, session: Dict) -> str:
    if "明天" in message and "weather_context" in session:
        city = session["weather_context"]["city"]
        return await self.query_weather(city, "tomorrow")