从零构建你的第一个skill demo：新手避坑指南与最佳实践

2次阅读

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

第一次构建 skill demo 时，很多开发者容易陷入以下技术误区：

过度设计架构：在 MVP 阶段就引入复杂的微服务架构，反而增加调试难度。实际只需按业务流划分为意图处理、服务调用、响应生成三个模块即可。
忽略状态管理：未考虑多轮对话场景。例如用户查询天气时，若未保存「城市」状态，每次都需要重复询问位置信息。
缺乏错误处理：直接返回 API 调用的原始错误信息。正确的做法是封装友好提示（如 ” 暂时无法获取天气数据，请检查城市名称 ”）。

框架	适用场景	学习曲线	典型应用
ASK SDK	深度集成 Alexa 生态	中等	智能家居控制
Jovo	多平台兼容（Alexa+Google）	较平缓	跨平台语音助手
Rasa	需要 NLU 自定义训练	陡峭	复杂对话系统

新手建议：从 ASK SDK 开始，其文档完善且与 AWS 服务无缝对接。

# 创建项目目录
mkdir weather-skill && cd weather-skill
npm init -y
npm install ask-sdk axios

const {SkillBuilders} = require('ask-sdk-core');
const axios = require('axios');

// 意图定义
const GetWeatherIntentHandler = {canHandle(handlerInput) {
    return handlerInput.requestEnvelope.request.type === 'IntentRequest'
      && handlerInput.requestEnvelope.request.intent.name === 'GetWeatherIntent';
  },
  async handle(handlerInput) {
    // 获取槽位值
    const city = handlerInput.requestEnvelope.request.intent.slots.city.value;

    try {
      // 调用天气 API
      const response = await axios.get(`https://api.weatherapi.com/v1/current.json?key=YOUR_KEY&q=${city}`);
      const temp = response.data.current.temp_c;

      // 维护会话状态
      const sessionAttributes = handlerInput.attributesManager.getSessionAttributes();
      sessionAttributes.lastCity = city;

      return handlerInput.responseBuilder
        .speak(`${city}当前气温 ${temp}摄氏度 `)
        .getResponse();} catch (error) {console.error('API 调用失败:', error);
      return handlerInput.responseBuilder
        .speak('获取天气信息失败，请稍后再试')
        .getResponse();}
  }
};

使用 attributesManager 实现多轮对话：

const LastCityHandler = {canHandle(handlerInput) {
    // 检查是否存有上次查询城市
    const sessionAttributes = handlerInput.attributesManager.getSessionAttributes();
    return sessionAttributes.lastCity;
  },
  handle(handlerInput) {const city = handlerInput.attributesManager.getSessionAttributes().lastCity;
    // 自动复用上次城市...
  }
};

预热函数：通过定时任务每隔 15 分钟触发一次空调用
精简依赖 ：检查 node_modules，移除未使用的库（使用depcheck 工具）
内存缓存：对静态数据使用内存缓存（如城市列表）

const timeoutResponse = {canHandle(handlerInput) {return handlerInput.requestEnvelope.request.type === 'SessionEndedRequest';},
  handle(handlerInput) {
    console.log('会话超时原因:', 
      handlerInput.requestEnvelope.request.reason);
    return handlerInput.responseBuilder.getResponse();}
};