侠量身 AIailiangshen.com
AI 落地工作课 · 专题短课 · 第 11 课

技术文档与需求评审

评审会后快速得到纪要和变更清单,接口说明跟上实现

免费公开约 10 分钟零基础网页课 + PPT + 视频

这一课讲技术文档和需求评审。目标是:评审会后,快速得到纪要和变更清单;接口说明的文字,跟上实现。这一课沿用 P06 的规矩:缺的标出来,不要猜。

学完这一课,你能做到

  • 一份需求变更清单:变了什么、待确认、责任人、期限
  • 一条「字段只能来自字段表」的接口说明规则
  • 一张两版需求的冲突清单
  • 每条变更,都对得上评审里的原话

这三样,是项目卡「流程」和「人机分工」两栏的材料

视频版:约 5 分钟

旁白由 AI 合成。视频在哔哩哔哩播放,上面的章节按钮会跳到对应位置。不看视频也没关系,直接往下滚动看课程。

播放器不显示?在哔哩哔哩打开 ↗

01

开场

建议用时约 1 分钟

先看一个情境虚构示例,数字为示意

产品经理 贺文清 · 栖岚智能

贺文清每周三四场需求评审,每次约 75 分钟。

会后要整理纪要,并对照上一版需求文字,列出变了什么、谁要跟进。

需求文字版本很多,改了哪里常常说不清,纪要次日才发出。

神龙大侠整理文字很在行。但它最容易顺手补需求,会上没说的,也写得头头是道。
02

做法与模板

建议用时约 5 分钟

流程:脱敏,对两版,人逐条核对

脱敏功能名换代号,未发布的细节、路线图和客户名都不贴
→
贴两版加记录新旧两版需求文字加评审记录,要求输出四栏:变更、待确认、责任人、期限
→
写规则不补全缺项,不把讨论当决定,不添加需求里没有的功能
→
找冲突另列两版互相冲突的地方,以及一句话可能的几种理解
→
人核对逐条问:这条变更,会上真说过吗?待确认项不由它补全
对客户或外部发出的版本,由产品经理放行。
技巧

变更清单

建议用时
提示词一:变更清单
下面是功能甲(代号)的旧版需求、新版需求,和评审会记录。
请输出:
一、变更清单,表格,列为:变更点、旧版怎么写、新版怎么写、评审记录里对应的原话
二、待确认:责任人缺失、期限缺失、评审里悬而未决的问题,逐条写成一个问句
三、两版互相冲突或口径不一致的地方
四、「这句话至少有两种理解」的需求句,列出两种理解
规则:
1. 责任人和期限,记录里没有明确说的,一律写「待确认」,不要猜。
2. 不添加需求里没有的功能,不添加会上没说过的话。
3. 「再看看」「先这样写」不是决定,不要写进变更清单。
只用我提供的内容,缺的写「待补」,不要编。
旧版:[粘贴]
新版:[粘贴]
评审记录:[粘贴]
每条变更都要对得上评审里的原话;只是讨论、没有定论的,应放进待确认。

样例:哪些变更有原话,哪些没有虚构示例,数字为示意

新版写了什么

导出范围由 30 天改为 90 天(示意);完成后发站内通知;导出内容包含用户名

评审里有没有原话

范围有原话「从 30 天改到 90 天」;完成提示没有原话;导出含用户名只是讨论,还不是决定

没有原话的条目,守门的人要去追问:是会上漏记了,还是文档里悄悄改了。
技巧

接口说明,评审前自检

建议用时
提示词二:接口说明
下面是一张字段表。请据此起草接口说明的文字段落。
每个字段必须来自我给的表,表里没有的字段、参数、函数、默认值,一个都不要写。
对表里没有说明的取值范围,写「待补」。
写完后,单独列出:你的说明里出现了哪些不在字段表里的内容(目标是零条)。
字段表:[粘贴]
提示词三:评审前自检
我即将评审这份需求。请列出评审会上最可能被问到的十个问题,只问不答;其中哪些问题是需求文字本身没有回答的,请标出来。
需求:[粘贴]
接口说明里的每个字段都要能在字段表里找到;自检里,需求没回答的问题要标出来。
03

常见偏差与补救

建议用时约 2 分钟

常见偏差与补救

编出不存在的需求编号或字段

要求每条引用原句;找不到原句的,删掉并追问来源

把「再看看」写成结论

用规则重申,并要求列出它改动过的地方

把实现方案当成需求

区分「要什么」和「怎么做」,实现方案放进待确认

接口说明里多出一个字段,回到代码核对;找不到,就删除。
04

小测验与提交

建议用时约 2 分钟

三道小题,检验一下

第 1 题:它列的变更里有一条会上没说过,怎么办?

答案 B。守门的是人。每条变更都要能对上评审里的原话,找不到就删除并追问来源。
展开完整文字稿(视频旁白)
技术文档与需求评审

欢迎来到《AI 落地工作课》的专题 P11。这一课讲技术文档和需求评审。目标是:评审会后,快速得到纪要和变更清单;接口说明的文字,跟上实现。这一课沿用 P06 的规矩:缺的标出来,不要猜。

这一课带走什么

这一课带走三样东西,外加一条守则。第一,一份需求变更清单,写明变了什么、待确认的事、责任人和期限。第二,一条接口说明的规则:字段只能来自字段表。第三,一张两版需求的冲突清单。守则是:每条变更,都要对得上评审里的原话。这三样,是项目卡里流程和人机分工两栏的材料。

先看一个情境

先看一个虚构的情境,数字为示意。产品经理贺文清,每周三四场需求评审,每次约七十五分钟。会后要整理纪要,并对照上一版需求文字,列出变了什么、谁要跟进。需求文字版本很多,改了哪里常常说不清,纪要次日才发出。神龙大侠整理文字很在行。但它最容易顺手补需求,会上没说的,也写得头头是道。所以要立规矩:缺的标出来,不要猜。

流程:脱敏,对两版,人逐条核对

流程分五步。第一步,先脱敏:功能名换成代号,未发布功能的细节、产品路线图和客户名,都不贴。第二步,贴上新旧两版需求文字和评审记录,要求输出四栏:变更清单、待确认、责任人和期限。第三步,把规则写进提示:不补全缺项,不把讨论当决定,不添加需求里没有的功能。第四步,让它另列两版互相冲突的地方,以及这句话至少有几种理解。第五步,人来核对。贺文清逐条问:这条变更,会上真说过吗?待确认项,不由它补全。对客户或外部发出的版本,由她放行。

提示词一:变更清单

提示词一,变更清单。输入是旧版需求、新版需求和评审记录,输出四部分:变更清单,列出变更点、旧版怎么写、新版怎么写,以及评审记录里对应的原话;待确认的事,写成问句;两版冲突的地方;以及有多种理解的需求句。规则有三条:责任人和期限,记录里没有的,一律写待确认;不添加需求里没有的功能;再看看、先这样写,不是决定。你要检查的是,每条变更都能在评审记录里找到原话。

样例:哪些变更有原话,哪些没有

看一个虚构的样例,数字为示意。新版需求里,导出范围由三十天改为九十天,完成后发站内通知,导出内容包含用户名。对照评审记录:范围改动有原话,会上说过从三十天改到九十天;完成提示,评审记录里没有提到;导出含用户名,会上只是说需要想一想,这是讨论,不是决定。没有原话的条目,守门的人要去追问:是会上漏记了,还是文档里悄悄改了。

提示词二和三:接口说明,评审前自检

提示词二,接口说明。给它一张字段表,它据此起草说明文字。每个字段必须来自表,表里没有的字段、参数、默认值,一个都不写;没说明的取值范围,写待补。写完它要列出说明里不在字段表里的内容,目标是零条。说明以代码为准,作者还要逐字段核对。提示词三,评审前自检:列出评审会上最可能被问到的十个问题,只问不答,并标出需求文字本身没回答的问题。

常见偏差与补救

三种常见偏差。第一,它编出不存在的需求编号或字段。补救:要求每条引用原句,找不到原句的,删掉并追问来源。第二,它把再看看写成结论。补救:用规则重申,并要求列出它改动过的地方。第三,它把实现方案当成需求,比如写成采用分批导出。补救:区分要什么和怎么做,实现方案放进待确认。接口说明里多出一个字段,回到代码核对,找不到,就删除。

小测验

来做一道小测验。它列的变更里,有一条会上没说过,怎么办?A,保留,它通常不会错。B,删掉并追问来源;每条变更都要对得上评审里的原话。C,直接发给全组。答案是 B。守门的是人,每条变更都要能对上评审里的原话,找不到就删除并追问来源。

带回一份对得上原话的清单

这一课的提交物有四样。新旧两版需求的变更清单,四栏齐全;两版互相冲突或口径不一致的地方,至少一条;一段接口说明,每个字段都能在字段表里找到;还有每条变更对应的评审原话。提交前,未发布功能换成代号;字段表只交字段名和含义,不交源代码。下一课,我们进入故障复盘与告警整理。谢谢收看。本视频的旁白由 AI 合成。