Skill: spzwin/cms-tbs-scene-created (version 1.3.3)

--- name: cms-tbs-scene-created description: TBS 场景创建编排。创建/新建/生成场景→走 Step1-4；问流程/规则→只解释；报错/异常→排障文档。按 references 推进至落库。 skillcode: cms-tbs-scene-created github: https://github.com/xgjk/tbs-skills/tree/main/cms-tbs-scene-created dependencies: - cms-auth-skills version: 1.3.3 --- # cms-tbs-scene-created ## 任务分流（进链路前先判意图） | 用户意图 | 判断依据（满足任一即可） | 处理方式 | |----------|--------------------------|----------| | **执行类**（创建场景） | 「创建/新建/开始/生成/训战/对练」+ 场景；或咨询后明确要开始创建 | 走下方 **步骤与文档** 主表，Step1→4.3，不得跳步 | | **咨询类**（了解规则/流程） | 「怎么用」「流程是什么」「为什么要…」「某字段什么意思」；**无**具体报错、**无**要求立刻创建 | **不执行任何脚本**；仅用本 Skill + 相关 `references/` 解释 | | **排障类**（失败/异常） | 具体报错、字段不对、输出不符、某步卡住 | 先 `references/pitfalls.md`（按 Step）；未覆盖再 `failure-examples.md`；定向到对应 step 文档；**不重置**已通过的前置步骤 | **切换规则**：同一会话先咨询、后表达创建意图 → 再切执行类。排障不自动从头跑 Step1。 --- ## 步骤与文档（执行类主表） | 步 | 做什么 | 产出 | 过门禁 | 必读文档 | |----|--------|------|--------|----------| | 鉴权 | `cms-auth-skills` | `access-token` | G1 | `references/auth.md` | | Step1 | `tbs-scene-fetch-config.py` | `state` 三列表 + `nextStep.userVisibleMessage` | G2 | `references/step1/tbs-scene-fetch-config.md` | | Step2 | 采集、回显、`sync`→`.tbs-scene-work/draft.json`、`--mode step2` | `draft.json`、`drugName` | G3 | `step2/interaction-echo-confirmation.md`、`step2/tbs-scene-draft.md`、`default-input-template.md` | | Step3 | 只读 `draft.json` 校验、生成并确认标题/背景 | `title`、`sceneBackground` | G4 | `step3/tbs-scene-validate.md`、`step3/title-and-scene-background.md` | | Step4.1 | suggest → 用户确认知识 → `finalize`（本地） | `knowledgeIds`、`knowledgeSuggestionState` | G5 | `references/step4/tbs-scene-suggest-knowledge.md` | | Step4.2 | 生成 `contextPayload`（对用户不可见） | `contextPayload` | G6 | `references/step4/scenario-parse.md` | | Step4.3 | 最终业务清单 → `createScene` → create | 创建成功 | G7–G8 | `references/step4/tbs-scene-create.md` | **Step4 编排（G4 通过后）**：**同一轮同步启动** Step4.1 `suggest`（HTTP）与 Step4.2 `contextPayload`（模型），两者互不等待；须等 suggest 成功再展示推荐；用户确认知识后 **仅** `finalize` → **G6 必过** → 4.3 清单 →「确认提交」→ create。**禁止**未生成 `contextPayload` 就 create（会导致 doctor/coach 为空）。用户确认知识后**禁止**再完整重跑 4.2，**除非** G6 未满足则**必须立即补跑** 4.2（G6 未满足的典型情形：4.2 在同步生成期间因超时/截断未完成生成）。详见 `scenario-parse.md` §② 什么时候生成。 **执行要点**（不重复各 step 细则）： - Step1 触发后**不向用户输出任何信息** → 鉴权 → fetch-config。 - **G2 通过后（确定性，不依赖 Agent 读 md）**：将脚本 stdout 的 **`nextStep.userVisibleMessage` 原样**作为下一条用户可见消息；**禁止**首轮枚举三列表或问卷式「请选一个」。 - 需 token：`fetch-config`、`suggest-knowledge`、`create`；`tbs-scene-validate.py` 不需。 - 落库口令：仅 **「确认提交」**；Step4.1/4.2 的「确认」不算落库授权。 - **create 成功**：将 `tbs-scene-create.py` stdout 的 **`userDisplay.userVisibleMessage` 原样**发给用户（含标题+场景背景）；**禁止**展示 `sceneDbId`/ID。 **业务领域**：全程固定 **`临床推广`** 写入 `confirmed`/`draft`；仅科室+品种做 step2 名称匹配（见 `step2/interaction-echo-confirmation.md`）。 **落库成功后**：删除整个 `.tbs-scene-work/`（见 `step4/tbs-scene-create.md`）；失败/放弃不删。 --- ## 按需查阅（咨询/排障/异常时才读） | 场景 | 文档 | |------|------| | Step3 标题/背景怎么写 | `references/step3/title-and-scene-background.md` | | 落库前自检、校验失败 | `references/qa.md` | | 字段名 / 用户展示词 | `references/glossary.md` | | 常见坑 | `references/pitfalls.md` | | 现象 → 处理 | `references/failure-examples.md` | 正常执行路径**不必**先读 qa/pitfalls；排障优先 pitfalls。 --- ## 门禁（G#） | # | 通过条件 | 未过 | |---|----------|------| | G1 | 有效 token；全流程鉴权一次 | `auth.md` | | G2 | 三列表非空；stdout 含 `nextStep.userVisibleMessage` 且已原样展示；**不**拉/不依赖 `productKnowledges` | 不进 Step2 | | G3 | `businessDomain` 固定「临床推广」；`step2` 下 **科室+品种** exact；C 层（拜访对象/氛围/医生顾虑/代表目标）齐；清单确认后 **`sync --user-confirmed`** | 不进 Step3 | | G4 | `step3` 通过；用户**已确认** `title`+`sceneBackground` 后写回 draft；**未确认前禁止** Step4.1 | 不进 Step4 | | G5 | `suggest` 成功并已展示；用户确认知识；`finalize` 后 `knowledgeIds` 非空；**不**展示 `create`/建议新建 | 不进 finalize / 4.3 | | G6 | `contextPayload` 完整（doctor 5 + coach 3 键非空；可与 4.1 **同步启动**，**finalize 后、4.3 前**必完成）；`create` 脚本会拒绝空 payload | 不进 4.3 / 禁止 create | | G7 | `--mode createScene` 通过 | 不调 create | | G8 | 用户 **「确认提交」**；create 成功后清理 `.tbs-scene-work/` | 不调 create | --- ## 全局约束（全流程） - **保密**：禁止对用户展示内部 ID、`contextPayload` 正文/键名、推荐日志、脚本/API 原文（排障在会话内处理，见 failure-examples）。 - **同源**：`sceneBackground` = 落库 `repBriefing`（`glossary.md`）。 - **草稿**：`confirmed.json`（Agent 维护）→ **仅** `tbs-scene-draft.py sync` 写 `draft.json`；禁止手改 draft。见 `step2/tbs-scene-draft.md`、`step3/draft-schema.md`。

path: version.json
content: skillcode: cms-tbs-scene-created
version: 1.3.3

Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)