知识库文档标准化处理
适用场景
当用户明确说“变成知识库文档”“整理成知识库”“做成可上传知识库的文档”，或提供资料/文件并要求整理、加工、生成目标文件时，执行本技能。支持纯文本、Markdown、截图、PDF、Word、Excel及其他可读取材料；先提取事实，再按本标准输出目标文件。
核心目标
生成适合知识库导入和检索的 Markdown：目录一开始即可按板块平铺展示；每个板块内容独立、完整、短小；相邻板块不复制相同内容；避免产生空的总目录节点、综合父节点和重复引用来源。
文档结构标准
- 禁止文档级总标题：不要使用文件名或主题作为唯一的
#总标题。将每个可独立检索的板块直接写成一级标题# 板块名称。 - 采用扁平标题：整份上传文件只使用同一级标题，推荐全部使用
#；不要混用#、##形成父子目录，除非用户明确要求保留层级。 - 一节一主题：一个标题只承载一个明确问题、流程、规则或场景。将“大而全”章节拆成多个独立板块。
- 标题可直接做索引：标题写成具体、可搜索的名称，例如“VPN 连接失败处理”，不要写“其他”“说明”“常见问题”等含义不清的标题。
- 板块自包含：每个板块首句明确主题，正文脱离前后文也能理解；必要时重复关键词，但不得复制其他板块的整段内容。
- 控制篇幅：每个板块建议 80～250 字；复杂流程拆成多个板块。避免单节过长导致平台二次切片和重叠重复。
- 板块之间留一个空行：标题、正文、下一标题之间保持标准 Markdown 空行。
内容加工规则
- 合并同义重复内容，只保留一份，并放在最匹配的板块。
- 将问答内容并入对应主题；只有在问答本身是独立知识点时，才单独保留“问题处理”板块。
- 将嵌套列表改为短段落或简单编号，降低导入器打散列表的概率。
- 保留用户提供的数字、名称、期限、条件和限制；不得擅自编造或修改事实。
- 发现来源内容互相矛盾时，标记“待确认”，不要自行裁决。
- 对截图资料先识别标题、板块和正文，再重组为扁平结构；看不清的内容标记为“需人工确认”。
- 文件名应简短明确，例如
差旅费用报销指南-知识库版.md，不要把文件名再写进正文作为总标题。
推荐模板
# 板块一：明确主题
用一段独立、完整的内容说明规则、步骤、条件或处理方式。必要时使用 1. 2. 3. 简短列出步骤。
# 板块二：另一个明确主题
只写本板块内容，不重复板块一的正文，不添加文档总览或结语。
质量检查清单
生成文件前逐项检查：
- 是否没有文档级总标题和空的综合节点？
- 是否所有板块使用同一级标题并能直接成为目录索引？
- 是否每个板块只讲一个主题且脱离上下文可读？
- 是否删除了重复段落、重复问答和重复结论？
- 是否存在超长板块，可能被平台再次切分？
- 是否保留了原始资料中的事实，不存在臆造数字？
- 是否为 Markdown 文件并使用 UTF-8 编码？
- 是否输出到
outputs目录并向用户提供可访问的文件路径？
输出规范
完成后生成最终目标文件，不直接把中间整理稿当作交付物。向用户简要说明：已采用扁平标题、一节一主题、去重和篇幅控制；指出文件名与路径；如用户需要上传测试，提示重点观察目录是否平铺、是否出现空总节点、引用来源是否重复。
