cms-tbs-knowledge-splitter — cms-TBS知识拆分器

cms-tbs-knowledge-splitter 核心定位

本 技能 只做编排：按 references/stage1-解析.md → references/stage2-生成.md → references/stage3-merge.md 单主线推进。阶段一 PPTX→MD（文件处理服务）；阶段二 MD→知识条目 JSON（两步法）；阶段三合并去重 Excel。

适用场景：从培训类 PPTX 系统性构建药品/器械知识库条目。

任务分流（进入链路前先判断意图） 用户意图 判断依据 处理方式 执行类（拆分/建库） 「拆分知识条目」「生成知识库」「构建知识库」等主动动作 进入阶段一至三完整链路 咨询类（了解规则/流程） 询问用法、流程、分类体系等 不执行脚本；结合 技能.md 与相关 references/ 说明 排障类（某步失败/结果异常） 具体报错、条数不对、Excel 异常等 先读 references/pitfalls.md；未覆盖再查 references/失败-examples.md；定向到对应阶段文档；不重置已通过的前置阶段

同一会话内，用户「咨询」后表达执行意图，再切换到执行类。排障不默认重做已完成阶段。

Quick Reference

每步必读（正常执行路径）

阶段 必读文档 鉴权（进阶段一前） references/auth.md 阶段一：PPTX→MD references/stage1-解析.md 阶段二：MD→JSON references/stage2-生成.md 阶段三：合并 Excel references/stage3-merge.md

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

场景 查阅文档 目录与产出路径 references/输出-layout.md 12 分类 / JSON 字段名 references/glossary.md 跨阶段易错点 references/pitfalls.md 报错样例与处理 references/失败-examples.md 文件处理服务 API tbs-技能s/文件处理服务API说明.md 全局约束（横切） 鉴权：细则见 references/auth.md（应用Key 获取/注入/禁止项；禁止用 访问-令牌 调文件处理服务）。 分类 / 过滤 / 拆分 / 两步法 prompt：以 references/stage2-生成.md 为准。 去重与 Excel 列：以 references/stage3-merge.md 与 scripts/merge_excel.py 为准。 产出路径：以 references/输出-layout.md 为准。 门禁（必须遵守） 未取得有效 应用Key（经 cms-auth-技能s）→ 禁止调用 convert_pptx.py（见 references/auth.md）。 阶段一：存在解析失败文件时，可继续阶段二，但须汇总失败列表；是否阻断由业务要求决定，默认继续处理已成功 .md（见 references/stage1-解析.md）。 阶段二：某文档 JSON 未成功生成 → 阶段三不合并该文件；子代理两步法未在同一任务内完成 → 视为本阶段失败（见 references/stage2-生成.md）。 阶段三：merge_excel.py 无任何有效 知识条目 → 禁止视为建库完成；退出码 2 时不得进入交付（见 references/stage3-merge.md）。 标准执行流程（必须遵循） 鉴权：读取 references/auth.md，经 cms-auth-技能s 取得 应用Key；未就绪禁止阶段一。 阶段一：读取 references/stage1-解析.md，完成 PPTX→MD。 阶段二：读取 references/stage2-生成.md，完成 MD→JSON。 阶段三：读取 references/stage3-merge.md，执行 merge_excel.py 生成 Excel。 收尾：汇总各阶段失败/跳过列表；阶段三退出码 1 时须向用户说明部分文件未纳入合并。 排障说明（按需）

正常路径以各阶段文档中的脚本与门禁为准。references/pitfalls.md、references/失败-examples.md 仅在异常时查阅，不在正常路径中强制读取。