TMS BOOK · ACADEMY 讲义

技术文档、试验报告与专利撰写

大纲的完整展开版——讲师授课蓝本 / 学员自学材料

Q2-03 技术文档、试验报告与专利撰写

课程代码 Q2-03 · 板块 Q 职业发展与工程协作 / 工程协作与商务 时长 约 3.5 小时(6 讲) 适合对象 系统 / 结构 / 试验工程师及技术文档负责人(L2 进阶选修) 前置 I7-01 热管理系统/零部件 DFMEA 实操(术语与文档基础);L7-03 试验数据分析与不确定度评估(不确定度评定方法的主课,本课第 3 讲的合成式与包含因子一律按该课口径) 本讲义定位 讲师授课蓝本 / 学员自学讲义


按任务导航

你手上的事 直接看 还要配
明天要交一份台架试验报告 第 2 讲:目的—方法—数据—不确定度—结论五段,每段各答哪一个复核问题 第 3 讲(不确定度那一段的最小要素)· 第 6 讲(自评审四条线)
报告被客户质疑「你们凭什么说测准了」 第 3 讲:报告里的不确定度该写哪五样,评审必查的 k 三问 第 2 讲(原始记录倒查链)· 第 4 讲(口径与术语一致)
要写一份热负荷估算书 / 选型计算书 第 1 讲 1.5:计算书是独立的第五类交付物,方法—数据—不确定度三段同样适用 第 6 讲 6.5(校核与审核签署栏各对哪一段负责)
项目要交需求覆盖情况,不知道漏没漏 第 4 讲:追溯矩阵怎么搭、三种漏项形态、C_验证 的分母只能取当前版本 第 2 讲(报告要回指需求条款号)
需求刚改了一版,旧报告还算不算数 第 4 讲 4.4:重跑判定四问 + 作废标记怎么打 第 1 讲 1.2(谁回指谁)
下周要交一份专利交底书 第 5 讲:发明点提炼三问、独立权利要求的「结构 + 功能」写法、五种会被规避的参数写法 第 5 讲 5.6(职务发明的自查次序)
组织一场文档评审 第 6 讲:数据 / 逻辑 / 术语 / 复算四条线各查什么,复算线为什么必须换路径 第 3 讲(不确定度必查项)· 第 4 讲(术语一致)
要把一份报告写成对外材料 第 1 讲 1.6 与 1.7:引用合规三问 + 对外表述的极限词与口径一致 第 4 讲 4.5(同名同口径)

⛔ 本课不覆盖:测量不确定度的评定方法本体(分量表怎么列、灵敏系数怎么取、有效自由度怎么算、相关分量怎么处置)→ L7-03 试验数据分析与不确定度评估;仪表校准证书判读与量值溯源 → L7-06 传感器校准、量值溯源与台架期间核查;需求管理工具与追溯链的建立与维护 → M1-04 需求管理与追溯(DOORS 等);DVP&R 验证计划的编制与验证项本体 → M1-03 DVP&R 与验证计划管理;DFMEA 的做法 → I7-01 热管理系统/零部件 DFMEA 实操;读别人的专利、自由实施(FTO)分析与规避设计 → M5-01 热管理专利布局与规避设计;竞品对标情报的取得边界 → M5-02 技术路线情报与竞品对标;仿真报告的要素集与相关性判定 → J7-07 仿真任务的输入、交付与模型资产管理 / J7-01 仿真—试验相关性验证(Correlation);设计评审的汇报表达 → Q2-01 设计评审(DR)汇报与技术表达。

⛔ 本课一个平台数都不给:任何具体的重复次数、分量大小、覆盖率目标值、评审周期、归档年限、权利要求的字数与项数——全部由本项目的测量系统、需求库规模、体系文件与所引法规的现行版本决定。本课出现的准确数值只有三类:纯数学结果、本课自己写出来的教学算例(输入全部是教学假设值、⛔ 不对应任何平台),以及公开可查的符号与量纲约定。

引言:一份报告的价值,不在它写了什么,在它经不经得起有人来查

先说一个在热管理台架上反复上演的场景。某换热器散热量测试,报告交出去,正文一句话:「在 XX 工况下实测散热量 12.4 kW,满足 12.0 kW 的目标要求。」客户复核会上有人问了三个问题:这 12.4 是几次测量的第几次;进出口温差用的两支热电偶是不是同一次标定的;如果测量不确定度是 ±0.5 kW,那么「满足 12.0」这句话还成不成立。

三个问题,一个都答不上来。不是因为试验做得不好,是因为报告没有为「被查」这件事留任何入口。

这就是本课要建立的第一个观念,它贯穿六讲:

工程文档的读者不是「读它的人」,是「拿它去做决定、并且事后要为那个决定负责的人」。

这句话有一个立刻能用的推论:凡是读者拿来做决定的那句话,都必须能倒查回一手证据。报告写「满足要求」,这是决定;那么它背后必须挂着:谁在什么工况、用什么方法、测了几次、原始记录在哪、这个数的不确定度多大、拿它去比的那条限值出自哪一条需求。这条链上任意一环断掉,那句「满足要求」就退化成一句意见。

本课的第二个观念是关于「写不写得死」的。试验报告的失败方式是写得太满——结论超出了数据能撑住的范围;而专利交底书的失败方式恰好相反,是写得太死——把一个具体尺寸当成发明点,权利要求一落笔就把自己框进了一个别人改个数字就能绕开的小圈里。两件事看起来无关,其实是同一个能力的两面:准确判断「我这句话到底罩住了多大范围」。报告要罩得刚刚好(不多说),专利要罩得尽可能大(不少说)。这也是本课把它们放进同一门课的理由。

今天就能做的一件事:把你手上最近交出去的一份报告翻到结论那一页,对每一句结论问一遍——

  • 这句话里的数,读者能不能顺着报告找到它的原始记录?找不到 ⇒ 结论无法倒查,见第 2 讲 2.4。
  • 这句话有没有和一条限值做比较?如果有,那条限值出自哪条需求的哪一款?说不出 ⇒ 追溯断了,见第 4 讲。
  • 这个数带不带不确定度?不带 ⇒ 它不能与限值比大小,见第 3 讲 3.2。
  • 这句话有没有超出数据范围(比如从两个工况的结果推出「全工况都满足」)?超了 ⇒ 见第 2 讲 2.5。

四问里只要有一个答不上来,那份报告在第三方审核桌上就是脆的。⚠ 而它平时不会报错——文档的缺陷只在被人来查的那一天才兑现,而那一天通常是你最没时间补救的一天。

本课六讲:第 1 讲铺开五类交付物的分工与对外合规;第 2 讲写试验报告的五段结构与追溯链;第 3 讲讲不确定度在报告里怎么写、评审怎么查;第 4 讲把需求与结果之间那张追溯矩阵搭起来;第 5 讲从交底书走到独立权利要求;第 6 讲收在评审与知识沉淀上。


第 1 讲 技术文档体系:五类交付物各自答什么问题

1.1 先把五类交付物的「问题」分开

工程师日常产出的技术文档,通常被笼统称作「资料」。这个笼统称呼是很多混乱的起点——因为它们回答的不是同一个问题,因此不能用同一套结构去写,也不能用同一套标准去评审。

交付物 它回答的问题 主要读者 写错的典型后果
规范书(技术要求 / 规格书) 「这个件必须做到什么」 供应商、设计、采购、验证 要求不可验证 ⇒ 到验收时两边各说各话
DFMEA 「哪里会失效、后果多重、我们怎么防」 设计、质量、验证 变成填表作业 ⇒ 措施栏写「已考虑」而无出口
DVP&R(设计验证计划与报告) 「拿什么试验去证明它做到了」 验证、项目、客户 验证项与需求对不上号 ⇒ 漏测无人发现
试验报告 「实测出来是多少,这个数可信到什么程度」 项目、客户、第三方审核 只给结论不给方法 ⇒ 经不起复核
工程计算书 「按什么假设算出来是多少,谁能复算」 设计、评审、后续项目 只留一张结论截图 ⇒ 假设无法倒查
专利交底书 「这里面哪一部分是别人还没做过的、值得圈地的」 代理人、审查员、竞争对手 把参数当发明点 ⇒ 保护范围一改数字就没了

⚠ 这张表里最容易被漏掉的是工程计算书。它在很多团队里根本没有作为一类正式交付物存在——热负荷估算、水泵与风扇选型、换热器面积匡算、能量流台账,算完了以后只在评审 PPT 上留一张结论截图,底表在个人电脑里,假设在算的人脑子里。

试验报告答「测出来是多少」,计算书答「按什么假设算出来是多少」。两者的地位是对等的,因为在项目早期,能拿来做决定的往往只有计算书——那时候还没有样件可测。⇒ 本课的一条硬主张:计算书适用与试验报告同一套结构纪律(方法—数据—不确定度三段,见第 2 讲),并且和报告一样要有校核与审核签署(第 6 讲 6.5)。

六类工程交付物与各自回答的问题的对照图。画面主体是一个横向排列的六栏并列结构,六栏共用顶部一条标题带,标题带写「同一批工程事实,六种交付物,六个不同的问题——⛔ 不能用同一套结构写」。六栏自左至右分别是规范书、DFMEA、DVP&R、试验报告、工程计算书、专利交底书。每一栏由上下四个方框组成:第一框为栏标题;第二框写「它回答的问题」,规范书栏写「这个件必须做到什么」,DFMEA 栏写「哪里会失效、后果多重、怎么防」,DVP&R 栏写「拿什么试验去证明它做到了」,试验报告栏写「实测出来是多少、可信到什么程度」,工程计算书栏写「按什么假设算出来是多少、谁能复算」,专利交底书栏写「哪一部分是别人还没做过的」;第三框写主要读者;第四框写写错的典型后果,六栏分别是「要求不可验证,验收时两边各说各话」「变成填表作业,措施栏写已考虑而无出口」「验证项与需求对不上号,漏测无人发现」「只给结论不给方法,经不起复核」「只留一张结论截图,假设无法倒查」「把参数当发明点,改个数字就绕开了」。工程计算书那一栏用加粗边框,并在其上方挂一个醒目标签写「最常被漏掉的一类:它在很多团队里根本不是正式交付物」。试验报告栏与工程计算书栏之间画一条双向箭头,箭头上标注「同一套结构纪律:方法—数据—不确定度三段,同样要有校核与审核签署」。画面底部一条横贯六栏的说明带写「读者不是读它的人,是拿它去做决定并事后为决定负责的人」。画面右下角一行小字写「本图为分类结构示意,六栏宽度不代表工作量或重要性比例,⛔ 不得据图取值」。
图1 六类交付物各答一个不同的问题。该从图上读出三件事:① 结构随问题走,⛔ 不存在一套通用模板;② 工程计算书是常被漏掉的第五类,它与试验报告适用同一套结构纪律;③ 每一类的失败方式各不相同,因此评审清单也不能共用一份。本图为分类结构示意,⛔ 不得据图取值。

1.2 谁回指谁:文档之间的引用关系是有方向的

六类文档不是并列摆着的,它们之间有固定方向的引用关系。方向搞反,追溯链就断了。

正确的方向是:下游文档回指上游文档的条款号,⛔ 上游不复述下游的内容。

  • 需求条款 ← DVP&R 验证项(验证项写明它验的是哪条需求)
  • 需求条款 ← 试验报告(报告写明它响应的是哪条需求的哪一款)
  • DFMEA 的失效模式 ← DVP&R 里的探测措施(探测项写明它防的是哪个失效模式)
  • 计算书的假设 ← 试验报告(报告可以引用计算书里的假设做对照,⛔ 反过来不行)

为什么方向不能反。如果规范书里复述了 DVP&R 的试验方法,那么 DVP&R 改了方法之后,规范书里那一段就变成一处沉默的错误——它不会报错,只会静静地和现实脱节,直到某一天有人照着它去做验收。而如果规范书只写「验证方法见 DVP&R 第 X 项」,那么方法改了,规范书天然是对的。

⇒ 一条可以立刻执行的写法纪律:凡是别处已有属主的内容,只写指针(文件名 + 版本 + 条款号),⛔ 不复制内容。复制一次,就多一个将来会失同步的地方,而失同步不报错。

⚠ 指针本身也会失效——被指向的那一条被删了、被改号了、那份文件作废了。所以指针必须带版本号,且第 4 讲 4.4 的作废标记必须打在被取代的那一份上。

1.3 内部文档与对外交付文档:详略的分界不在「多写少写」

很多人以为对外文档就是内部文档删掉一些内容。这是错的,两者的差别不是详略,是三条不同的边界。

边界一 · 假设与推测能不能出现。内部文档里写「这里我怀疑是密封件老化导致的,下一轮验证」是完全正常且有价值的;同一句话进了对外报告,它会变成一份被引用的技术判断,而它本来只是一个待验假设。⇒ 对外文档里的每一句话都必须是已经站住的,未验证的判断要么删掉,要么显式标成「假设,待验证」。

边界二 · 中间过程与失败数据。内部要留全(这是知识资产,见第 6 讲 6.3);对外给的是完整可复核的最终数据链,⛔ 不是全部原始记录。⚠ 这里有一条容易被误读的:「不给全部原始记录」⛔ 不等于「可以只给结论」——对外必须给到能让第三方复核结论的那一层(方法、样本量、不确定度、口径),少于这一层就是第 2 讲要打掉的那种报告。

边界三 · 别人的东西。内部技术分析里可以放竞品拆解照片、可以放从客户那里拿到的边界条件;对外材料里这两样都要过一道合规闸,见 1.6。

内部文档与对外交付文档的三条边界对照图。画面为左右两大区,中间由一条竖向的粗分界带隔开,分界带上自上而下写三个边界名称:边界一 假设与推测、边界二 中间过程与失败数据、边界三 别人的东西。左区标题为「内部文档」,区内自上而下三个方框分别对应三条边界:第一框写「可以写待验假设与怀疑方向,这是有价值的工作记录」;第二框写「中间过程与失败数据必须留全,它是团队知识资产」;第三框写「竞品拆解结果与客户边界条件可用于内部技术分析」。右区标题为「对外交付文档」,区内同样三个方框:第一框写「每一句话必须已经站住,未验证判断要么删除、要么显式标注为假设待验证」;第二框写「给到能让第三方复核结论的那一层:方法、样本量、不确定度、口径」,框下另挂一个醒目提示写「⛔ 不给全部原始记录 ≠ 可以只给结论」;第三框写「竞品与第三方数据必须过合规闸:来源、测试口径、获取方式合法性三项齐全,未授权的客户数据一律不得进入」。中间分界带的第二条边界处横穿一条红色警示线,线上写「越过这条线的两个方向都会出事:多给越权,少给经不起复核」。画面底部一条横贯左右的说明带写「差别不是详略,是三条不同性质的边界——⛔ 对外文档不是内部文档删几段」。画面右下角一行小字写「本图为结构对照示意,不含任何数值,⛔ 不得据图取值」。
图2 内外文档的差别不在详略,在三条边界上。该从图上读出三件事:① 未验证的判断不能以陈述句形式进对外材料;② 「不给全部原始记录」与「只给结论」是两回事,后者不可接受;③ 别人的数据进对外材料必须先过来源、口径、合法性三项闸。本图为结构对照示意,⛔ 不得据图取值。

1.4 模板:它省掉的和它遮住的

模板化的好处是实的:新人不会漏项、评审有共同的检查顺序、跨项目可比。⇒ 该做模板,本课不反对模板。

但模板有一个特定的失效方式,值得单独点出来:模板把「该想什么」变成了「该填什么」。

具体表现有三种,都很好认:

  1. 栏位填了但内容是同义反复。「风险」栏写「性能不达标」,「措施」栏写「加强验证」。栏位齐全,评审通过,而这两句话没有携带任何信息。
  2. 模板里没有的东西就不写。本次试验有一个模板没预留栏位的特殊情况(比如中途换过一支热电偶),于是它没有出现在任何地方。⚠ 这是模板最贵的一种失效——它造成的缺失是看不见的,因为报告在结构上是完整的。
  3. 上一版的残留。拿上一个项目的报告改,工况改了、结论改了,而方法那一段里还留着上一个项目的设备编号。

⇒ 三条对策,全部是可执行的:① 模板每个栏位后面附一句「这一栏答的是什么问题」(而不是栏位名);② 模板固定留一栏「本次的特殊情况与偏离」,且规定该栏不许写「无」而必须写「已核对,本次无偏离,核对人 XX」;③ 复用旧文档时先把所有具体数值、编号、日期整体标黄,逐项核过才取消标记。

1.5 工程计算书:本课把它抬成正式交付物

1.1 已经点出它常被漏掉,这里给它的最小要素集。一份能被复算的计算书至少要有六块:

  1. 目的与结论先行——算这个是为了支撑哪个决定,算出来是多少。
  2. 假设清单——每一条假设单独一行,写明它的来源(引自哪份文件 / 本次工程判断 / 教学或占位值)。⚠ 这是计算书里最重要的一块:结论错,八成错在假设上,而不是错在算术上。
  3. 方法与公式来源——用的哪一套关联式、出自哪本手册或哪门课,适用范围是什么。
  4. 输入数据与出处——每一个输入量标明它是实测、引自规范书、还是估的。
  5. 计算过程与中间量——底表必须交出去,⛔ 不是只交结论。
  6. 不确定度或敏感性——哪几个假设动一动会让结论翻盘。⚠ 计算书里通常做不了严格的不确定度合成(输入量的不确定度往往拿不到),⇒ 退而做敏感性:把最可疑的两三条假设各拨动一个合理幅度,看结论还成不成立。这一步不做,计算书就没有「可信到什么程度」这一层。

⛔ 常见误区:把 Excel 文件本身当成计算书交出去。表格里的公式确实完整,但假设不在里面、来源不在里面、适用范围不在里面 ⇒ 三个月后没有人能判断那张表还成不成立。

1.6 引用别人的数据:三项缺一不可

对外材料里出现竞品数据、第三方测试数据、公开文献数据时,三项必须同时齐:

  • 来源——出自哪里,具体到可检索的程度(⛔ 不是「据了解」「业内数据」)。
  • 测试口径——那个数是在什么工况、什么测点、什么方法下得到的。⚠ 这一项缺席时,那个数和你自己的数不可比,而并排放在一起会造成「已经比过了」的错觉。
  • 获取方式的合法性——这份数据你是怎么拿到的,这条路径能不能公开说。

两类东西不得直接进对外材料,⛔ 没有例外:① 拆车对标得到的结果(它的取得方式与可公开性另有边界,见 M5-02 技术路线情报与竞品对标);② 未经授权的客户数据、客户提供的边界条件与客户方的试验结果。

⚠ 第 ② 类最容易在无意中越界——比如把客户给的整车热负荷曲线放进一份给另一个客户的技术方案里。这不是文档写法问题,是保密义务问题,⇒ 合法边界见 M5-01 热管理专利布局与规避设计 与 M5-02 技术路线情报与竞品对标,本课只负责在文档层面立一道闸:对外材料定稿前,逐张图逐个表问一遍「这个数是我们自己测的吗」,不是的,就走三项检查。

1.7 对外表述:极限词与口径一致

两件事,都很容易在技术材料里出问题。

第一件 · 绝对化用语。「最优」「唯一」「第一」「永不」「彻底解决」这一类词在对外技术材料与宣传材料中禁用。⚠ 工程师容易觉得这只是市场部的事,实际上技术材料一旦被用作宣传依据,这条约束就落到写它的人身上。⇒ 相关法定要求见《中华人民共和国广告法》中关于绝对化用语的条款(⛔ 本课不转述条文内容,以现行版本为准;具体表述与适用范围以法务意见为准)。

工程上的替代写法很简单:把绝对化断言换成带条件的比较。

⛔ 不要写 ✅ 改成
换热效率行业最优 在本报告 X 工况、按 Y 方法测得的换热效率为 __,高于我司上一代产品 __
唯一支持 −30 ℃ 启动的方案 在已检索到的公开资料范围内,未见同类方案公开报道 −30 ℃ 启动能力(检索式与截止日期见附录)
永不泄漏 在 Z 试验条件下完成 __ 次循环后泄漏率未超过 __(判据出处:需求条款 __)

第二件 · 同名同口径。同一个物理量,在对外报告、宣讲材料、技术协议附件三处必须同名且同口径。

⚠ 这里要接一条跨课口径提醒,⛔ 别互代:Q2-02 主机厂—供应商技术对接与商务谈判 把对外承诺的性能数分成典型值 / 目标值 / 保证值三档,并且钉住了一条——保证值只能比典型值差,三档之间的距离由量产一致性波动、测量不确定度、寿命期衰减三项撑开。⇒ 本课的立场是文档侧的:试验报告产出的是典型值那一档(代表性样件、代表性工况、实测),⛔ 它不能直接被搬进技术协议附件当保证值。搬的时候必须显式换档并注明档位标签,否则同一个数会在两份文件里以两种身份存在,而客户复核时对不上账。


后面还有 5 讲正文 · 关键公式 · 案例拆解 · 常见误区 · 动手做

会员专属

后续为会员深水区内容——四库数据与深度拆解。

查看会员方案