Agent Skills

Ti RTC 提供了一组面向 AI agents 的 skill 包。

这些 Skill 的目标不是重复写一遍公开文档，而是把高频动作收成一个低上下文 agent 也能稳定执行的说明书。对外用户有两种使用方式：

• 人先看公开文档，再让 AI 帮自己执行
• 直接安装 Skill，用一句提示词把任务交给 AI

当前已经公开的 CLI 相关 skill 主要覆盖两类高频动作：生成连接 Token、启动本地推流方。收流方的本地 Web 预览能力已经在 CLI 中正式提供，但目前还没有单独拆成一个独立 skill package；需要这条链路时，直接结合 DevTools CLI 使用指南 即可。

获取与安装

当前 skill 仓库地址：

• tangeai/tirtc-skills

先把仓库下载到本地：

git clone git@github.com:tangeai/tirtc-skills.git
cd tirtc-skills

然后按照你所使用 Agent 工具的安装方式，把对应 skill 目录安装到本地技能目录。

目前仓库 README 已给出 Claude Code 和 Codex 的安装方法，直接按仓库说明操作即可。

Skill 列表

tirtc-cli-token-issue

这个 skill 用于为指定 remote_id 生成连接 token。

• 适用场景：本地联调、临时给某个设备生成连接 token；
• 可以同时拿到 token 和二维码 PNG 路径；

使用前先准备环境变量：

export TIRTC_CONN_ACCESS_ID="<ACCESS_ID>"
export TIRTC_CONN_SECRET_KEY="<SECRET_KEY>"

提示词可以直接写成：

给 <remote_id> 生成 token

如果你希望显式指定 skill，也可以这样写：

使用 tirtc-cli-token-issue，给 <remote_id> 生成 token

Agent 的最终输出示例如下：

⏺ 签发成功：

  remote_id: TESTAAAAAAAA

  token:
  v1.eyJzdWIi...o

  二维码 PNG:
  /Users/.../token-TESTAAAAAAAA-TESTAAAAAAAA-1775745043854.png

  需要直接打开二维码预览吗？

tirtc-cli-server-session

这个 Skill 用于启动一个本地推流方，给客户端做联调，覆盖：

• 基于本地 MP4 开始推流，接受客户端的连接
• 在已有 session 上发送命令
• 查看并回复远端命令
• 发送流消息
• 导出日志和报告
• 停止当前机器上的 host session

它不负责 token 签发。需要 token 时，先使用 tirtc-cli-token-issue。

启动服务前，用户至少要准备：

• 设备启动组合字符串（提示词里也可以沿用 CLI 字段名 license）
• 本地 MP4 路径
• audio_stream_id
• video_stream_id

其中设备启动组合字符串（提示词里常写成 license）和本地 MP4 路径不能省略；这是当前 CLI 启动推流方时最容易漏掉、但必须明确提供的两项事实。

如果是 Android Example 联调，可直接使用：

• audio_stream_id = 10
• video_stream_id = 11

提示词可以直接写成：

帮我启动一个本地推流方给客户端联调，device_id 是 XXX，device_secret_key 是 YYY，MP4 路径是 PATH，audio_stream_id=10，video_stream_id=11。

或者：

用这个 sessionId <xxx-xxx-xxx> 发送一条 command request，`cmdw` 是 7953，内容是 time?

或者：

停止当前机器上的所有 TiRTC host session。

如果你希望显式指定 Skill，也可以这样写：

使用 tirtc-cli-server-session，帮我启动一个本地推流方给客户端联调，device_id 是 XXX，device_secret_key 是 YYY，MP4 路径是 PATH，audio_stream_id=10，video_stream_id=11。

这个 Skill 的默认行为是：

• 每次执行前先刷新 tirtc-devtools-cli@latest
• 启动 server 时先调用 CLI 自带的 init 生成模板，再回填最小 server.toml
• 直接执行 service start，不要求用户手工先跑 media assets prepare
• 启动成功后返回 sessionId
• 后续所有 session 内操作都显式带 --session <SESSION_ID>

收流方目前怎么配合 Agent

当前 skill 仓库里还没有一个单独命名的“收流方本地预览” skill package，但 CLI 已经提供了正式入口：

• client start --token <token>：启动一个本地收流方，并自动挂载浏览器预览
• [client]：声明目标 remote_id、音视频 stream_id 和 consumer = "web_preview"

如果你需要让 Agent 帮你完成这条链路，推荐这样配合：

1. 先准备好 client.toml，至少填好 [client]
2. 如需临时签发 token，先使用 tirtc-cli-token-issue
3. 再让 Agent 执行 tirtc-devtools-cli --config ./client.toml client start --token "<TOKEN>"
4. 打开返回的本地预览地址，在浏览器中查看远端音视频

可以直接给 Agent 这样的提示词：

帮我用 tirtc-devtools-cli 启动一个本地收流方预览远端流，配置文件是 ./client.toml，token 是 <TOKEN>。

如果你想先了解完整手工步骤、配置示例和排查方法，直接看 DevTools CLI 使用指南。