Claude Skills 安装指南：从零开始构建你的第一个AI技能

1次阅读

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

Claude Skills 是构建在 Claude AI 平台上的定制化技能开发框架，它允许开发者通过简单的 Python 代码和配置文件，快速创建能够理解自然语言指令的 AI 技能。相比于传统对话系统开发，它具有三个显著优势：

低代码开发：基础技能通常只需 50-100 行 Python 代码
自然语言理解内置：无需单独训练 NLU 模型
无缝对接 Claude 生态：可直接通过 Claude 聊天界面调用

在开始安装前，请确保你的开发环境满足以下要求：

Python 环境
Python 3.8 或更高版本
推荐使用 virtualenv 创建隔离环境
Claude 开发者账号
注册地址：Claude 开发者平台
获取 API 密钥（需实名认证）
基础工具
Git（用于安装 SDK）
代码编辑器（VS Code/PyCharm 等）
curl 或 Postman（用于测试）

python -m venv claude_env
source claude_env/bin/activate  # Linux/Mac
# 或
claude_env\Scripts\activate     # Windows

pip install claude-skills-sdk

常见问题 1 ：如果遇到 SSL 证书错误，可尝试：

pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org claude-skills-sdk

claude-skills --version
# 正常应输出类似：claude-skills 1.2.0

weather_skill/
├── skills.py       # 主逻辑
├── manifest.json   # 技能配置
└── requirements.txt

from claude_skills import Skill, Request, Response

class WeatherSkill(Skill):
    """处理天气查询的基础技能"""

    def handle_request(self, request: Request) -> Response:
        """
        核心处理方法
        :param request: 包含用户输入和上下文
        :return: 响应对象
        """city = request.slot("city")  # 提取槽位值

        # 这里应该是实际的天气 API 调用
        # 示例使用模拟数据
        weather_data = {
            "temperature": "22℃",
            "condition": "晴"
        }

        return Response(text=f"{city}的天气是{weather_data['condition']}，气温{weather_data['temperature']}"
        )

{
  "skill_name": "weather_query",
  "version": "1.0.0",
  "description": "查询城市天气情况",
  "slots": [
    {
      "name": "city",
      "type": "string",
      "required": true,
      "prompt": "请问您想查询哪个城市的天气？"
    }
  ],
  "examples": [
    "北京天气怎么样",
    "查询上海的天气预报"
  ]
}

# 启动技能服务
claude-skills serve --skill weather_skill.skills:WeatherSkill

# 另开终端测试
curl -X POST http://localhost:8080/handle \
  -H "Content-Type: application/json" \
  -d '{"text":" 北京天气 "}'