Miku-Live Skill

面向直播业务场景的 Miku-Live Skill，帮助你用自然语言完成日常直播资源管理与查询。

该 Skill 面向七牛云 Miku 快直播日常运维与管理场景，让你通过自然语言快速完成直播空间、直播流、域名、证书、录制、转码模板、统计、API Key 等资源相关操作。适合在需要高频查询与配置直播资源时使用，可显著降低操作门槛并提升处理效率。

使用场景

直播空间管理

空间

查询空间列表、创建空间、更新空间配置。

直播资源运维

流 / 域名 / 证书

直播流、域名、证书、录制、转码模板的日常操作。

统计与分析

统计

直播统计、流量与历史记录相关查询。

安装与配置

选择你喜欢的方式，让 Agent 获得 Miku-Live 能力。

告诉 Agent

用自然语言告诉 Agent 需要安装的技能和后续用途。

请安装 miku-live 技能
下载地址：https://docs.qnsdk.com/Miku-Live-Skill.zip

配置凭证

获取 AK / SK 并存入环境变量。

export MIKU_LIVE_ACCESS_KEY="your_access_key"
export MIKU_LIVE_SECRET_KEY="your_secret_key"

将你的 Access Key 和 Secret Key 写入环境变量后，再继续执行相关调用。

试试这些提示

这些示例在配置好凭证后可以直接复制执行，不需要先替换空间名或流名。

获取直播空间列表

帮我获取当前账号下的直播空间列表，并说明每个空间后续可以管理哪些资源。

查看空间域名配置

先获取当前账号下的直播空间列表，然后逐个返回每个空间已绑定的下行播放域名和上行推流域名。

查看转码模板列表

帮我获取当前账号下的转码模板列表，并按模板名称整理输出。

查看 API Key 列表

帮我获取当前账号下的 API Key 列表，并按名称整理输出。

SKILL.md

七牛云 Miku 快直播 API Skill

把中文请求映射为 Miku API action_key，再按接口总表完成归位、签名和执行。

速查索引

文件	用途
`references/schemas.md`	输入/输出 Schema
`references/interface-catalog.md`	接口清单与参数归位
`references/signing.md`	签名与执行规则

前置条件

凭证优先级：请求体 ak/sk > 环境变量 MIKU_LIVE_ACCESS_KEY/MIKU_LIVE_SECRET_KEY；缺失时不做真实调用。
只按需读取 references/，不要把整份参考文档一次性展开到上下文里。

最小执行流程

路由：有 action 直接执行；有 intent 则映射为完整 action_key。
校验：输入/输出契约遵循 references/schemas.md。
归位：参数归位与错误码遵循 references/interface-catalog.md。
鉴权执行：签名与回退策略遵循 references/signing.md。

命令参考

输入统一使用 action 或 intent，且必须提供 params_json；action 优先。
执行顺序：解析 action_key -> 校验 schema -> 参数归位 -> 替换 Host/Path 占位符 -> 签名 -> 执行。
只校验、不落真实请求，或要生成代码/脚本/示例时，优先 dry_run=true。
最小输入：{"action":"bucket-management/list_buckets","params_json":{},"dry_run":false}。

意图映射

强制特例：“帮我获取到直播空间列表 / 直播空间有哪些 / 查询空间列表” 一律映射到 bucket-management/list_buckets。

用户意图	action_key
查看直播空间列表	`bucket-management/list_buckets`
查看或更新空间配置	`bucket-management/get_bucket_config` / `bucket-management/update_bucket_config`
创建、查询、禁播或删除流	`stream-management/create_stream` / `stream-management/get_stream_info` / `stream-management/ban_stream` / `stream-management/delete_stream`
绑定或解绑播放/推流域名	`domain-management/bind_` / `domain-management/unbind_`
查询统计	`statistics/query_*`

资源词决定模块：空间/bucket -> bucket-management；流 -> stream-management；播放域名/推流域名 -> domain-management；证书 -> certificate-management；录制/截图 -> recording-management；转码模板 -> live-stream-transcoding-template；统计/日志 -> statistics；API Key/播放地址/推流地址 -> utilities。
动作词决定前缀：列表 -> list_*；详情/配置 -> get_*；创建 -> create_* / add_*；更新 -> update_* / edit_*；删除 -> delete_*；绑定/解绑 -> bind_* / unbind_*；启动/停止 -> start_* / stop_*；禁播/解禁 -> ban_* / unban_*。
只在 references/interface-catalog.md 存在精确 action_key 时执行；资源类型或目标不明确时先追问；“列表/查询/看看有哪些”默认选只读接口。

安全规则

不输出完整 sk、证书私钥、Token、Authorization 头等敏感信息。
删除、解绑、停止、禁播等危险操作在目标不明确时先确认。
GET/DELETE 默认无 body，除非接口总表显式要求。
参数必须严格放入 host/path/query/body 对应位置。

输出格式

必须返回 resolved_action；成功优先返回 result。
缺参时返回带位置前缀的 missing_required，如 query.domain、host.bucket_name、path.stream_key。
dry run 显式返回 dry_run: true；可附带脱敏后的 raw_response。

错误处理

缺少 action|intent 或 params_json：直接报错并停止。
参数问题统一使用 PARAM_POSITION_MISMATCH、UNDECLARED_PARAM、PARAM_VALUE_CONFLICT。
缺少凭证时停止真实执行。
只有在未收到 HTTP 响应时才按 signing.md 回退语言；收到响应后直接返回。

交付前检查

当输出包含 HTML、JS、TS、React、Shell、Curl 或请求示例时，先把每个调用还原为 action_key + params_json。
交付前检查：action_key 存在、参数位置正确、必填项完整、query 键名大小写匹配、未声明参数未混入。
可执行时优先对每个调用做 dry_run=true 预检；任一调用失败时先修正或提示缺失信息，不直接交付。
默认不展开自检过程；仅在失败或用户要求时返回自检明细。

文件原文

SKILL.md

路径：SKILL.md

主规范：最小执行流程、速查索引与交付前自检约束。

---
name: miku-live
description: Resolve intent into Qiniu Miku Live management API action keys, validate parameter placement against the API catalog, and execute signed requests safely.
type: tool
best_for:
  - "Intent-to-action mapping for Qiniu Miku Live APIs"
scenarios:
  - "List live buckets or inspect bucket configuration"
  - "Manage streams, domains, transcoding templates, and API keys"
---

# 七牛云 Miku 快直播 API Skill

把中文请求映射为 Miku API `action_key`，再按接口总表完成归位、签名和执行。

## 速查索引

| 文件 | 用途 |
| --- | --- |
| `references/schemas.md` | 输入/输出 Schema |
| `references/interface-catalog.md` | 接口清单与参数归位 |
| `references/signing.md` | 签名与执行规则 |

## 前置条件

- 凭证优先级：请求体 `ak/sk` > 环境变量 `MIKU_LIVE_ACCESS_KEY/MIKU_LIVE_SECRET_KEY`；缺失时不做真实调用。
- 只按需读取 `references/`，不要把整份参考文档一次性展开到上下文里。

## 最小执行流程

1. 路由：有 `action` 直接执行；有 `intent` 则映射为完整 `action_key`。
2. 校验：输入/输出契约遵循 `references/schemas.md`。
3. 归位：参数归位与错误码遵循 `references/interface-catalog.md`。
4. 鉴权执行：签名与回退策略遵循 `references/signing.md`。

## 命令参考

- 输入统一使用 `action` 或 `intent`，且必须提供 `params_json`；`action` 优先。
- 执行顺序：解析 `action_key` -> 校验 schema -> 参数归位 -> 替换 Host/Path 占位符 -> 签名 -> 执行。
- 只校验、不落真实请求，或要生成代码/脚本/示例时，优先 `dry_run=true`。
- 最小输入：`{"action":"bucket-management/list_buckets","params_json":{},"dry_run":false}`。

## 意图映射

- 强制特例：“帮我获取到直播空间列表 / 直播空间有哪些 / 查询空间列表” 一律映射到 `bucket-management/list_buckets`。

| 用户意图 | action_key |
| --- | --- |
| 查看直播空间列表 | `bucket-management/list_buckets` |
| 查看或更新空间配置 | `bucket-management/get_bucket_config` / `bucket-management/update_bucket_config` |
| 创建、查询、禁播或删除流 | `stream-management/create_stream` / `stream-management/get_stream_info` / `stream-management/ban_stream` / `stream-management/delete_stream` |
| 绑定或解绑播放/推流域名 | `domain-management/bind_*` / `domain-management/unbind_*` |
| 查询统计 | `statistics/query_*` |

- 资源词决定模块：`空间/bucket -> bucket-management`；`流 -> stream-management`；`播放域名/推流域名 -> domain-management`；`证书 -> certificate-management`；`录制/截图 -> recording-management`；`转码模板 -> live-stream-transcoding-template`；`统计/日志 -> statistics`；`API Key/播放地址/推流地址 -> utilities`。
- 动作词决定前缀：`列表 -> list_*`；`详情/配置 -> get_*`；`创建 -> create_* / add_*`；`更新 -> update_* / edit_*`；`删除 -> delete_*`；`绑定/解绑 -> bind_* / unbind_*`；`启动/停止 -> start_* / stop_*`；`禁播/解禁 -> ban_* / unban_*`。
- 只在 `references/interface-catalog.md` 存在精确 `action_key` 时执行；资源类型或目标不明确时先追问；“列表/查询/看看有哪些”默认选只读接口。

## 安全规则

- 不输出完整 `sk`、证书私钥、Token、`Authorization` 头等敏感信息。
- 删除、解绑、停止、禁播等危险操作在目标不明确时先确认。
- `GET/DELETE` 默认无 body，除非接口总表显式要求。
- 参数必须严格放入 `host/path/query/body` 对应位置。

## 输出格式

- 必须返回 `resolved_action`；成功优先返回 `result`。
- 缺参时返回带位置前缀的 `missing_required`，如 `query.domain`、`host.bucket_name`、`path.stream_key`。
- dry run 显式返回 `dry_run: true`；可附带脱敏后的 `raw_response`。

## 错误处理

- 缺少 `action|intent` 或 `params_json`：直接报错并停止。
- 参数问题统一使用 `PARAM_POSITION_MISMATCH`、`UNDECLARED_PARAM`、`PARAM_VALUE_CONFLICT`。
- 缺少凭证时停止真实执行。
- 只有在未收到 HTTP 响应时才按 `signing.md` 回退语言；收到响应后直接返回。

## 交付前检查

- 当输出包含 HTML、JS、TS、React、Shell、Curl 或请求示例时，先把每个调用还原为 `action_key + params_json`。
- 交付前检查：`action_key` 存在、参数位置正确、必填项完整、query 键名大小写匹配、未声明参数未混入。
- 可执行时优先对每个调用做 `dry_run=true` 预检；任一调用失败时先修正或提示缺失信息，不直接交付。
- 默认不展开自检过程；仅在失败或用户要求时返回自检明细。