制定AI需求分析输入规范,核心是把交给AI理解与整理需求的材料拆成可填写的固定字段,并规定谁在什么时点填写、填到什么颗粒度、缺失时如何处理。一份可执行的规范通常包含输入范围与来源、必填与选填字段、填写规则与示例、质量校验项、角色分工与交接、版本与变更记录。落地时建议先选一类需求试点,用真实需求跑通“收集—填写—校验—提交AI—复核”的闭环,再逐步固化字段和检查项。
要点总览(TL;DR)
- 输入规范的核心是把交给AI理解与整理需求的材料拆成可填写的固定字段,并规定谁在什么时点填写、填到什么颗粒度、缺失时如何处理。
- 必填字段宜控制在八到十个,按“先要素、后边界”的顺序设计:业务背景、目标用户、问题描述、期望结果、约束条件,加上范围外内容、验收口径、依赖与假设。
- 颗粒度用一条口径判断:一条需求能独立回答“谁在什么场景下遇到什么问题、期望什么结果、如何判断完成”,答不上来就继续拆分或补充。
- 执行流程分五步:确定范围与来源、按字段表填写、按校验项自检、提交AI整理并标注待澄清点、人工复核回填,每步都有输入、动作、输出和完成标志。
- 落地先选一类需求,用十到二十条真实需求跑通闭环,观察必填字段一次完整率、AI输出返工比例和待澄清点关闭时长,再据此修订规范。
输入规范先定哪几件事:范围、字段与颗粒度
输入规范的第一版不需要覆盖所有需求类型。先回答三个问题:这份规范管哪些需求、交给AI的输入由哪些字段组成、一条需求写到什么程度才算可输入。三件事定清楚,后续的字段表和流程才有边界。
范围说明:适用类型与不适用场景
在规范开头列出适用清单,例如用户反馈类需求、缺陷改进类需求、内部流程优化类需求。同时写明暂不适用的场景,例如涉及未公开商业条款的需求、需要现场勘查才能判断的硬件需求。范围说明的作用是让填写人知道什么时候该用这份规范,什么时候应走其他渠道。范围可以随试点推进逐步扩展,但每次扩展都应在变更记录中注明。
输入来源清单
把可接受的输入来源列成固定清单,便于收集阶段对照:
- 原始诉求:客户工单、销售转述、用户访谈原话、投诉记录;
- 访谈与会议记录:需求沟通会纪要、录音转录稿;
- 现有文档:产品规划、历史PRD、操作手册、竞品分析;
- 系统现状:现有功能截图、数据表结构、接口说明、日志片段。
清单应注明每类来源的提供方和常见格式。来源越接近原始材料,AI整理时越容易保留细节;经过多轮转述的材料需要在字段中标注“转述”并说明转述层级。
必填与选填的划分原则
必填字段的判断标准是:缺少该字段,AI无法形成可复核的需求描述,或人工复核时必须回头找提出方补充。按此标准,业务背景、问题描述、期望结果通常必填;目标用户在有明确使用群体时必填;约束条件在已知时必填,未知时填写“待确认”并注明由谁确认。选填字段用于补充信息,例如相关截图、历史讨论链接、参考产品。必填字段数量宜控制在八到十个,过多会导致填写人敷衍填空。
颗粒度要求:写到什么程度算可输入
可采用一条判定口径:一条需求应能独立回答“谁在什么场景下遇到什么问题、期望什么结果、如何判断完成”。四个问题中有一个答不上来,就继续拆分或补充信息。颗粒度过粗的典型表现是一条需求里混入多个目标用户或多个独立问题;颗粒度过细的表现是把界面按钮文案调整拆成独立需求。规范中应给出两三个正反例,帮助填写人形成一致判断。
必填字段怎么设计:从需求要素到可填写模板
字段表是输入规范的主体。设计时先列需求要素类字段,再列边界与验收类字段,每个字段都配说明、填写要求、示例和是否必填,避免出现“请描述需求”这类无法执行的字段。
字段表结构
建议字段表包含五列:字段名、字段说明、填写要求、填写示例、是否必填。填写要求要写清格式和长度,例如“用两到三句话描述,避免使用‘优化’‘提升’等无对象动词”。示例应来自真实需求并做脱敏处理。
需求要素类字段
| 字段名 | 字段说明 | 填写要求 | 填写示例 | 是否必填 |
|---|---|---|---|---|
| 业务背景 | 需求产生的业务情境 | 说明触发事件与影响范围,两到三句 | 近一个月客服收到12起关于导出报表缺少汇总行的反馈,影响月度对账 | 必填 |
| 目标用户 | 需求服务的使用群体 | 写明角色与使用频次 | 财务专员,每月对账时使用 | 必填 |
| 问题描述 | 当前存在的具体问题 | 描述现象与发生条件,不写解决方案 | 导出报表只有明细行,汇总数据需手工在Excel中计算,单次约耗时40分钟 | 必填 |
| 期望结果 | 希望达到的状态 | 写可观察的结果,不限定实现方式 | 导出文件中包含按科目汇总的行,金额与明细一致 | 必填 |
| 约束条件 | 已知的限制 | 写明时间、合规、技术或资源限制 | 需在下个结算周期前上线;导出格式需兼容现有模板 | 已知时必填 |
边界与验收类字段
| 字段名 | 字段说明 | 填写要求 | 填写示例 | 是否必填 |
|---|---|---|---|---|
| 范围外内容 | 明确不纳入本次需求的事项 | 列出易混淆但不在范围内的功能 | 不调整报表权限体系,不新增其他报表类型 | 必填 |
| 验收口径 | 判断需求完成的依据 | 写可验证的检查方式 | 用上月数据导出,汇总行金额与手工计算结果一致,误差为零 | 必填 |
| 依赖与假设 | 成立的前提或外部依赖 | 写明依赖方与假设内容 | 假设科目编码规则本季度不变;依赖数据组提供汇总口径确认 | 必填 |
常见错误写法对照
- 问题描述写“报表不好用”,应改为具体现象与发生条件;
- 期望结果写“优化导出功能”,应改为可观察的结果,如“导出文件包含汇总行”;
- 验收口径写“用户满意”,应改为可验证的检查方式;
- 范围外内容留空,导致AI在整理时自行扩展范围;
- 约束条件写“尽快”,应写明具体时间节点或周期。
执行步骤:从收集到提交AI的完整流程
流程设计的目标是让每次提交给AI的输入都经过同样的收集、填写和自检动作。以下五步可直接作为操作说明使用,每步都写明输入、动作、输出和完成标志。
步骤一:确定本次分析的需求范围与来源
输入:待分析的需求清单或来源材料。动作:按规范的范围说明筛选适用需求,标注每条需求的来源类型和提供方。输出:本次分析的需求清单,含来源标注。完成标志:清单中每条需求都有明确来源和提供方,且均属于规范适用范围。
步骤二:按字段表收集并填写原始信息
输入:需求清单与来源材料。动作:逐条按字段表填写,原始材料中的关键原话可摘录到对应字段;无法确认的字段填写“待确认”并注明确认人。输出:填写完成的字段表。完成标志:所有必填字段均有内容或标注“待确认”,选填字段按需填写。
步骤三:按校验项自检输入质量
输入:填写完成的字段表。动作:对照校验项逐条检查,重点看问题描述是否含解决方案、期望结果是否可观察、验收口径是否可验证、范围外内容是否具体。输出:自检记录与修订后的字段表。完成标志:校验项全部通过,或未通过项已注明原因和处理计划。
步骤四:提交AI进行理解与整理,并标注待澄清点
输入:通过自检的字段表。动作:将字段表提交给AI,要求其按固定结构输出需求描述、待澄清问题和拆解建议;提交时说明本次整理的目标和输出格式要求。输出:AI整理结果,含待澄清点清单。完成标志:AI输出覆盖全部必填字段对应的信息,待澄清点已逐条列出。
步骤五:人工复核AI输出,回填缺失信息
输入:AI整理结果与原始字段表。动作:逐条核对AI输出是否忠于原始输入,删除无依据的补充内容,对待澄清点安排确认并回填字段表。输出:定稿的需求描述与更新后的字段表。完成标志:待澄清点均有结论或明确的责任人与时间,定稿内容经需求提出方确认。
在团队已有需求管理工作项和文档库的情况下,这套流程可以承载在统一平台上执行:字段表作为需求工作项的固定属性,填写与评审记录留在文档中,AI整理结果与人工修订版本可对照追溯。ONES Assistant 可连接 ONES Project、ONES Wiki 与 ONES TestCase,理解项目、工作项和 Wiki 页面等工作上下文,围绕需求澄清提炼要点、待澄清问题与拆解建议,其输出过程可追踪,便于复核环节对照原始输入。
角色分工与交付物:谁填、谁审、谁定稿
规范能否执行,取决于每个节点是否有明确的责任人和可交接的产物。角色划分宜按动作而非职级设定,同一人可兼任多个角色,但职责需分开写明。
| 角色 | 主要职责 | 在流程节点上的交付物 |
|---|---|---|
| 需求提出方 | 提供原始诉求与背景,确认待澄清点 | 原始材料、待澄清点答复、定稿确认 |
| 需求分析人员 | 按字段表填写与自检,组织澄清 | 填写完成的字段表、自检记录、澄清结论 |
| AI使用者 | 准备提交内容,执行AI整理,整理输出 | 提交记录、AI整理结果、待澄清点清单 |
| 评审人 | 复核AI输出与定稿内容 | 复核意见、定稿版本 |
评审与交接的触发条件应写进规范:必填字段出现“待确认”超过约定时间、AI输出与原始输入存在明显偏差、需求涉及跨团队依赖时,均触发评审。输入发生变更时,由需求分析人员在字段表中记录变更内容、变更原因和变更时间,并通知AI使用者与评审人;已提交AI的输入若发生实质变更,应重新执行步骤三至步骤五,避免新旧版本混用。
示例:一条需求如何按规范填写并交给AI整理
以下为演示情景,用于说明规范的使用方式,数据为虚构。
原始输入
客服转述:“好几个财务客户说导出报表不好用,汇总要自己算,希望能改一下,最好下个月能用。”
按字段表填写后的输入
- 业务背景:近一个月客服收到12起反馈,导出报表缺少汇总行,影响月度对账。
- 目标用户:财务专员,每月对账时使用。
- 问题描述:导出报表只有明细行,汇总数据需手工在Excel中计算,单次约耗时40分钟。
- 期望结果:导出文件中包含按科目汇总的行,金额与明细一致。
- 约束条件:需在下个结算周期前上线;导出格式兼容现有模板。
- 范围外内容:不调整报表权限体系,不新增其他报表类型。
- 验收口径:用上月数据导出,汇总行金额与手工计算结果一致。
- 依赖与假设:假设科目编码规则本季度不变;依赖数据组确认汇总口径。
AI整理输出与待澄清点
AI按固定结构输出需求描述,将问题、期望结果和验收口径对应起来,并列出待澄清点:汇总口径按科目还是按科目加期间;导出文件格式是Excel还是CSV;历史数据是否需要重新导出。这些待澄清点来自字段中未明确的信息,而非AI自行补充。
人工复核时补充或修正的内容
复核人确认汇总口径为“科目加期间”,导出格式沿用现有Excel模板,历史数据不重新导出并写入范围外内容。同时将“下个结算周期”明确为具体日期,回填字段表后定稿。复核记录中注明AI输出被删除的一处推测内容:AI曾建议新增汇总配置页面,原始输入中并无此要求。
完成检查:输入规范可用的判断标准
规范是否可用,不看文档篇幅,而看填写人能否照着填、评审人能否照着查。以下清单可逐项核对。
规范本身的检查项
- 范围说明列明适用需求类型与暂不适用场景;
- 必填字段不超过十个,每个字段都有说明、填写要求和示例;
- 字段表中至少包含一组正反例对照;
- 流程五步均有输入、动作、输出和完成标志;
- 角色职责与交付物一一对应,评审触发条件明确;
- 变更记录格式已定义并有至少一条示例。
单次输入的检查项
- 必填字段齐全,或“待确认”项已注明确认人和时间;
- 问题描述不含解决方案,期望结果可观察;
- 验收口径可通过具体操作验证;
- 范围外内容具体,能区分易混淆事项;
- 一条需求只对应一个主要问题和一个目标用户群体。
试点验证与观察指标
试点阶段选一类需求,用十到二十条真实需求跑通完整流程。可观察的指标包括:必填字段一次填写完整率、AI输出需要大段返工的比例、待澄清点数量及关闭时长、评审中重复出现的同类问题。指标不设统一阈值,由团队根据试点前基线确定改进目标。
规范迭代的触发条件
出现以下情况时应修订规范:某字段长期空置或长期填写“待确认”;AI输出频繁需要大段返工;出现新的需求来源类型;评审中反复出现同类澄清问题;流程节点因角色调整无法执行。每次修订记录变更内容、原因和生效时间,并对填写人做一次简短说明。ONES 建议企业先梳理研发流程、现有数据与高频协作问题,再确定AI能力的应用范围和推进路径,这一顺序同样适用于输入规范的试点与扩展。
常见问题
团队刚开始制定输入规范,字段一次定多少个比较合适?
建议第一版必填字段控制在八到十个,先覆盖业务背景、目标用户、问题描述、期望结果、约束条件、范围外内容、验收口径、依赖与假设这组核心要素。字段再多,填写人容易敷衍填空,校验时也难以逐项核对。选填字段可以随试点逐步增加,例如截图、历史讨论链接、参考产品。等团队对现有字段形成稳定填写习惯后,再根据评审中反复出现的澄清问题补充新字段。
需求提出方只能提供一句模糊的诉求,字段填不满怎么办?
按规范填写“待确认”并注明确认人和时间,不要用推测内容把字段填满。需求分析人员可以带着字段表组织一次简短澄清,把问题描述、期望结果和验收口径逐项问清;原始诉求中的原话可摘录到业务背景字段,保留信息出处。若关键字段在约定时间内仍无法确认,按评审触发条件提交评审,由评审人判断是继续澄清还是暂缓进入AI整理环节。
AI整理结果看起来合理,但和原始输入有出入,复核时怎么处理?
复核以原始字段表为准,逐条核对AI输出是否忠于输入。对原始输入中没有依据的补充内容,直接删除并在复核记录中注明;对AI列出的待澄清点,安排确认后回填字段表。若输入在提交AI之后发生实质变更,应重新执行自检、提交和复核,避免新旧版本混用。复核记录保留删除和修正的痕迹,便于后续追溯AI输出与人工定稿的差异。
试点阶段用什么指标判断规范是否值得继续推广?
可观察的指标包括:必填字段一次填写完整率、AI输出需要大段返工的比例、每条需求的待澄清点数量及关闭时长、评审中重复出现的同类问题。指标不设统一阈值,由团队根据试点前的基线确定改进目标。若试点中某字段长期空置或长期填写“待确认”,或AI输出频繁需要大段返工,说明字段设计或填写要求需要修订,此时先调整规范再扩大适用范围。
规范落地时,字段填写和评审记录放在哪里比较便于追溯?
常见做法是把字段表作为需求工作项的固定属性,填写与评审记录留在文档中,AI整理结果与人工修订版本对照保存。在统一平台上执行时,ONES Assistant 可连接 ONES Project、ONES Wiki 与 ONES TestCase,理解项目、工作项和 Wiki 页面等工作上下文,围绕需求澄清提炼要点、待澄清问题与拆解建议,输出过程可追踪,便于复核环节对照原始输入。具体字段模板与权限配置以团队实际环境为准。
