ManualGen 操作手册生成器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_c4926d5a/manualgen
技能介绍
它解决什么问题
大型项目的手册往往不是“有没有”的问题,而是“能不能给运营、销售和客户直接用”的问题。一次性读完全部代码再写文档,容易出现上下文爆炸、模块遗漏、按钮和字段写得像接口文档,以及跨模块流程被拆散在不同章节里。ManualGen 针对这类问题,把文档生成从一次性总结改成逐层沉淀、按批落盘、机器校验的流程。
它如何工作
技能按 L0 骨架 → L1 模块 → L2 区域 → L3 功能 → L4 操作 → L5 细节 推进,每层只基于下层结构化产物继续生长,避免反复重读源码。关键机制包括:
- 批次落盘:每完成一批立即写入
_kb/Lx_xxx/*.json,中断后可断点续跑。 - 知识图谱:把节点、三元组、证据链和
Snake跨模块流程连起来,用于生成端到端操作指南。 - CLI 硬校验:用
run.py verify、run.py scan_tech等脚本检查产物是否存在、计数是否一致、手册是否泄漏 API、参数名等技术信息。 - 权限矩阵:面向角色和功能输出可见性、操作边界,最终合并成用户可读手册。
适用边界
它适合从零生成整套用户手册、补充重点模块、代码变更后做增量回灌,或分析大型项目的业务流程。对于单次简单问答、纯编码任务、只想要一句话摘要的场景不合适。若用户没有显式指定模块范围,技能默认全量覆盖;若只写核心模块,必须在附录中披露未覆盖范围。
使用场景
- 新接手一个三十多个页面的 ERP 项目,需要为销售和客服生成可交付的用户操作手册。
- 代码改版后只改了订单、库存模块,需要按增量回灌更新对应章节而不是重写整本手册。
- 给外部客户讲解跨模块业务流时,需要把销售接单、发货、收款串成一条端到端操作指南。
- 交付前检查手册是否混入 API 端点、参数名等技术泄漏,并生成权限矩阵和未覆盖附录。
适合人员
- 负责把内部系统整理成客户可读手册的产品运营。
- 需要向销售和客户解释业务流的解决方案顾问。
- 接手大型项目后要建立操作文档的工程师。
- 需要交付权限说明和未覆盖清单的实施负责人。