PLM 操作手册生成器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_47e29613/tundra-manual。
技能介绍
要解决什么问题
PLM(Windchill、Teamcenter、Aras 等)的用户操作手册往往依赖 Word 模板维护,但模板里的章节与真实界面容易脱节:按钮叫法、Tab 名称、对话框标题若在文档里写错,评审和培训成本会直线上升。手工对照 Java/XML 里的 resourceBundle 与 @RBEntry 既慢又容易漏模块。
技能如何工作
本技能扮演操作手册编写助手,按固定流水线执行,而不是随意拼凑段落。
- 确认任务范围:先读
scripts/config.py里的系统名、筛选模式与源码搜索预设,再根据你的人名、章节号、关键词或「全书」筛选方式输出工作流程预览,等你回复「开始」后才继续。 - 对齐模板与源码:读取《模板要求说明》与 Word 模板,定位目标章节(保留父级标题上下文);在配置的
SOURCE_CODE_PATH中按三步验证——action model XML → 中文 resource bundle → 工具栏/菜单项,界面用语一律用【】引用,不擅自改写。 - 按叶子节点写内容:以模板最后一层无子标题的节点为最小功能单元,每个单元写清前提条件、功能说明、操作步骤、结果与注意事项;截图先用【图片占位:XX】预留。
- 生成 docx:将完整内容写入中间
.md,再调用generate.py生成 Word,并做 OOXML 校验;中文报告通过文件 + Read 展示,避免 Windows 终端乱码。
V2 强调多 PLM 系统、多种筛选、模板无关化与品牌参数化,具体切换与 CLI 见技能内 references/ 文档。
适用边界
- 不会在你确认前自动改文件或跑生成脚本;也禁止跳过内容编写直接生成(只会得到空标题文档)。
- 模板路径、源码路径、上一版手册等因人而异,需在个人配置中指向实际目录;非标准 Word 模板需按 config 指南单独适配。
- 联网参考仅作功能描述补充,最终术语必须以源码验证结果为准;生成后仍需在 Word 中 F9 刷新目录并替换截图占位。
使用场景
- Windchill 大版本升级后,只重写某负责人名下章节,需对照 action model 与中文 bundle 校正按钮名
- 实施同事要交付第 4.1 章培训材料,从公司手册模板按章节号筛出子节并先填文字、截图后补
- 文档工程师接到「BOM / 附件」相关模块改版,按关键词定位模板叶子节点并统一五段式写法
- 多站点 PLM(如 Teamcenter 与 Aras)共用一套编写流程,切换 config 后为同一模板生成不同品牌用语的手册
适合人员
- 驻场实施顾问,要在客户验收前把 Word 模板章节写成与界面一致的步骤说明
- PLM 二开/配置工程师,负责从 XML 与 resource bundle 提取真实 Tab、菜单名写进交付文档
- 技术文档工程师,维护《模板要求说明》并批量生成某章或某关键词范围的手册初稿
- 项目经理按人名拆分编写任务,需要助手先输出确认清单再生成 docx 与校验报告