BRD 转操作手册生成器

问题背景

企业里的业务需求文档（BRD）往往按「系统能力」写：接口、规则、计算公式堆在几百页 Word 里，交付给实施或终端用户时仍需要一份按操作步骤组织的说明书。手工改写不仅慢，还容易把编号、套餐名、成本公式写错或概括掉，图文对应关系也会丢。

技能如何工作

本技能把大型 .docx BRD 按四步流程处理，并在输出里强制执行几类约束：

• 元数据与逻辑审计：逐章抽取服务包、下拉选项、接口名等，建《基础业务字典》；检查「概念未定义先使用」「前后文编号不一致」等问题。
• 结构映射：生成《操作手册大纲映射表》（BRD 章节 → 手册章节、图片数量、审计备注），等你确认大纲后再往下写。
• 图文定位：识别「图 X.X」「见图」等引用，建图片索引；可在正文插入 [图片占位符：…]，并支持用 python-docx 批量提取嵌入图（需人工复核）。
• 内容重构：把「系统应支持…」改成「用户点击…」；去掉「根据实际情况填写」等含糊表述；计算公式与乘数因子必须逐字保留，不得用文字概括。

冲突时按协议处理：编号错误可自动更正并标注 [逻辑审计提示：…]；前文未定义的概念标 [业务语义待澄清：…]。完成后输出 操作手册.md，并可经脚本转为 .docx。

适用边界

• 面向百页级 Word BRD，模块多、需分轮生成时会在文末提示「继续」下一章。
• 自动化图片定位依赖文本匹配，准确率有限，公式与复杂业务逻辑仍建议人工审校。
• 依赖 Python 3.12+ 与 python-docx；大型文档可选用文档里列出的 read_brd.py、chapter_analysis.py 等脚本流水线，但转换结果不能替代业务方对语义与公式的最终确认。