Skill: huang-zhibin/volcengine-rtc-device-control (version 1.0.1)

--- name: volcengine-rtc-device-control description: 火山引擎AI音视频互动设备控制技能。用于控制当前硬件设备的行为，包含左摇头、右摇头、调大音量、调小音量、设备关机、调亮屏幕、调暗屏幕、温度调节等常见硬件控制行为。当需要生成或解析设备控制指令时使用此技能。 --- # 火山引擎AI音视频互动设备控制技能 本技能用于控制当前硬件设备，定义了统一的交互协议。 ## 核心功能 本技能支持以下核心硬件控制能力： 仅控制火山RTC音视频绑定设备 - 左摇头 (pan_left) - 右摇头 (pan_right) - 调节音量大小 (volume_up) - 调亮屏幕 (brightness_up) - 调暗屏幕 (brightness_down) - 设备关机 (power_off) - 支持开心表情（emoji_happy） - 支持伤心表情（emoji_sad） - 支持设备震动（device_shock） ## 安全机制 - 指令通道：仅通过火山RTC官方信令（`rtc.volcengine.com`）传输 - 身份认证：设备遵守火山引擎RTC身份鉴权，未认证指令直接丢弃 - 传输加密：全程TLS 1.3加密，防篡改/劫持 - 权限控制：仅当前登录用户可操作，支持操作日志审计 ## 交互协议定义 所有的设备控制指令均采用 JSON 格式进行交互。详细的协议定义和参数说明，请参考 [protocol.md](references/protocol.md)。 ## 使用说明 - 当用户下达自然语言指令（例如：“向左转一下”、“声音大一点”、“屏幕太亮了调暗点”、“关闭设备”、“展示开心表情包”）时，Agent 会将这些意图转换为 `references/protocol.md` 中定义的 JSON 协议格式，并通过底层通信链路发送给硬件设备。

path: metadata.json
content: {
  "name": "volcengine-rtc-device-control",
  "version": "1.0.1",
  "description": "火山引擎RTC音视频设备控制技能（严格权限版）",
  "author": "@huang-zhibin",
  "license": "MIT-0",
  // 仅声明必要权限，无通配符
  "permissions": ["rtc:device:control:volcengine"],
  "security": {
    "riskLevel": "low",
    // 仅限定官方合法域名
    "networkEndpoints": ["https://rtc.volcengine.com"]
  }
}

path: references/protocol.md
content: # 设备控制交互协议 (Protocol Specification)使用说明

- 所有设备控制指令均采用 `send_command` 作为顶层指令名，并包含一个结构化的 `parameters` 对象，用来详细描述指令的意图及所需的额外参数
- 可自定义增加设备控制指令，如果references/protocols.md不支持的指令，则回复我还不支持这个控制指令，您可以切换命令或者话题类似的自然语言表述即可。
- 当用户下达自然语言指令（例如：“向左转一下”、“声音大一点”、“屏幕太亮了调暗点”、“关闭设备”、“展示开心/伤心表情”）时，Agent 会将这些意图转换为 `references/protocol.md` 中定义的 JSON 协议格式，并通过底层通信链路发送给硬件设备。
- 可以支持多个设备控制指令一起返回，比如当你开心时候，你声音变大一些并且展示开心的表情包
- 调用该skills执行设备控制时，需要返回设备控制的json指令


统一的 JSON 基础结构如下：

```json
{
  "name": "send_command",
  "parameters": {
    "command_name": "<指令枚举值>",
    "description": "<指令用途的简短描述>",
    // ... 除命令外的额外字段（如 angle, step, delay 等）
  },
  "required": ["command_name", /* 其他必须的额外字段 */]
}
```

以下是各项硬件控制指令的具体协议定义：

## 1. 左摇头 (pan_left)
控制设备向左转动。

```json
{
  "name": "send_command",
  "parameters": {
    "command_name": "pan_left",
    "description": "控制设备向左转动",
    "angle": 15,
    "speed": "normal"
  },
  "required": ["command_name"]
}
```
* **额外字段说明**:
  * `angle` (Number, 可选): 转动的角度，默认 15 度。
  * `speed` (String, 可选): 转动速度，可选值 `slow`, `normal`, `fast`。

## 2. 右摇头 (pan_right)
控制设备向右转动。

```json
{
  "name": "send_command",
  "parameters": {
    "command_name": "pan_right",
    "description": "控制设备向右转动",
    "angle": 15,
    "speed": "normal"
  },
  "required": ["command_name"]
}
```
* **额外字段说明**:
  * `angle` (Number, 可选): 转动的角度，默认 15 度。
  * `speed` (String, 可选): 转动速度，可选值 `slow`, `normal`, `fast`。

## 3. 调大音量 (volume_up)
调大设备的音量。

```json
{
  "name": "send_command",
  "parameters": {
    "command_name": "volume_up",
    "description": "调大设备音量",
    "level": 50,
    "step": 10
  },
  "required": ["command_name"]
}
```
* **额外字段说明**:
  * `step` (Number, 可选): 每次调大音量的步长，默认 10。
  * `level` (Number, **必填**): 音量级别，范围 0-100。

## 4. 调小音量 (volume_down)
调小设备的音量。

```json
{
  "name": "send_command",
  "parameters": {
    "command_name": "volume_down",
    "description": "调小设备音量",
    "level": 50,
    "step": 10
  },
  "required": ["command_name"]
}
```
* **额外字段说明**:
  * `step` (Number, 可选): 每次调小音量的步长，默认 10。
  * `level` (Number, **必填**): 音量级别，范围 0-100。


## 5. 调亮屏幕 (brightness_up)
增加设备屏幕的亮度。

```json
{
  "name": "send_command",
  "parameters": {
    "command_name": "brightness_up",
    "description": "增加设备屏幕的亮度",
    "step": 10
  },
  "required": ["command_name"]
}
```
* **额外字段说明**:
  * `step` (Number, 可选): 每次增加亮度的步长，默认 10。

## 6. 调暗屏幕 (brightness_down)
降低设备屏幕的亮度。

```json
{
  "name": "send_command",
  "parameters": {
    "command_name": "brightness_down",
    "description": "降低设备屏幕的亮度",
    "step": 10
  },
  "required": ["command_name"]
}
```
* **额外字段说明**:
  * `step` (Number, 可选): 每次降低亮度的步长，默认 10。

## 7. 设备关机 (power_off)
关闭硬件设备。

```json
{
  "name": "send_command",
  "parameters": {
    "command_name": "power_off",
    "description": "关闭硬件设备",
    "delay": 0
  },
  "required": ["command_name"]
}
```
* **额外字段说明**:
  * `delay` (Number, 可选): 延迟关机时间（秒），0 为立即关机。

## 8. 表情开心 (emoji_happy)
展示开心表情包。

```json
{
  "name": "send_command",
  "parameters": {
    "command_name": "emoji_happy",
    "description": "展示开心表情",
  },
  "required": ["command_name"]
}
```

  ## 9. 表情伤心 (emoji_sad)
展示伤心表情包。

```json
{
  "name": "send_command",
  "parameters": {
    "command_name": "emoji_sad",
    "description": "展示伤心表情",
  },
  "required": ["command_name"]
}
```
  ## 10. 设备震动 (device_shock)
开启设备震动。

```json
{
  "name": "send_command",
  "parameters": {
    "command_name": "device_shock",
    "description": "开启设备震动",
  },
  "required": ["command_name"]
}
```


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)