用任务描述代替功能口号
“支持智能问答、智能分析、自动执行”只描述能力名称,不能说明项目边界。需求应从使用者与目标出发,例如“售后人员输入故障描述后,系统从授权手册中查找依据,生成带引用的处理建议”。
随后写明触发条件、必要输入、期望输出与结束条件。对于多轮交互,注明哪些字段允许推断,哪些必须询问用户,哪些必须从业务系统获取,避免开发团队自行猜测。
每项任务需要一张说明卡
说明卡可包含任务编号、使用角色、业务步骤、数据来源、工具列表、权限、成功条件和异常分支。输出应区分自由文本、结构化草稿与正式业务操作,分别约定校验方式。
以工单助手为例,型号、问题描述和联系方式可能是必要字段;无法确认型号时应继续询问,不能随意补值。创建成功应返回正式工单编号,结果未知应提示核查,不能统一显示“提交完成”。
资料与权限要写到可执行程度
列出知识源、更新负责人、生效规则和允许访问人群。不要只写“对接知识库”,还要说明旧版本如何处理、引用能否打开,以及不同用户是否能够看到同一份资料。
工具接口需说明调用身份、参数来源、可用环境和业务错误。对于写入,明确确认节点、幂等要求、撤销或对账方式。权限控制由服务端落实,提示词只能辅助表达行为边界。
验收样本应与需求同步形成
每个任务准备正常、有歧义、缺字段、无答案、越权及接口失败样本,写明参考依据和允许行为。知识问答可以接受不同表达,但结论、条件和引用必须满足规则;不能只用完全相同的文本匹配评分。
性能与费用要求要说明并发、资料规模、任务长度、测试环境和统计口径。像“回答很快”“准确率高”这样的描述,应转化为待协商的指标,而不是在开发结束后才决定。
一张任务卡怎样关联验收
任务卡可以写成“售后人员生成工单草稿,必填产品编号和问题描述,未确认不得提交”。随后对应正常、缺编号、跨客户和超时用例,分别约定应展示草稿、询问、拒绝和待核查。这样业务规则、开发实现与测试使用同一编号关联。需求变化为自动提交时,需要重新确认授权与防重,而不是只删除确认按钮。
- 输入来源和必填字段是否明确。
- 预期输出是否区分草稿与正式记录。
- 异常路径是否有可观察结果。
- 变更是否同步修改验收样本。
管理范围与变化
需求文档还应列出明确排除项、客户配合事项、交付物和变更流程。新增一个系统接口,或将“生成建议”改为“自动提交”,可能影响架构、权限与测试,不应当作简单文案修改。
文档无需一开始就写得庞大,但要有版本与决策记录。业务人员能够确认任务,开发人员能够判断实现边界,测试人员能够据此编写用例,才算具备可执行的需求基础。