用途
trtc-chat 是一个「内部聊天(IM)集成」领域技能,属于 tencent-rtc/agent-skills 中的 TRTC 技能体系。它面向聊天集成场景,按 slice 最佳实践生成代码。根据资料,该技能不是独立的调度入口:必须在 trtc/SKILL.md 完成 §-1 的提示上报与产品路由(product=chat)之后,才能 Read 本文件进入。资料明确当前支持的范围为 Chat × Web,即 Vue 3 与 tuikit-atomicx-vue3;其他平台或框架暂未提供。
主要能力(依据资料)
- 以阶段状态机推进集成:phase 依次为 detect(探测 + session 初始化)、collect_credentials(收集 SDKAppID / SecretKey)、collect_mode(Full / Direct)、scaffold(脚手架)、slices(一轮一 slice)、done(收尾)。
- 路径分流:优先级 0 为知识咨询 → Path D(经 Root 路由至 docs/SKILL.md);1 为减法/维护/报错 → Path C;2 为 phase=done 且已有 tuikit 依赖 → Path B;3 为已依赖 tuikit-atomicx-vue3 → Path B;4 为新项目或未依赖 → Path A。
- 项目探测:通过 references/01-detect-project.md 与 references/08-state-config.md 定位项目根并写入 project_state.project_root;非 Vue3 平台会以 BLOCKED: unsupported_platform 阻断。
- 会话状态管理:以 {projectRoot}/.trtc-session.yaml 作为唯一 session,通过 python3 -m tools.session read / write-batch 读写;active_flow=onboarding 覆盖 detect 至 slices 阶段。
- 知识库与索引解析:通过 python3 -m tools.kb resolve <path> 读取 knowledge-base 条目(如 chat/web/index.yaml),references/、flows/ 等技能自带文件直接 Read。
- 交付与收尾:Path A 交付物包含 {projectRoot}/WHAT-TO-DO-NEXT.md。
使用方式(资料中出现的命令与入口)
调用入口(唯一):先由 trtc/SKILL.md 完成路由,再 Read 本文件。若无 session,则创建:
python3 -m tools.session create --product chat --platform web --intent integrate-scenario --project-root "<projectRoot>"
python3 -m tools.session write-batch --updates '{
"active_domain_skill": "trtc-chat",
"active_flow": "onboarding",
"project_state": {"project_root": "<projectRoot>"},
"flow_state": {"chat": {"phase": "detect", "chat_path": "A"}}
}' --expected-version <N>
Path A/B 进入 onboarding:
python3 -m tools.flow enter --phase onboarding --product chat --platform web
资料同时要求:python3 -m tools.* 的工作目录须为 skills/trtc 或 skills/trtc-chat(后者含 tools/ shim,委托到 trtc),禁止在用户项目根执行;禁止执行 references/02~05 中出现的旧 send、send-query 或 skill_start 文本;本技能不得直接调用 reporting.py send、send-query、send-docs-query,也不得构造 method=event 路径节点记录,用户 Prompt 由 Root reporting.py prompt --input-stdin 处理。
适用场景
- 在 Vue 3 项目中新建聊天(IM)集成(Path A)。
- 项目已依赖 tuikit-atomicx-vue3,或 phase=done 且存在 tuikit 依赖时继续集成(Path B)。
- 对已有集成做减法、维护或处理报错(Path C)。
- 纯 IM 知识咨询(Path D)不属于本文件范围,应由 Root 路由至 docs/SKILL.md。
限制与约束(资料明示)
- 必须先经过 Root 调度与路由,直接 Read 本文件属违规,需回到 ../trtc/SKILL.md 从 §-1 重走。
- 只支持 Chat × Web(Vue3 / tuikit-atomicx-vue3);非 Vue3 会阻断。
- 未获用户输入前,禁止默认 integration_mode(full/direct)或凭证。
- 一轮仅一个 slice,禁止预读下一轮 slice;Path B 禁止 reopen-add-feature。
- 阶段推进需有工具执行结果作为证据,证据缺失视为未执行。
- 阻断码包括 BLOCKED: project_root_unresolved、session_not_initialized、phase_gate_not_satisfied、credential_missing、unsupported_platform、dispatcher_bypass。
资料未说明收费、价格、更多平台支持、具体功能效果或完整使用步骤,以上未提及内容暂未提供。