Agent Skills

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

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

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

获取与安装

当前 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 用于为指定 peer_id 生成连接 token。

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

使用前先准备环境变量：

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

提示词可以直接写成：

给 <peer_id> 生成 token

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

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

Agent 的 最终输出示例如下：

⏺ 签发成功：

  peer_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。

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

• license
• 本地 MP4 路径
• audio_stream_id
• video_stream_id

其中 license 和本地 MP4 路径不能省略；这是当前 CLI 启动推流方时最容易漏掉、但必须明确提供的两项事实。

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

• audio_stream_id = 10
• video_stream_id = 11

提示词可以直接写成：

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

或者：

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

或者：

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

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

使用 tirtc-cli-server-session，帮我启动一个本地推流方给客户端联调，license 是 XXX，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>