实施提效手册生成

它解决什么问题

实施项目上线前，用户操作手册往往是最后一块拼图，也是最容易被拖延的部分。素材通常散落在实施人员手里：截图堆在文件夹里，操作步骤写在聊天记录和口头交代中，不同人产出的手册章节结构不一、话术风格各异，截图配文随意。更麻烦的是，面对不熟悉的系统，AI 直接生成手册时很容易凭空编造菜单名、按钮名和功能逻辑，交付后被实施人员打回重改。手册一旦随系统升级迭代，又面临局部更新与全量重写之间的两难。

它是怎么工作的

双模式素材输入：模式 A（手动喂料）接收截图 + 口语步骤，直接做排版标准化，无外部前提；模式 B（自动探勘）在提供需求规格/详细设计文档且能登录测试系统时，AI 按文档功能点只读走查、自动截图产出。两者兼有时以 B 走查为主，A 补充异常分支截图。

按角色决定产出范围（与模式正交）：G0 整体手册（默认）、G1 单角色手册、G2 角色分组各出一份。角色优先从设计文档的「角色与权限」章节分析得出；推不出明确角色时默认输出 G0，不强行拆分。

标准化的执行流程：确认模式与素材 → 参考 references/skeleton-template.md 搭建章节骨架 → 用 writing-spec.md 统一话术、extraction-rules.md 把素材提炼为任务 SOP → 模式 B 下执行安全闸门（只读原则、写操作二遍确认、截图脱敏）→ 加载 qa-checklist.md 做交付前质检 → 人工审核后交付，不通过则回退修订重跑质检。

每条操作 SOP 固定四要素：前置条件 + 步骤 + 预期结果 + 常见问题排查。流程图统一用 Mermaid 语法描述，标准结构输出可一键生成 HTML（交互目录 + 矢量图）与 Word（目录域 + 图内嵌）。增量迭代时只喂新增内容，与旧手册交叉比对后输出「影响清单」，确认后局部更新并标注「已重核」。

适用边界与注意点

• 仅面向终端用户操作指导，运维部署、开发接口、二次开发等非用户视角内容不在范围内。
• 系统无关：不绑定任何具体业务系统，角色/模块/画面编码规则均由素材现推，references 中的示例仅为格式示范，不会写死为通用规则。
• 禁止虚构：不确定的菜单、按钮、权限一律标 [待确认] 或 [需补充]，绝不臆测。
• 素材与产出只落在项目目录（默认 output/ 子目录），不访问用户桌面、下载等个人位置。
• 质检通过后仍必须经实施人员人工审核，重点核对菜单命名、权限描述、异常分支与截图脱敏。