陌讯skill新手入门指南：从零搭建到核心功能实现

4次阅读

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

近年来，语音交互市场年增长率超过 40%，技能（Skill）开发已成为人机交互的新标准。陌讯 skill 通过标准化协议和可视化工具链，将传统 3 周以上的开发周期缩短至 72 小时，特别适合快速试错的新场景需求。

协议栈差异
传统方案依赖 ASR（Automatic Speech Recognition）+ NLU（Natural Language Understanding）两段式处理，而陌讯 skill 采用统一的 SkillML 协议，请求延迟降低 60%
上下文管理
传统方案需要手动维护 session，陌讯 skill 提供自动化的对话上下文树（Dialog Context Tree），支持最长 15 轮对话记忆
多模态支持
除语音外，原生支持：
富文本卡片（Rich Card）
动态表单（Dynamic Form）
3D 物体识别（3D Object Detection）「实验性功能」

node.js >= 16.13.0
@moxun/skill-cli 2.4.1

my-skill/
├── manifests/       # 技能描述文件
├── intents/         # 意图定义
├── dialogs/         # 对话流程  
└── resources/       # 多模态素材

{
  "skillId": "com.example.weather",
  "apis": [
    {
      "type": "REST",
      "endpoint": "https://api.weather.com"
    }
  ],
  "permissions": ["LOCATION"] // 需用户授权的权限
}

注意：skillId 需全局唯一，建议采用反向域名命名法

// 匹配 "查北京天气" 类请求
const weatherPattern = /^(查询 | 查看)(?<city>\S+)天气 $/;

class WeatherHandler {async execute(event) {const match = event.query.match(weatherPattern);
    if (!match?.groups?.city) {throw new Error('MISSING_CITY'); // 统一错误码
    }
    return fetchWeather(match.groups.city);
  }
}

enum States {
  INIT,
  CONFIRM_CITY,
  SHOW_WEATHER
}

class DialogEngine {
  private state: States = States.INIT;

  async next(input: string) {
    try {switch(this.state) {
        case States.INIT:
          this.city = await parseCity(input);
          this.state = States.CONFIRM_CITY;
          return ` 确认查询 ${this.city}天气吗？`;
        // ... 其他状态处理
      }
    } catch (err) {
      this.state = States.INIT; // 出错重置
      return '抱歉，请重新说明需求';
    }
  }
}

{
  "version": "1.0",
  "output": {
    "speech": "北京今天晴转多云，25 度",
    "card": {
      "type": "Standard",
      "title": "天气信息",
      "content": "...",
      "image": {
        "url": "https://.../sunny.png",
        "accessibilityText": "晴天图标"
      }
    }
  }
}

冷启动优化
使用 skill-cli test --cold-start 测试，建议控制在 1200ms 内

上下文压缩
采用增量编码（Delta Encoding），存储体积减少 70%：

function compressContext(prev: Context, curr: Context) {return Object.keys(curr).filter(k => prev[k] !== curr[k]);
}

服务调用超时
第三方 API 必须设置双超时：

# skill.config.yaml
timeouts:
  connect: 1500
  read: 3000

import {SkillCrypto} from '@moxun/skill-sdk';

const encrypted = SkillCrypto.encrypt(
  userData, 
  process.env.SKILL_SECRET
);

const bannedWords = ['赌博', '毒品'];

function safeResponse(text: string) {return bannedWords.some(w => text.includes(w)) 
    ? '内容包含违规词汇'
    : text;
}