标准的skill入门指南：从零构建你的第一个技能开发项目

2次阅读

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

标准的 skill 是一种可扩展的对话式交互模块，它能理解用户意图并完成特定任务。典型的应用场景包括：

智能家居控制（如调节灯光温度）
信息服务查询（天气 / 新闻 / 股票）
商务流程自动化（订餐 / 预约 / 客服）

意图定义模糊：将 ” 查天气 ” 和 ” 问气温 ” 分成两个独立意图，导致模型混淆
实体提取不全：未考虑 ” 后天下午 ” 这类复合时间表达式
对话状态失控：用户打断后无法恢复先前上下文
异常处理缺失：当 API 超时时直接返回原始错误堆栈
过度依赖 GUI 工具：不了解底层交互协议导致调试困难

// skill_manifest.json
{
  "skillName": "weather_assistant",
  "invocationName": "天气小助手",
  "intents": [
    {
      "name": "QueryWeather",
      "samples": ["{city}天气怎么样",
        "查询 {date}{city} 的天气"
      ],
      "slots": [{"name": "city", "type": "AMAZON.CN_CITY"},
        {"name": "date", "type": "AMAZON.DATE"}
      ]
    }
  ]
}

关键字段说明：

invocationName：用户唤醒技能的名称
samples：至少需要 15 条以上多样化的表达样本
slots：建议为每个实体类型添加 2 - 3 个同义词

# weather_skill.py
from datetime import datetime

def handle_query(event):
    """处理天气查询请求"""
    try:
        city = event['request']['intent']['slots']['city']['value']
        raw_date = event['request']['intent']['slots']['date'].get('value')

        # 日期解析逻辑
        query_date = datetime.today()
        if raw_date:
            if '天后' in raw_date:
                days = int(raw_date.split('天')[0])
                query_date = query_date + timedelta(days=days)
            else:
                query_date = parse_date(raw_date)

        # 获取天气数据（模拟实现）weather_data = get_weather(city, query_date)

        return {
            'version': '1.0',
            'response': {
                'outputSpeech': {
                    'type': 'PlainText',
                    'text': f"{query_date}的 {city} 天气是{weather_data}"
                }
            }
        }
    except Exception as e:
        # 错误处理标准化
        return build_error_response(str(e))

def get_weather(city, date):
    """模拟天气 API 调用"""
    # 实际项目应替换为真实 API 调用
    return "晴，25-32℃"

推荐采用有限状态机 (FSM) 模式：

初始化状态：等待用户发起查询
参数收集状态：当缺少城市或日期时主动询问
服务处理状态：调用外部 API 获取数据
确认状态：询问用户是否需要其他信息

stateDiagram
    [*] --> Idle
    Idle --> ParameterCollection: 收到查询但参数不全
    ParameterCollection --> ServiceProcessing: 参数收集完成
    ServiceProcessing --> Confirmation: 返回查询结果
    Confirmation --> Idle: 用户选择结束
    Confirmation --> ParameterCollection: 用户发起新查询