| name | doc-splitter |
| description | 将游戏活动需求文档（Excel/Word/Markdown）按功能模块拆分为多个独立的Markdown文件。自动识别文档中的模块结构，提取每个模块的规则逻辑和界面交互内容，生成结构清晰的独立文件。触发条件：用户提供需求文档并要求拆分、分解、分离模块时使用本 skill。 |
需求文档拆分器
工作流程
- 读取需求文档 - 使用 Read 工具或 pandas 读取用户指定的需求文档（支持 .xlsx / .docx / .md 格式）
- 还原文档结构 - 将多列合并的单元格还原为完整的文本行，识别文档的整体层级结构
- 识别模块边界 - 通过编号标题（如"3.元力养成"、"4.神元之核"）定位各功能模块的起止行范围
- 区分内容类型 - 将文档内容分为"规则逻辑"和"界面交互"两大类（如有）
- 提取公共信息 - 提取活动概述、入口设置、合服规则等所有模块共享的公共信息
- 生成独立文件 - 按模块逐个生成 Markdown 文件，每个文件包含公共信息 + 模块专属内容
- 保存文件 - 将所有文件保存到用户工作目录，文件命名格式为
{活动名}-{模块名}.md
输出格式规范
格式规范详见 references/format.md。
模块识别规则
编号标题模式
文档中的模块通常以编号+名称的形式出现，例如：
3.元力养成 — 主模块●基础规则 — 子章节1）随活动同步开启 — 具体规则条目
识别策略
- 主模块：匹配
数字.中文名称 模式（如 3.元力养成、11.神元秘宝（战令））
- 子章节：匹配
●中文名称 模式（如 ●开启条件、●红点规则）
- 规则条目：匹配
数字）描述 模式（如 1）随活动同步开启）
- 表格数据：包含
| 分隔符的行
内容分类
- 规则逻辑：包含开启条件、基础规则、奖励机制、数值计算、合服规则、红点规则等
- 界面交互：包含界面示意图描述、按钮交互、弹窗逻辑、页签说明、UI状态变化等
- 公共信息：活动概述、设计目的、用户画像、入口设置、活动结束处理等所有模块共享的内容
拆分原则
文件结构
每个拆分后的文件应包含：
- 文档标题：
# 活动名 - 模块名
- 来源说明：标注本文档从哪个完整文档中拆分提取
- 活动概述（公共部分）：活动定位、设计目的、开启条件、入口、结束处理、合服规则
- 规则逻辑（模块专属）：该模块的所有规则描述
- 界面交互（模块专属，如有）：该模块的UI交互描述
内容保留原则
- 保留原文：不修改原文中的笔误、编号错误等问题，保持与原文档一致
- 保留表格：表格数据原样保留
- 保留层级：维持原文档的章节层级关系
- 不遗漏内容：确保每个模块的所有相关内容都被提取
命名规则
- 文件名格式：
{活动名}-{模块名}.md
- 示例：
神元异界-元力养成.md、神元异界-天阙争锋.md
处理 Excel 文档的特殊说明
多列合并还原
Excel 中的需求文档通常将内容分散在多个列中（用于视觉对齐），需要：
- 逐行合并所有非空单元格
- 用
| 连接同一行中的多个内容片段
- 过滤掉完全为空的行
多 Sheet 处理
- 如果文档包含多个 Sheet，分别读取每个 Sheet
- 每个 Sheet 可能对应不同的功能模块或补充内容
- 根据用户需求决定是否将不同 Sheet 的内容合并到同一模块文件中
模块边界确认
- 识别到模块边界后，应向用户展示发现的模块列表
- 确认后再执行拆分，避免遗漏或错误划分
