QClaw产品说明书与用户手册编写全攻略

为新产品快速生成一份结构清晰、语言规范的产品说明书和用户手册，是许多产品经理和开发团队面临的现实挑战。人工撰写不仅耗时，还容易遗漏关键操作节点或出现表述不一致的问题。现在，借助QClaw，你可以通过几种高度结构化的方法，高效地完成这项任务。

一、角色+任务+格式法：生成标准化文档初稿

如果你手头只有产品的基本构想，需要从零开始搭建文档框架，这个方法最为直接。它的核心在于通过精准的指令，让QClaw扮演特定角色，并严格按照你设定的格式输出。

具体操作上，你可以在微信中向QClaw发送这样一条指令：“角色是资深硬件产品技术文档工程师，任务是为一款USB-C多口扩展坞编写中文版产品说明书和用户手册，格式为本地新建文件夹‘扩展坞_说明书_202605’，生成两个Markdown文件：‘产品说明书.md’含产品概述、规格参数、安全须知；‘用户手册.md’含开箱步骤、连接图示说明、常见问题解答，所有章节需带二级标题与编号。”

指令发出后，确保QClaw桌面端处于“已配置”状态。通常等待30到90秒，就能在指定文件夹内看到生成的两个结构清晰的.md文件。接下来，打开文件进行初步检查：重点看是否自动插入了图片占位标识（比如[图：接口布局]），以及术语是否保持了一致性，例如全文是否统一使用“扩展坞”，而不是混用“拓展坞”或“集线器”。

二、任务+行动+目标法：基于已有资料自动扩写与校验

当产品已有一些零散资料时，比如Excel参数表、宣传页PDF或内部Wiki条目，这个方法能帮你高效整合。它强调以可验证的目标为导向，让QClaw执行信息抽取、逻辑重组和语言润色，避免人工整合时常见的遗漏和冗余。

操作时，首先将产品参数Excel文件和产品主视图等资料，拖入QClaw桌面端的指定监控文件夹（默认是“QClaw/inputs”）。随后，在微信中发送详细指令：“任务是基于QClaw/inputs中的‘扩展坞参数.xlsx’和‘外观图.png’生成用户手册，行动是提取全部接口类型描述、匹配对应图标位置说明、为每个功能模块编写三步式操作指引，目标是输出Word文档，含封面页、目录页、7个功能模块子章节，每个子章节至少包含1张图文对照说明和1个注意事项框。”

完成后，你会收到微信通知，告知“用户手册.docx已保存至桌面/QClaw/outputs”。这时，打开文档仔细检查几个关键点：目录是否自动生成并正确链接、图片是否嵌入到了正确位置、注意事项框是否使用了你要求的标准黄色底纹样式。

三、行动+目的+执行法：实时协同修订与多语言适配

文档初稿生成后，进入评审和优化阶段是常态。这个方法专注于迭代过程，通过明确具体的动作、修订目的和精确的执行方式，来实现快速响应。

例如，在收到跨部门评审意见后，你可以将初稿文档重命名并放入特定文件夹。接着，在微信中发送指令：“行动是将‘QClaw/review/扩展坞_说明书_v1_CN.docx’中‘安全须知’章节全部替换为EN-US版本，目的是满足CE认证文档双语要求，执行方式为调用内置DeepSeek模型进行术语级翻译，保留原格式与编号，输出为同名英文文件。”

生成英文版后，需要重点核对专业术语的准确性，比如“Overcurrent Protection”是否准确对应了中文的“过流保护”，而不是简单的字面直译。同时，也要检查所有表格、边框线等格式细节是否与中文原版保持一致。

四、上下文+指令+细节+输入法：嵌入真实用户反馈生成FAQ章节

凭空编造的FAQ往往脱离实际。这个方法的核心优势在于，它能利用真实的用户反馈数据作为上下文，生成极具实操价值的问答内容，显著提升手册的实用性和可信度。

首先，你需要从客服系统导出近期关于该产品的工单摘要，保存为文本文件并放入输入文件夹。然后，发送指令：“上下文是QClaw/inputs/售后反馈.txt中提取的23条真实用户问题；指令是生成用户手册中的‘常见问题解答’独立章节；细节要求按问题发生频率降序排列，每条解答含原因简述、解决步骤、规避提示；输入限制仅使用该文本内信息，禁止虚构。”

检查生成的FAQ时，可以验证其是否真正基于数据：排名首条的问题是否确实是反馈中最频繁的（如“HDMI无信号”）？对应的规避提示是否具体有效？这能确保你的文档直击用户痛点。

五、期望+角色+行动法：对接企业知识库生成定制化品牌话术

对于有严格品牌规范的企业，确保对外文档的语气、用词符合标准至关重要。这个方法通过预设角色和期望，引导QClaw调用本地知识库技能，实现文档风格的批量统一与合规审查。

操作前，需在QClaw桌面端启用“品牌知识库”插件，并导入公司的品牌规范文档和禁用词清单。之后，发送指令：“期望输出完全符合《技术文档品牌规范_v3.2.pdf》的说明书正文，角色是公司品牌合规官，行动是扫描当前文档全文，将所有‘快’字替换为‘高效’，删除所有感叹号，将‘您’统一改为‘用户’，并在指定章节末尾插入标准声明语句。”

修改完成后，进行最终比对：确认“高效”等替换词出现的次数是否符合预期，品牌规定的标准语句是否被精准插入，以及所有不符合品牌调性的符号（如感叹号）是否已被全部清理。这样一来，生成的文档便能与企业对外形象保持高度一致。