doc-splitter

name	doc-splitter
description	将游戏活动需求文档（Excel/Word/Markdown）按功能模块拆分为多个独立的Markdown文件。自动识别文档中的模块结构，提取每个模块的规则逻辑和界面交互内容，生成结构清晰的独立文件。触发条件：用户提供需求文档并要求拆分、分解、分离模块时使用本 skill。

需求文档拆分器

工作流程

1. 读取需求文档 - 使用 Read 工具或 pandas 读取用户指定的需求文档（支持 .xlsx / .docx / .md 格式）
2. 还原文档结构 - 将多列合并的单元格还原为完整的文本行，识别文档的整体层级结构
3. 识别模块边界 - 通过编号标题（如"3.元力养成"、"4.神元之核"）定位各功能模块的起止行范围
4. 区分内容类型 - 将文档内容分为"规则逻辑"和"界面交互"两大类（如有）
5. 提取公共信息 - 提取活动概述、入口设置、合服规则等所有模块共享的公共信息
6. 生成独立文件 - 按模块逐个生成 Markdown 文件，每个文件包含公共信息 + 模块专属内容
7. 保存文件 - 将所有文件保存到用户工作目录，文件命名格式为 {活动名}-{模块名}.md

输出格式规范

格式规范详见 references/format.md。

模块识别规则

编号标题模式

文档中的模块通常以编号+名称的形式出现，例如：

• 3.元力养成 — 主模块
• ●基础规则 — 子章节
• 1）随活动同步开启 — 具体规则条目

识别策略

1. 主模块：匹配 数字.中文名称 模式（如 3.元力养成、11.神元秘宝（战令））
2. 子章节：匹配 ●中文名称 模式（如 ●开启条件、●红点规则）
3. 规则条目：匹配 数字）描述 模式（如 1）随活动同步开启）
4. 表格数据：包含 | 分隔符的行

内容分类

• 规则逻辑：包含开启条件、基础规则、奖励机制、数值计算、合服规则、红点规则等
• 界面交互：包含界面示意图描述、按钮交互、弹窗逻辑、页签说明、UI状态变化等
• 公共信息：活动概述、设计目的、用户画像、入口设置、活动结束处理等所有模块共享的内容

拆分原则

文件结构

每个拆分后的文件应包含：

1. 文档标题：# 活动名 - 模块名
2. 来源说明：标注本文档从哪个完整文档中拆分提取
3. 活动概述（公共部分）：活动定位、设计目的、开启条件、入口、结束处理、合服规则
4. 规则逻辑（模块专属）：该模块的所有规则描述
5. 界面交互（模块专属，如有）：该模块的UI交互描述

内容保留原则

• 保留原文：不修改原文中的笔误、编号错误等问题，保持与原文档一致
• 保留表格：表格数据原样保留
• 保留层级：维持原文档的章节层级关系
• 不遗漏内容：确保每个模块的所有相关内容都被提取

命名规则

• 文件名格式：{活动名}-{模块名}.md
• 示例：神元异界-元力养成.md、神元异界-天阙争锋.md

处理 Excel 文档的特殊说明

多列合并还原

Excel 中的需求文档通常将内容分散在多个列中（用于视觉对齐），需要：

1. 逐行合并所有非空单元格
2. 用 | 连接同一行中的多个内容片段
3. 过滤掉完全为空的行

多 Sheet 处理

• 如果文档包含多个 Sheet，分别读取每个 Sheet
• 每个 Sheet 可能对应不同的功能模块或补充内容
• 根据用户需求决定是否将不同 Sheet 的内容合并到同一模块文件中

模块边界确认

• 识别到模块边界后，应向用户展示发现的模块列表
• 确认后再执行拆分，避免遗漏或错误划分