cms-tbs-knowledge-splitter

核心定位

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

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

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

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

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

Quick Reference

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

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

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

| 场景 | 查阅文档 | |------|---------| | 目录与产出路径 | references/output-layout.md | | 12 分类 / JSON 字段名 | references/glossary.md | | 跨阶段易错点 | references/pitfalls.md | | 报错样例与处理 | references/failure-examples.md | | 文件处理服务 API | tbs-skills/文件处理服务API说明.md |

全局约束（横切）

鉴权：细则见 references/auth.md（appKey 获取/注入/禁止项；禁止用 access-token 调文件处理服务）。
分类 / 过滤 / 拆分 / 两步法 prompt：以 references/stage2-generate.md 为准。
去重与 Excel 列：以 references/stage3-merge.md 与 scripts/merge_excel.py 为准。
产出路径：以 references/output-layout.md 为准。
阶段一 MD：落盘前剔除 API 输出的演讲者 ### Notes: 讲稿；幻灯片上的「备注：」等正文保留（见 references/stage1-parse.md）。

门禁（必须遵守）

未取得有效 appKey（经 cms-auth-skills）→ 禁止调用 convert_pptx.py（见 references/auth.md）。
阶段一：存在解析失败文件时，可继续阶段二，但须汇总失败列表；是否阻断由业务要求决定，默认继续处理已成功 .md（见 references/stage1-parse.md）。
阶段二：某文档 JSON 未成功生成 → 阶段三不合并该文件；子代理两步法未在同一任务内完成 → 视为本阶段失败（见 references/stage2-generate.md）。
阶段三：merge_excel.py 无任何有效 知识条目 → 禁止视为建库完成；退出码 2 时不得进入交付（见 references/stage3-merge.md）。

标准执行流程（必须遵循）

鉴权：读取 references/auth.md，经 cms-auth-skills 取得 appKey；未就绪禁止阶段一。
阶段一：读取 references/stage1-parse.md，完成 PPTX→MD。
阶段二：读取 references/stage2-generate.md，完成 MD→JSON。
阶段三：读取 references/stage3-merge.md，执行 merge_excel.py 生成 Excel。
收尾：汇总各阶段失败/跳过列表；阶段三退出码 1 时须向用户说明部分文件未纳入合并。

排障说明（按需）

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