cms-tbs-scene-created

by spzwin

Install this Skill

curl -fsSL -o cms-tbs-scene-created.zip https://skill.seembox.com/api/v1/skills/cms-tbs-scene-created/download && unzip cms-tbs-scene-created.zip

Download cms-tbs-scene-created.zip

SKILL.md About

---
name: cms-tbs-scene-created
description: 提供【TBS场景创建】全流程编排能力（Step1-4）。当用户表达"创建场景/新建场景/开始创建/训战场景/对练场景/生成场景"时，按 references/step1-4 编排并在用户确认且知识齐全后落库。
skillcode: cms-tbs-scene-created
github: https://github.com/xgjk/tbs-skills/tree/main/cms-tbs-scene-created
dependencies:
  - cms-auth-skills
version: 1.0.3
---

# cms-tbs-scene-create

## 核心定位
本 Skill **只做编排**：按 `references/step1-4/*.md` **单主线**推进。Step1 拉主数据；Step2 多轮采集与回显；Step3 校验通过后生成确认 `title` 与 `sceneBackground`；Step4.1 品种知识主题 → Step4.2 匹配/缺失阻断 → Step4.3 生成 `doctorOnlyContext` 与 `coachOnlyContext`；Step4.4 用户确认后校验落库。

## 任务分流（进入链路前先判断意图）

| 用户意图 | 判断依据 | 处理方式 |
|---------|---------|---------|
| **执行类**（创建场景） | 表达"创建/新建/开始/生成场景"等主动动作 | 进入 Step1-4 完整编排链路 |
| **咨询类**（了解规则/流程） | 提问"这个 Skill 怎么用/流程是什么/为什么要这样做" | 不执行任何脚本；仅结合 `SKILL.md` 与相关 `references/` 解释 |
| **排障类**（某步骤失败/结果异常） | 描述具体报错、字段异常、输出不对 | 先读 `references/pitfalls.md`；若未覆盖，再查 `references/failure-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-input-template.md` |
| Step3：校验与标题/背景 | `references/step3/tbs-scene-validate.md` |
| Step4.1：主题匹配 | `references/step4/tbs-knowledge-topic-generate.md` |
| Step4.3：上下文生成 | `references/step4/scenario-parse.md` |
| Step4.4：落库 | `references/step4/tbs-scene-create.md` |

**按需查阅（出错 / 疑问时才读，正常路径不触发）**

| 场景 | 查阅文档 |
|------|---------|
| 脚本校验失败 / 服务端报错 | `references/qa.md` |
| 字段名或展示词有疑问 | `references/glossary.md` |
| 步骤报错 / 输出异常排障 | `references/pitfalls.md` → `references/failure-examples.md` |
| 草稿 JSON 字段结构疑问 | `references/step3/draft-schema.md` |

## 全局约束（横切）
- **鉴权**：细则见 `references/auth.md`（含必须做/禁止项/失败处理/环境自检）。
- **`sceneBackground` 与 `repBriefing`**：用户确认的场景背景与落库字段 `repBriefing` 须一致（同源赋值，禁止两套文案）；术语映射见 `references/glossary.md`。
- **`scenario-parse`**：`doctorOnlyContext` / `coachOnlyContext` 的固定 A/B 与章节顺序以 `references/step4/scenario-parse.md` 为准。
- **知识匹配**：主题名称匹配由 `tbs-scene-validate.py --mode topics` 执行（确定性匹配，禁止 Agent 自行做字符串相似度判断）；匹配结果与未命中处理规则见 `references/step4/tbs-knowledge-topic-generate.md`。

## 门禁（必须遵守）
- 未取得有效 `access-token`（经 `cms-auth-skills`）→ **禁止**调用需要鉴权的脚本（`tbs-scene-fetch-config.py`、`tbs-scene-create.py`）。`tbs-scene-validate.py` 可不携带 token。
- **Step1**：`tbs-scene-fetch-config.py` 未返回 `success=true`，或 `state.businessDomains/departments/drugs` 任一为空数组 → **禁止**进入 Step2；必须先解决主数据加载问题（见 `references/step1/tbs-scene-fetch-config.md` 失败处理）。
- **Step2**：业务领域/科室/品种名称未在 `state.businessDomains/departments/drugs` 中命中确认 → **禁止**进入 Step3；必须在 Step2 阶段完成名称选定（零命中时展示可用列表、多命中时让用户选定）。
- Step3：`tbs-scene-validate.py --mode step3` 未返回 `passed=true` → **禁止**进入 Step4。
- Step4.2：任一主题无法匹配且用户未改为可命中项 → **禁止**调用 `tbs-scene-create.py`，仅走上报。
- 用户未明确作出「最终提交」确认 → **禁止**落库。

## 标准执行流程（必须遵循）
1. Step1–4 编排：
   - **鉴权前置**：读取 `references/auth.md`，通过 `cms-auth-skills` 获取有效 TBS `access-token`；token 未就绪时禁止继续
   - Step1：读取 `references/step1/tbs-scene-fetch-config.md`
   - Step2：读取 `references/step2/interaction-echo-confirmation.md`；首轮必须逐字复制 `references/step2/default-input-template.md` 中 ` ```text ``` ` 围栏内的正文输出给用户，**禁止改写、禁止增删 emoji、禁止调整语序**；用户提供业务领域/科室/品种后，**立即**调用 `tbs-scene-validate.py --mode step2` 做名称命中校验，按脚本结果决定是否写入或引导用户重选；**未完成脚本校验前禁止输出“已捕捉/已确认”话术**；同一字段连续 2 次零命中时输出阻断提示（见 `interaction-echo-confirmation.md` 零命中重复处理规则），等用户从现有列表选定或主动放弃
   - Step3：读取 `references/step3/tbs-scene-validate.md`，校验通过后生成并确认 `title + sceneBackground`
   - Step4.1：读取 `references/step4/tbs-knowledge-topic-generate.md`（仅在 `title + sceneBackground` 已确认后执行），生成并让用户确认品种知识主题
   - Step4.2：调用 `tbs-scene-validate.py --mode topics` 执行主题匹配，按结果写入 `knowledgeIds`；有未命中则按 `tbs-knowledge-topic-generate.md` 4.1.2.2 阻断并上报
   - Step4.3：读取 `references/step4/scenario-parse.md`，分两步生成：Step4.3a 生成 `doctorOnlyContext`（固定 A/B 节由 Agent 直接拼接，不经模型生成）→ Step4.3b 生成 `coachOnlyContext`；每步完成后向用户输出进度提示
   - Step4.4：读取 `references/step4/tbs-scene-create.md`，仅在前置字段齐全且用户确认提交时进入落库链路
2. 若 Step4.2 触发"品种知识缺失上报"：
   - 不调用落库脚本
   - 输出工作汇报草稿（上报载荷）并声明本次不允许落库
3. 若品种知识齐全且用户明确确认提交：
   - 确认已按 Step4.3 完成 `doctorOnlyContext` / `coachOnlyContext`
   - **落库前强制**执行脚本门禁：
     ```bash
     python3 scripts/tbs-scene-validate.py --params-json "<当前会话拼装的 scene JSON>" --mode createScene
     ```
     仅当 stdout 中 `passed=true` 时继续。
   - 执行：
     ```bash
     python3 scripts/tbs-scene-create.py --params-json "<当前会话拼装的入参>" --access-token "$ACCESS_TOKEN"
     ```
     （可传入 `--base-url` / `--timeout-sec` / `--retries`，参数说明见 `references/auth.md`。）

## 落库前 QA
`--mode createScene` 脚本校验是正常路径的硬门禁，通过即可继续。`references/qa.md`（三类自检 + 修复-复验循环）仅在脚本校验失败或落库后服务端报错时按需查阅，不在正常路径中强制读取。字段名/展示词有疑问时，按需查阅 `references/glossary.md`。

_meta.json Metadata

{
  "ownerId": "kn75s45s478x9t53qv91jrmb7h8208xm",
  "publishedAt": 1777545751667,
  "slug": "cms-tbs-scene-created",
  "version": "1.0.3"
}