tmeet-meeting-templates
腾讯会议预定设置模版管理。将常用会议的设置(入会限制、等候室、水印、自动录制、自动转写等)保存为可复用模版,下次预定会议时可直接指定或从列表中选用模版,无需每次逐项重新配置。
When to use
- 用户说"把 XX 会议的设置存为模版""保存成会议模版""下次预定会议时给我这个选项""帮我创建一个会议模版"等 → 触发创建模版流程:默认引导用户提供一场想参考的会议来创建模版;用户也可以选择不参考任何会议,直接逐项配置来创建模版。
- 用户说"帮我预定会议""创建会议""约个会"等,且尚未指定完整设置 → 触发套用模版流程:
- 若用户已在同一句话里指定了模版(如"用分享会模版建个会")→ 直接匹配并套用该模版,无需再问是否使用模版。
- 若用户未指定模版 → 先询问"是否需要使用已保存的会议模版",用户确认需要后再列出
templates/下所有可用模版供其挑选;用户选定后再询问缺失的必填信息(主题、开始/结束时间等),最后调用tmeet meeting create创建。 - 用户不需要模版、已给出完整设置时,正常调用 tmeet skill 创建会议即可,无需触发本 skill。
Steps
步骤 0 · 连接检查(每次进入本 skill 必做,强制前置,无绕过路径)
本 skill 无论是"创建模版"还是"套用模版",都依赖 tmeet(腾讯会议)skill 完成实际的 meeting get / meeting create 调用,必须先确认 tmeet 已安装且已登录才能继续,不提供跳过连接直接生成本地模版草稿等任何绕过方式。
- 执行
tmeet auth status检查登录状态。 - 已登录:直接进入下方"创建模版"或"套用模版"对应流程。
- 未登录 / 返回
user config is empty/tmeet命令不存在:
- 告知用户当前尚未连接腾讯会议,本 skill 依赖 tmeet 拉取/创建真实会议数据,无法在未连接状态下继续。
- 询问用户是否同意现在安装并连接。
- 用户同意后:帮用户安装腾讯会议 CLI(https://github.com/TencentCloud/tencentmeeting-cli),执行:
bash npm install -g @tencentcloud/tmeet
安装完成后执行tmeet auth login(后台运行以捕获授权链接,将链接完整展示给用户,引导其在浏览器打开完成 OAuth 授权),授权完成后用tmeet auth status确认登录成功,再继续后续流程。命令细节见 tmeet skill 的"安装与初始化""认证"两节。
- 用户不同意连接:明确告知本 skill 无法继续(无法保存/套用会议模版),流程到此结束,不做任何降级处理。
创建模版
- 询问用户创建方式:默认引导用户提供一场他希望参考的会议("有没有一场现有会议,设置比较符合你想要的模版?可以给我会议号或告诉我是哪场会议");同时告知用户也可以选择不参考任何会议,直接从设置项列表里逐项勾选来创建模版。按用户选择进入下方 A 或 B 分支。
A. 参考一场现有会议
- 通过
tmeet meeting get --meeting-id <id>或--meeting-code <code>获取该会议的完整设置(settings字段)。若用户在近期会议里找不准,可用tmeet meeting list-ended/tmeet meeting list列出候选清单交用户选择,不自行判断哪场符合。 - 从
settings中提取以下关键字段,映射为tmeet meeting create支持的命令行参数:
| 会议详情字段 | create 命令参数 | 取值示例 |
|---|---|---|
only_user_join_type |
--join-type |
1=所有成员,2=仅受邀,3=仅企业内部 |
auto_in_waiting_room |
--waiting-room |
true/false |
water_mark_type |
--water-mark-type |
0=单排,1=双排,2=关闭(注意:详情接口的取值含义需与 create 参数核对,如有出入以 create 参数说明为准) |
audio_watermark |
--audio-watermark |
true/false |
auto_record_type |
--auto-record-type |
none/local/cloud |
auto_asr |
--auto-asr |
true/false |
- 把提取到的设置展示给用户确认,允许用户在此基础上调整个别项(如"其他都保留,等候室我想改成开启")。
B. 不参考会议,直接创建
- 向用户完整列出所有可配置的设置项及可选取值,让用户逐项选择(未提及的项使用
tmeet meeting create的默认值,见下表"默认值"列):
| 设置项 | create 命令参数 | 可选取值 | 默认值 |
|---|---|---|---|
| 入会限制 | --join-type |
1=所有成员,2=仅受邀,3=仅企业内部 | 1 |
| 等候室 | --waiting-room |
开启/关闭 | 关闭 |
| 主持人自动录制 | --auto-record-type |
none=关,local=本地,cloud=云录制 | none |
| 文字水印 | --water-mark-type |
0=单排,1=双排,2=关闭 | 视个人/企业账号默认设置而定 |
| 音频水印 | --audio-watermark |
开启/关闭 | 视企业设置而定 |
| 自动文字转写(ASR) | --auto-asr |
开启/关闭 | 关闭 |
| 会议密码 | --password |
4~6 位数字,可留空 | 无密码 |
| 会议类型 | --meeting-type |
0=普通会议,1=周期性会议 | 0(模版一般只针对普通会议的通用设置,周期规则通常按每次实际预定单独设置,非必须存入模版) |
- 用户逐项选定后,汇总成一份设置清单向用户确认无误。
创建模版收尾(A/B 共用)
- 向用户确认模版名称(如未指定,用会议主题或场景类型命名,如"分享会模版""站会模版")。
- 用 Write 工具在本 skill 的
templates/目录下创建<template_id>.json,字段结构如下:
json { "template_id": "唯一标识,英文短横线命名", "template_name": "展示给用户的模版名称", "source_meeting": { "subject": "来源会议主题(走B分支时此字段省略或写\"手动创建\")", "meeting_code": "来源会议号,走B分支时省略(不记录 meeting_id)", "captured_at": "创建日期" }, "description": "一句话描述该模版适用场景和核心设置", "cli_flags": { "join-type": 1, "waiting-room": false, "water-mark-type": 1, "audio-watermark": false, "auto-record-type": "none", "auto-asr": false }, "notes": ["对关键取值含义的补充说明"] } - 告知用户模版已保存,之后预定会议时会主动提供该模版选项。
套用模版(预定会议时)
- 先判断用户是否已在请求中直接指定模版(如"用分享会模版帮我建个会""按站会模版预定"):
- 若已指定:在templates/目录下按template_name/template_id匹配对应模版文件,匹配到后跳过第 1 步,直接进入第 2 步套用该模版;若指定的模版名找不到匹配项,告知用户未找到该模版,并展示当前可用模版列表供其重新选择。
- 若未指定:进入第 1 步。 - 用户未指定模版时,先询问是否需要使用已保存的会议模版(是/否),不要一开始就把模版列表甩给用户:
- 若用户选择"否" → 跳过模版,直接询问会议主题/时间等设置,按用户口述或默认设置创建。
- 若用户选择"是" → 列出templates/目录下所有*.json模版文件,展示template_name和description,让用户从列表中选择一个具体模版。 - 用户选定模版后(无论是步骤0直接指定还是步骤1选择得到),读取该模版的
cli_flags,作为tmeet meeting create的默认参数。 - 询问用户缺失的必填信息:会议主题
--subject、开始时间--start、结束时间--end(模版不包含这些信息,因为每次会议不同)。若为周期性会议还需询问周期规则。 - 拼装完整命令,向用户展示即将创建的会议信息(主题/时间/套用的模版设置),确认后执行
tmeet meeting create。 - 创建成功后按 tmeet skill 的标准回复格式展示会议主题/时间/会议号/入会链接。
Pitfalls
- 会议详情接口(
meeting get)返回的字段名和取值含义,与meeting create命令的参数取值可能不完全一致(例如水印字段的枚举值顺序),套用模版生成命令前,先用小范围测试或让用户确认最终生效的设置是否符合预期,不要盲目假设映射关系永远正确。 - 创建模版时严禁记录
meeting_id、参会人open_id、密码等敏感或会议专属信息,模版只保留可复用的"设置类"字段。 - 套用模版不代表跳过用户确认:创建会议前仍需按 tmeet skill 的规则向用户展示关键信息,不能因为"用了模版"而省略确认步骤。
- 若
templates/目录为空,直接跳过"列出模版"步骤,正常询问设置即可,不要提示报错。 - tmeet 未连接/未登录时,步骤0是强制前置检查,任何时候都不能绕过直接尝试"创建模版"或"套用模版",即便用户表述得很急切。
Verification
- 创建模版后,重新读取生成的 json 文件,确认字段完整且不含敏感信息。
- 套用模版创建会议后,用
tmeet meeting get --meeting-id <新会议id>核对实际生效的设置是否与模版一致。