📡 硬件人进化论 · 第④篇

让AI帮你写规格书——文档效率翻倍的正确姿势

文 / 一个被规格书折磨了十年、终于找到出路的硬件工程师

老实讲，有时候：

硬件工程师有一半的时间，不是在做硬件，是在写关于硬件的东西。

HW Spec、测试报告、设计说明、EMC整改报告、ECN变更通知……这些文档不是不重要，是写起来真的痛苦。你明明脑子里已经把方案想清楚了，却要花两倍的时间把它变成Word里那几十页。

这一篇，我们就解决这个问题。

一、为什么AI特别擅长写硬件文档？

硬件文档有一个非常明显的特点：结构高度固定，核心数据来自你，表达形式可以标准化。

一份HW Spec，翻来覆去都是那几章：产品概述、硬件架构、接口定义、电气规格、环境要求、测试项目。一份EMC测试报告，结构上和你上个项目的几乎一样，换个产品名和数据就行。

这种高度模板化的内容，正是AI最擅长的场景——它能把你的零散输入，快速组织成符合格式、逻辑清晰、措辞专业的初稿。

你的任务从"从头码字"变成"提供核心信息 + review + 精修关键判断"。时间能省多少？实测下来，60%到80%不夸张。

二、关键技巧：怎么给AI喂信息

AI写文档质量高不高，80%取决于你怎么给它提需求。这件事叫Prompt工程，听起来高大上，其实就是"把需求说清楚"。

下面是两个对比示例，场景是让AI帮写一份Wi-Fi模块的HW Spec概述章节——

❌ 烂Prompt（别这么写）：

"帮我写一份Wi-Fi模块的硬件规格书"

AI会给你一份看起来有模有样但完全通用、没有任何实际价值的东西，里面的参数全是它编的。

✅ 好Prompt（这么写）：

"我在写一份Wi-Fi 6 CPE模块的HW Spec，需要你帮我写'产品概述'和'硬件架构'两个章节的初稿。以下是关键信息：

• 产品定位：室内CPE，运营商定制，支持4G/5G + Wi-Fi 6双连接
• 主芯片：高通IPQ6000，Wi-Fi 6 2×2 MIMO，支持2.4GHz和5GHz双频
• 射频链路：2.4G PA集成在芯片内，5G外置FEM，型号待定
• 接口：1× USB 3.0，2× GbE，1× UART调试口
• 天线：外置可拆卸天线，2.4G/5G各2根
• 参考我们上一款产品的文档风格：技术性、简洁、用工程师能读懂的语言 请输出章节正文，不要输出解释性内容。"

这两个Prompt的输出质量，差距是天壤之别。

三、三类最常用的文档场景

场景一：硬件规格书（HW Spec）

核心套路：给AI一个你们公司（或行业通用）的HW Spec章节结构，再把产品的核心参数逐条喂给它，让它按格式输出。

特别提示：接口定义、寄存器表、时序图这类内容，AI不适合直接生成——它会编造细节。这类内容你需要自己填，让AI负责"框架 + 文字描述"的部分。

场景二：射频测试报告

测试报告的格式最固定，AI在这里能发挥的价值也最大。你只需要把实测数据（各频段TX功率、接收灵敏度、EVM、杂散电平等）整理成一个表格，配合测试配置描述，AI能帮你把整份报告的文字部分组织得清清楚楚，包括每项测试的结论判定语句。

给AI的输入示例：

"以下是我们Wi-Fi 6 5GHz频段的TX功率测试数据（格式：信道-带宽-实测功率-限值-结论）：36-20MHz-22.3dBm-23dBm-PASS；149-80MHz-21.8dBm-23dBm-PASS…帮我生成测试报告的'5GHz发射功率'章节，包括测试配置说明、数据表格和结论段落。"

场景三：ECN变更通知

ECN是让人最头疼的文档之一——改动往往很小，但影响描述要写清楚，格式要规范，不然后面生产和质量部门都会找你麻烦。

把变更内容、原因、影响范围、生效版本这四项信息给AI，它能帮你出一份格式规范的ECN初稿，剩下的你review一遍就能签发。

四、一个必须知道的坑：AI的"幻觉"问题

AI写文档有一个致命弱点：它会在不确定的地方自信地填入看起来合理的内容。

在硬件文档里，这个问题尤其危险。比如你让它写某颗芯片的电气规格，它可能会编一个看起来很合理的工作电压范围或者最大工作温度——但如果这个数字进了正式文档，就是潜在的质量风险。

规则很简单，记住这一条：AI负责结构和语言，数据你来把关。

所有出现在文档里的具体数值——电压、电流、温度、频率、功率、速率——在进入正式版本之前，必须回到datasheet或实测数据中确认一遍。

这不是不信任AI，这是工程师的基本职业纪律。

五、配套好用的工作流

下面这个流程供参考——

六、一句话总结

AI是你最快的文档助理，但签字的人永远是你。

它帮你把框架搭好、把语言写顺、把格式弄对；你负责把数据填准、把判断写实、把责任担起来。这个分工搞清楚，你就掌握了用AI写硬件文档的核心。