Superpowers Skill 入门指南：从零构建你的第一个技能扩展

5次阅读

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

Superpowers Skill 是一种允许开发者扩展智能助手能力的框架。简单来说，它让你可以教会智能助手完成特定任务，比如查询天气、控制智能家居或者处理业务数据。想象一下，你可以让助手帮你订咖啡、查快递或者管理待办事项——这些都是通过构建技能来实现的。

典型应用场景包括：

智能家居控制（开关灯、调节温度）
企业办公自动化（会议安排、数据查询）
生活服务（外卖订购、出行规划）
娱乐交互（游戏、故事讲述）

在开发 Superpowers Skill 时，你首先需要决定通信协议。主要有两种选择：

REST API
优点：实现简单，无状态，适合大多数基础场景
缺点：每次请求都需要建立新连接，实时性较差
WebSocket
优点：长连接，适合需要持续双向通信的场景
缺点：实现复杂，服务器资源消耗更大

对于初学者，建议从 REST API 开始。它足够应对 90% 的基础技能需求，且学习曲线更平缓。

让我们用 Node.js 构建一个最简单的 ”Hello World” 技能。你需要先安装 Node.js 和 npm。

创建项目文件夹并初始化 package.json

mkdir my-first-skill && cd my-first-skill
npm init -y
npm install express body-parser

创建 index.js 文件：

const express = require('express');
const bodyParser = require('body-parser');

const app = express();
app.use(bodyParser.json());

// 认证中间件
app.use((req, res, next) => {const authToken = req.headers['authorization'];
  if (!authToken || authToken !== 'Bearer your-secret-token') {return res.status(401).json({error: 'Unauthorized'});
  }
  next();});

// 处理技能请求
app.post('/skill', (req, res) => {const { intent} = req.body;

  if (intent === 'greet') {
    return res.json({
      response: 'Hello from your first Superpowers Skill!',
      session: req.body.session
    });
  }

  res.status(400).json({error: 'Unknown intent'});
});

const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {console.log(`Skill server running on port ${PORT}`);
});

认证中间件：检查请求头中的 Authorization 令牌
技能端点：处理 POST 请求，根据不同的 intent 返回响应
会话保持：返回时携带原始 session 对象，维持对话上下文

Serverless 环境中，冷启动可能导致首次响应延迟高达 1 - 2 秒。解决方案：

保持最小化依赖（我们的示例仅使用 Express）
使用较小的运行环境（如 256MB 内存）
设置定期 ping 保持实例活跃

测试数据：优化后冷启动时间从 1.8s 降至 200ms。

当技能突然变热门时，你需要：

实现请求队列
设置速率限制（如 100 请求 / 秒）
使用缓存响应常见请求

// 使用 express-rate-limit 的示例
const rateLimit = require('express-rate-limit');

const limiter = rateLimit({
  windowMs: 15 * 60 * 1000, // 15 分钟
  max: 100 // 每个 IP 限制 100 请求
});

app.use(limiter);

错误：”Invalid authorization token”
检查 Bearer token 是否匹配
确保请求头格式正确：Authorization: Bearer your-token
错误：”Missing authentication header”
确认请求确实发送了 Authorization 头
检查中间件是否正确处理了该头

隐私问题：未明确声明数据收集
功能不完整：核心功能无法正常工作
响应超时：API 响应超过 5 秒
文档不全：缺少使用说明或隐私政策

随着技能复杂化，你需要：

使用路由分离不同功能模块
引入状态管理处理多轮对话
实现插件系统支持功能扩展
添加详细的日志记录

// 在 routes/ 目录下拆分:
- weather.js
- calendar.js
- reminder.js

// 主文件中:
app.use('/weather', require('./routes/weather'));
app.use('/calendar', require('./routes/calendar'));

任务：实现一个天气查询技能

要求：