运行时依赖
安装命令
点击复制技能文档
cms-tbs-scene-创建 核心定位
本 技能 只做编排:按 references/step1-4/*.md 单主线推进。Step1 拉主数据;Step2 多轮采集与回显;Step3 校验通过后生成确认 title 与 sceneBackground;Step4.1 品种知识主题 → Step4.2 匹配/缺失阻断 → Step4.3 生成 doctorOnly上下文 与 coachOnly上下文;Step4.4 用户确认后校验落库。
任务分流(进入链路前先判断意图) 用户意图 判断依据 处理方式 执行类(创建场景) 表达"创建/新建/开始/生成场景"等主动动作 进入 Step1-4 完整编排链路 咨询类(了解规则/流程) 提问"这个 技能 怎么用/流程是什么/为什么要这样做" 不执行任何脚本;仅结合 技能.md 与相关 references/ 解释 排障类(某步骤失败/结果异常) 描述具体报错、字段异常、输出不对 先读 references/pitfalls.md;若未覆盖,再查 references/失败-examples.md;然后定向到对应 step 文档;不重新执行已通过的前置步骤
同一会话内,用户在"咨询"后表达创建意图,才切换到执行类。排障类优先查 pitfalls.md,不重置流程进度。
Quick Reference
每步必读(正常执行路径)
阶段 必读文档 鉴权(进 Step1 前) references/auth.md Step1:拉主数据 references/step1/tbs-scene-fetch-config.md Step2:采集与回显 references/step2/interaction-echo-confirmation.md + references/step2/default-输入-template.md Step3:校验与标题/背景 references/step3/tbs-scene-验证.md Step4.1:主题匹配 references/step4/tbs-knowledge-topic-生成.md Step4.3:上下文生成 references/step4/scenario-解析.md Step4.4:落库 references/step4/tbs-scene-创建.md
按需查阅(出错 / 疑问时才读,正常路径不触发)
场景 查阅文档
脚本校验失败 / 服务端报错 references/qa.md
字段名或展示词有疑问 references/glossary.md
步骤报错 / 输出异常排障 references/pitfalls.md → references/失败-examples.md
草稿 JSON 字段结构疑问 references/step3/draft-模式.md
全局约束(横切)
鉴权:细则见 references/auth.md(含必须做/禁止项/失败处理/环境自检)。
sceneBackground 与 repBriefing:用户确认的场景背景与落库字段 repBriefing 须一致(同源赋值,禁止两套文案);术语映射见 references/glossary.md。
scenario-解析:doctorOnly上下文 / coachOnly上下文 的固定 A/B 与章节顺序以 references/step4/scenario-解析.md 为准。
知识匹配:drugId 内顺序为 trim 精确 → 小写精确 → 包含匹配;多候选包含命中时须请用户选定后再写入 knowledgeIds(见 references/step4/tbs-knowledge-topic-生成.md)。
门禁(必须遵守)
未取得有效 访问-令牌(经 cms-auth-技能s)→ 禁止调用需要鉴权的脚本(tbs-scene-fetch-config.py、tbs-scene-创建.py)。tbs-scene-验证.py 可不携带 令牌。
Step3:tbs-scene-验证.py --mode step3 未返回 passed=true → 禁止进入 Step4。
Step4.2:任一主题无法匹配且用户未改为可命中项 → 禁止调用 tbs-scene-创建.py,仅走上报。
用户未明确作出「最终提交」确认 → 禁止落库。
标准执行流程(必须遵循)
Step1–4 编排:
鉴权前置:读取 references/auth.md,通过 cms-auth-技能s 获取有效 TBS 访问-令牌;令牌 未就绪时禁止继续
Step1:读取 references/step1/tbs-scene-fetch-config.md
Step2:读取 references/step2/interaction-echo-confirmation.md;首轮必须逐字复制 references/step2/default-输入-template.md 中 ``text `` 围栏内的正文输出给用户,禁止改写、禁止增删 emoji、禁止调整语序
Step3:读取 references/step3/tbs-scene-验证.md,校验通过后生成并确认 title + sceneBackground
Step4.1:读取 references/step4/tbs-knowledge-topic-生成.md(仅在 title + sceneBackground 已确认后执行),生成并让用户确认品种知识主题
Step4.2:按匹配规则写入 knowledgeIds;缺失则上报并阻断落库
Step4.3:读取 references/step4/scenario-解析.md,分两步生成:Step4.3a 生成 doctorOnly上下文(固定 A/B 节由 代理 直接拼接,不经模型生成)→ Step4.3b 生成 coachOnly上下文;每步完成后向用户输出进度提示
Step4.4:读取 references/step4/tbs-scene-创建.md,仅在前置字段齐全且用户确认提交时进入落库链路
若 Step4.2 触发"品种知识缺失上报":
不调用落库脚本
输出工作汇报草稿(上报载荷)并声明本次不允许落库
若品种知识齐全且用户明确确认提交:
确认已按 Step4.3 完成 doctorOnly上下文 / coachOnly上下文
落库前强制执行脚本门禁:
python3 scripts/tbs-scene-验证.py --params-json "<当前会话拼装的 scene JSON>" --mode 创建Scene
仅当 stdout 中 passed=true 时继续。 执行: python3 scripts/tbs-scene-创建.py --params-json "<当前会话拼装的入参>" --访问-令牌 "$访问_令牌"
(可传入 --base-url / --timeout-sec / --retries,参数说明见 references/auth.md。) 落库前 QA
--mode 创建Scene 脚本校验是正常路径的硬门禁,通过即可继续。references/qa.md(三类自检 + 修复-复验循环)仅在脚本校验失败或落库后服务端报错时按需查阅,不在正常路径中强制读取。字段名/展示词有疑问时,按需查阅 references/glossary.md。