开场
建议用时约 1 分钟先看一个情境虚构示例,数字为示意
贺文清每周三四场需求评审,每次约 75 分钟。
会后要整理纪要,并对照上一版需求文字,列出变了什么、谁要跟进。
需求文字版本很多,改了哪里常常说不清,纪要次日才发出。
做法与模板
建议用时约 5 分钟流程:脱敏,对两版,人逐条核对
变更清单
建议用时下面是功能甲(代号)的旧版需求、新版需求,和评审会记录。 请输出: 一、变更清单,表格,列为:变更点、旧版怎么写、新版怎么写、评审记录里对应的原话 二、待确认:责任人缺失、期限缺失、评审里悬而未决的问题,逐条写成一个问句 三、两版互相冲突或口径不一致的地方 四、「这句话至少有两种理解」的需求句,列出两种理解 规则: 1. 责任人和期限,记录里没有明确说的,一律写「待确认」,不要猜。 2. 不添加需求里没有的功能,不添加会上没说过的话。 3. 「再看看」「先这样写」不是决定,不要写进变更清单。 只用我提供的内容,缺的写「待补」,不要编。 旧版:[粘贴] 新版:[粘贴] 评审记录:[粘贴]
样例:哪些变更有原话,哪些没有虚构示例,数字为示意
新版写了什么
导出范围由 30 天改为 90 天(示意);完成后发站内通知;导出内容包含用户名
评审里有没有原话
范围有原话「从 30 天改到 90 天」;完成提示没有原话;导出含用户名只是讨论,还不是决定
接口说明,评审前自检
建议用时下面是一张字段表。请据此起草接口说明的文字段落。 每个字段必须来自我给的表,表里没有的字段、参数、函数、默认值,一个都不要写。 对表里没有说明的取值范围,写「待补」。 写完后,单独列出:你的说明里出现了哪些不在字段表里的内容(目标是零条)。 字段表:[粘贴]
我即将评审这份需求。请列出评审会上最可能被问到的十个问题,只问不答;其中哪些问题是需求文字本身没有回答的,请标出来。 需求:[粘贴]
常见偏差与补救
建议用时约 2 分钟常见偏差与补救
编出不存在的需求编号或字段
要求每条引用原句;找不到原句的,删掉并追问来源
把「再看看」写成结论
用规则重申,并要求列出它改动过的地方
把实现方案当成需求
区分「要什么」和「怎么做」,实现方案放进待确认
小测验与提交
建议用时约 2 分钟三道小题,检验一下
第 1 题:它列的变更里有一条会上没说过,怎么办?
带回一份对得上原话的清单
变更、待确认、冲突、字段
- 新旧两版需求的变更清单,四栏齐全
- 两版互相冲突或口径不一致的地方,至少一条
- 一段接口说明,每个字段都能在字段表里找到
- 每条变更对应的评审原话
展开完整文字稿(视频旁白)
技术文档与需求评审
欢迎来到《AI 落地工作课》的专题 P11。这一课讲技术文档和需求评审。目标是:评审会后,快速得到纪要和变更清单;接口说明的文字,跟上实现。这一课沿用 P06 的规矩:缺的标出来,不要猜。
这一课带走什么
这一课带走三样东西,外加一条守则。第一,一份需求变更清单,写明变了什么、待确认的事、责任人和期限。第二,一条接口说明的规则:字段只能来自字段表。第三,一张两版需求的冲突清单。守则是:每条变更,都要对得上评审里的原话。这三样,是项目卡里流程和人机分工两栏的材料。
先看一个情境
先看一个虚构的情境,数字为示意。产品经理贺文清,每周三四场需求评审,每次约七十五分钟。会后要整理纪要,并对照上一版需求文字,列出变了什么、谁要跟进。需求文字版本很多,改了哪里常常说不清,纪要次日才发出。神龙大侠整理文字很在行。但它最容易顺手补需求,会上没说的,也写得头头是道。所以要立规矩:缺的标出来,不要猜。
流程:脱敏,对两版,人逐条核对
流程分五步。第一步,先脱敏:功能名换成代号,未发布功能的细节、产品路线图和客户名,都不贴。第二步,贴上新旧两版需求文字和评审记录,要求输出四栏:变更清单、待确认、责任人和期限。第三步,把规则写进提示:不补全缺项,不把讨论当决定,不添加需求里没有的功能。第四步,让它另列两版互相冲突的地方,以及这句话至少有几种理解。第五步,人来核对。贺文清逐条问:这条变更,会上真说过吗?待确认项,不由它补全。对客户或外部发出的版本,由她放行。
提示词一:变更清单
提示词一,变更清单。输入是旧版需求、新版需求和评审记录,输出四部分:变更清单,列出变更点、旧版怎么写、新版怎么写,以及评审记录里对应的原话;待确认的事,写成问句;两版冲突的地方;以及有多种理解的需求句。规则有三条:责任人和期限,记录里没有的,一律写待确认;不添加需求里没有的功能;再看看、先这样写,不是决定。你要检查的是,每条变更都能在评审记录里找到原话。
样例:哪些变更有原话,哪些没有
看一个虚构的样例,数字为示意。新版需求里,导出范围由三十天改为九十天,完成后发站内通知,导出内容包含用户名。对照评审记录:范围改动有原话,会上说过从三十天改到九十天;完成提示,评审记录里没有提到;导出含用户名,会上只是说需要想一想,这是讨论,不是决定。没有原话的条目,守门的人要去追问:是会上漏记了,还是文档里悄悄改了。
提示词二和三:接口说明,评审前自检
提示词二,接口说明。给它一张字段表,它据此起草说明文字。每个字段必须来自表,表里没有的字段、参数、默认值,一个都不写;没说明的取值范围,写待补。写完它要列出说明里不在字段表里的内容,目标是零条。说明以代码为准,作者还要逐字段核对。提示词三,评审前自检:列出评审会上最可能被问到的十个问题,只问不答,并标出需求文字本身没回答的问题。
常见偏差与补救
三种常见偏差。第一,它编出不存在的需求编号或字段。补救:要求每条引用原句,找不到原句的,删掉并追问来源。第二,它把再看看写成结论。补救:用规则重申,并要求列出它改动过的地方。第三,它把实现方案当成需求,比如写成采用分批导出。补救:区分要什么和怎么做,实现方案放进待确认。接口说明里多出一个字段,回到代码核对,找不到,就删除。
小测验
来做一道小测验。它列的变更里,有一条会上没说过,怎么办?A,保留,它通常不会错。B,删掉并追问来源;每条变更都要对得上评审里的原话。C,直接发给全组。答案是 B。守门的是人,每条变更都要能对上评审里的原话,找不到就删除并追问来源。
带回一份对得上原话的清单
这一课的提交物有四样。新旧两版需求的变更清单,四栏齐全;两版互相冲突或口径不一致的地方,至少一条;一段接口说明,每个字段都能在字段表里找到;还有每条变更对应的评审原话。提交前,未发布功能换成代号;字段表只交字段名和含义,不交源代码。下一课,我们进入故障复盘与告警整理。谢谢收看。本视频的旁白由 AI 合成。