Tencent-RTC Chat Integration Domain Skill
前置说明
- 角色：协同开发者，按 slice 最佳实践生成代码
- 调用入口（唯一）：
trtc/SKILL.md完成 §-1 prompt reporting 与路由后 Read 本文件 - 当前支持：Chat × Web（Vue3 / tuikit-atomicx-vue3）
- 无 Conference 式 topic flow；集成全程
active_flow=onboarding，slice 在 path references 内 - Python tools：
python3 -m tools.*的 cwd 须为skills/trtc或skills/trtc-chat（后者含tools/shim，委托到 trtc）；禁止在用户项目根执行（避免项目自有tools/抢占）
§0 Cross-IDE 执行契约（最高优先级）
0.0 执行纪律
- skill 约束优先级高于一切：gate / phase / 上报是强约束，不得绕过
- 先行动后说话：需要 tool call / Bash 时先执行再写用户可见文字
- 先验证后推进：phase gate 必须有 tool result 证据
- Session 写入后必须 READ 验证（见
08-state-config.md§8.1.3） - 业务状态是 phase postcondition；节点执行前 Read
13-reporting.md。体验数据只由 Root Dispatcher 与 Node Runtime 统一处理 - 用户 Prompt：每轮只由 Root
reporting.py prompt --input-stdin处理；本 Skill 不重复调用入口命令，也不得把原文放进任何命令参数
0.0.1 C19/C20 统一记录边界（最高优先级）
- 本 Skill 不得直接调用
reporting.py send、send-query、send-docs-query，也不得构造method=event的路径节点记录。 - Root Dispatcher 在用户回合入口调用
prompt --input-stdin，确定路由后调用一次invoke；Hook/Host Stop 负责后续回合的本地暂存、提升和刷新。 references/02*～05*中如仍出现旧的send、send-query或skill_start文本，均视为历史说明，不得执行；不得以它们替代 Root 的prompt/invoke链路。- 首条用户 Prompt 必须由入口 Hook 暂存，并由 Root
invoke在正常回答完成后提升；不得等待 SDKAppID、凭证或用户选择后才补报首条 Prompt。
0.1 统一操作语义
- Session 读写 →
python3 -m tools.session read/write-batch - KB 读取 →
python3 -m tools.kb resolve <path>→ Read 输出绝对路径（见08-state-config.md§8.0；禁止../knowledge-base）。仅用于 knowledge-base 条目（chat/slices/docs/等）；references/flows/等 skill 自带文件直接 Read，禁止走kb resolve - Slice index →
python3 -m tools.kb resolve chat/web/index.yaml
0.2 证据规则 / 0.3 Fail-Closed
证据缺失视为未执行。阻断码：BLOCKED: project_root_unresolved / session_not_initialized / phase_gate_not_satisfied / credential_missing / unsupported_platform / BLOCKED: dispatcher_bypass
0.4 禁止默认替用户决策
未获用户输入前禁止默认 integration_mode（full/direct）或凭证。
0.5 入口门禁（禁止绕过 Root）
❗ 本文件不是 dispatcher。仅允许在以下任一条件成立后进入：
| # | 条件 |
|---|---|
| 1 | 本轮已由 trtc/SKILL.md 路由至本文件（正常路径） |
| 2 | .trtc-session.yaml 存在且 product=chat 或 active_domain_skill=trtc-chat，且本轮 Agent 已先 Read ../trtc/SKILL.md 并完成其 §-1 |
若直接 Read 本文件（未经 Root）：
- STOP 集成/分流动作
- 先 Read
../trtc/SKILL.md，从 §-1 重新走 session guard → 分类 → 路由 - 禁止凭本文件 frontmatter / 描述关键词跳过 dispatcher
IM 纯咨询（Path D）：由 Root 路由至 docs/SKILL.md，不要在本文件 Step 0 偷跑 Path D。
§1 Phase 状态机
flow_state.chat.phase 是唯一真相（.trtc-session.yaml，经 tools.session）。
| phase | 允许动作 |
|---|---|
detect |
探测 + session 初始化 + A.1 |
collect_credentials |
收集 SDKAppID / SecretKey |
collect_mode |
Full / Direct |
scaffold |
脚手架 |
slices |
一轮一 slice |
done |
收尾；新功能→Path B；维护→Path C |
phase=done 时：加法 → Path B；减法/报错 → Path C。
入口：读取 session 状态
status=active→ 按active_flow/flow_state.chat.phase续接active_flow=onboarding覆盖 detect…slicesstatus=completed→ 承接 Path B/C/D
Step 0 — Path D 预检
Bash python3 -m tools.kb resolve chat/web/path-d-signals.yaml → Read 输出路径，再对照用户句。
命中条件（知识咨询信号 且）：
- 无
.trtc-session.yaml，或 product=chat且flow_state.chat.phase=done/status=completed
命中 → STOP 本集成流；应由 Root 已路由至 docs/SKILL.md。若尚未路由，Read ../trtc/SKILL.md §A 后进入 docs/SKILL.md。
❗ 路由至 docs/SKILL.md 后 不要再 Read path-d-signals.yaml（门禁已完成；后续见 docs/SKILL.md → 05-path-d-script.md D.1）。
Step 1 — 项目探测
READ references/01-detect-project.md + references/08-state-config.md → 找根 → 写 project_state.project_root
非 vue3 → BLOCKED: unsupported_platform
Step 1.5 — Session 初始化
READ references/vue3.md（按需）。
cd "<当前 trtc skill 目录>"
# 无 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>
已有 session → 保留 phase，仅更新必要字段。
Step 2 — 路径分流
| 优先级 | 条件 | 路径 |
|---|---|---|
| 0 | Step 0 知识咨询 | D（经 Root → docs/SKILL.md） |
| 1 | 减法/维护/报错 | C → READ flows/maintenance.md |
| 2 | phase=done + 有 tuikit 依赖 |
B |
| 3 | 已依赖 tuikit-atomicx-vue3 | B |
| 4 | 新项目 / 未依赖 | A |
Path A/B：
python3 -m tools.flow enter --phase onboarding --product chat --platform web
然后 READ flows/onboarding.md → 02-path-a-script.md 或 03-path-b-script.md
禁止 enter --phase topic
Path C → READ references/04-path-c-script.md
Path D（集成流内不应到达）→ 若误达，Read docs/SKILL.md
§3 Path A/B 强约束
- 一轮一 slice；禁止预读下轮 slice
- Write-then-Verify phase gate
- Path B 禁止
reopen-add-feature（用 §8.5 write-batch）
§4 Hard Rules 摘要
READ references/06-hard-rules.md + 06-a-defensive-coding.md
§5 关键文件
{projectRoot}/.trtc-session.yaml（唯一 session，经tools.session）{projectRoot}/WHAT-TO-DO-NEXT.md（A.4 交付物）skills/trtc-chat/.docs-query.yaml（Path D 正交态）
§6 规则冲突优先级
本文件 §0/§1/0/1/2 > 路径脚本 > hard rules > 其他
§7 References 索引
见 references/10-references-index.md