用Nova AI生成高质量技术文档需明确角色、任务、格式与上下文：定义具体专业背景以激活精准知识库；声明文档类型与读者画像避免层级错位；指定带编号的结构、术语原样保留及强动作动词；注入真实日志与硬件上下文确保场景匹配。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
用Nova AI生成高质量技术文档时，提示词写得模糊或结构混乱，会导致输出内容偏离实际需求、术语不统一、步骤缺失或逻辑错乱。必须明确角色、任务边界、格式约束和关键细节，才能让AI稳定输出可直接交付的文档。
定义AI角色与专业背景
在提示词开头，用一句话锁定AI的专业身份。不要只写“你是一个技术文档工程师”，要具体到领域和职级：例如“你是一名有5年嵌入式Linux驱动开发经验的高级技术文档工程师，现为ARM Cortex-A系列芯片SDK编写用户指南”。
这一步决定术语粒度——写“嵌入式Linux驱动”比写“软件文档”更能触发精准知识库调用；写“ARM Cortex-A系列”比写“处理器”更能激活架构级表述习惯。
若跳过角色定义，Nova AI会默认采用通用IT写作模型，常把“device tree binding”简写成“设备树配置”，漏掉Linux内核文档中的标准命名规范。
声明文档类型与读者画像
方法一：直接声明文档类型+读者层级
“输出一份面向固件工程师的‘SPI Flash烧录失败排查清单’，要求含现象→原因→验证命令→修复动作四段式结构。”
方法二：用否定排除法收紧范围
“不要写成培训PPT讲稿，不解释SPI协议原理，不列出所有Flash型号参数表，只聚焦J-Link烧录时出现‘Verify failed’报错的3种现场可判别原因。”
【读者层级错位会导致操作指令失效】比如写给FAE的文档里混入“请检查arch/arm64/boot/dts/下的dtsi文件”，而FAE现场无源码权限，这种指令无法执行。
指定结构与格式硬约束
第一步：用冒号分隔标题层级，强制生成带编号的步骤链
“1. 现象描述：用≤15字概括报错信息 → 2. 必检项：列出3个硬件连接检查点 → 3. 命令验证：给出带sudo权限说明的shell命令 → 4. 日志截断：标注dmesg输出中必须高亮的关键词”
第二步：对关键字段加引号锁定字面值
“所有‘ERROR’‘timeout’‘CRC mismatch’必须原样保留，不得替换为‘错误’‘超时’‘校验失败’”
第三步：禁用AI自由发挥的表达方式
“禁止使用‘一般来说’‘建议您’‘可以考虑’等模糊措辞；每个操作动词必须是‘执行’‘断开’‘重置’‘替换’等可立即落地的强动作词。”
这一步操作起来很简单，直接把格式模板粘贴进提示词即可生效。但漏掉引号约束会导致术语被AI本地化翻译，比如把“dmesg -t | grep -i ‘spi’”改成“查看系统日志并搜索spi关键字”，失去可复制性。
注入真实上下文片段
把实际报错日志、截图文字描述、硬件连接拓扑图的文字转译，作为提示词的最后20%内容。
例如：“附现场日志：‘[ 124.892105] spi-nor spi0.0: unrecognized JEDEC id bytes: 00, 00, 00’；硬件连接：STM32F767 + W25Q32JV + 3.3V供电，CS线经10kΩ上拉”
没有上下文时，Nova AI会按概率生成最常见场景（如Linux主机+Generic SPI controller），而实际是裸机环境+自定义GPIO模拟SPI，导致整个排查路径失效。
注意：上下文必须是纯文本，不要写“见附件截图”，Nova AI无法解析图像或文件。
