从零开发一个标准Skill：新手避坑指南与实践教程

2次阅读

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

Skill（技能）是语音助手平台（如 Amazon Alexa、Google Assistant）上的功能模块，类似手机上的 APP。通过语音指令触发，能实现天气查询、智能家居控制、订餐等交互场景。比如对音箱说 ”Alexa，打开客厅灯 ”，背后就是一个智能家居 Skill 在工作。

刚接触 Skill 开发时，容易遇到这些坑：

API 版本混乱 ：不同平台 SDK 版本差异大，文档分散
NLU(Natural Language Understanding) 匹配不准 ：用户说 ” 我想听周杰伦 ”，却被识别成 ” 打开周杰伦模式 ”
多轮对话难设计 ：处理 ” 先查天气，再定闹钟 ” 这样的连续请求时逻辑复杂
认证失败 ：90% 的审核被拒源于 OAuth 配置错误

主流开发方式有两种：

使用官方 SDK（推荐新手）
以 Alexa Skills Kit(ASK) SDK 为例：
优点：内置合规检查、自动处理证书验证
缺点：灵活性较低，部分高级功能需绕道实现
自研 HTTP 服务
需要自行实现：
优点：完全掌控业务逻辑
缺点：需处理签名验证、请求编解码等底层细节

以下基于 Python 3.8 的 ASK SDK 模板，关键部分已添加注释：

from ask_sdk_core.skill_builder import SkillBuilder
from ask_sdk_core.dispatch_components import (AbstractRequestHandler, AbstractExceptionHandler)
from ask_sdk_core.utils import is_request_type, is_intent_name

# 基础技能构建器
sb = SkillBuilder()

class LaunchRequestHandler(AbstractRequestHandler):
    """处理技能启动请求"""
    def can_handle(self, handler_input):
        return is_request_type("LaunchRequest")(handler_input)

    def handle(self, handler_input):
        speech = "欢迎使用我的技能，您想查询什么？"
        return handler_input.response_builder.speak(speech).response

# 意图处理器示例
class WeatherIntentHandler(AbstractRequestHandler):
    def can_handle(self, handler_input):
        return is_intent_name("WeatherIntent")(handler_input)

    def handle(self, handler_input):
        try:
            # 从槽位获取城市参数
            slots = handler_input.request_envelope.request.intent.slots
            city = slots["city"].value

            # 模拟业务逻辑
            weather = get_weather_from_api(city)  # 需自行实现

            speech = f"{city} 的天气是 {weather}"
            return handler_input.response_builder.speak(speech).response
        except Exception as e:
            print(f"错误: {str(e)}")
            raise

# 注册处理器
sb.add_request_handler(LaunchRequestHandler())
sb.add_request_handler(WeatherIntentHandler())

# Lambda 入口函数
handler = sb.lambda_handler()

至少覆盖：