This guide is currently available in Simplified Chinese.
在软件工厂中,一项业务想法会逐步形成需求、明确规格,再进入具体的交付过程。理解这些概念,可以帮助你找到对应的材料、判断当前进度,并知道下一步需要确认什么。
本文延续“会员活动目标人群筛选”的例子:运营人员希望按会员等级、地区和最近消费时间筛选人群,并查看预计覆盖人数。
先了解各个概念负责什么
这些概念从不同角度描述同一项工作。例如,需求项可以已经通过评审,但尚未加入交付批次;一个批次可以已经完成代码实现,但仍在等待业务验收。
工作空间:项目的协作范围
工作空间用于集中组织一个项目的资源与协作。 团队在这里关联代码仓库、管理成员、查看归属该项目的需求项与规格,并跟踪交付批次和工作流。
例如,“会员营销系统”工作空间承载会员筛选功能的开发与维护。团队后续增加积分、活动或优惠券相关能力时,可以根据实际系统归属,把相应工作组织到这个工作空间中。
工作空间可以根据配置创建新应用和代码库、关联已有应用,或关联外部代码库。代码仓库保存项目文件和代码;工作空间还负责组织参与者、需求与交付过程。关联仓库后,可用的预览、测试和发布能力仍取决于项目环境的接入情况。
开始工作前,先确认当前工作空间和需求项归属,避免在错误的项目上下文中讨论或执行任务。
需求与需求项:业务目标和具体交付内容
需求记录一次业务诉求的背景、目标与范围;需求项将其中的具体内容拆开,便于分别评审和跟踪。
例如,“支持活动目标人群筛选”可以包含三个需求项:
- 组合条件筛选:按会员等级、地区和最近消费时间筛选会员。
- 覆盖人数预估:展示当前条件匹配的人数,并说明统计口径。
- 保存筛选方案:保存常用条件,供后续活动复用。
拆分时,每个需求项都应有明确的范围和验收条件。这样,团队可以决定先交付哪部分,也能分别记录评审意见与后续进度。
进入交付前,需要关注两件事:准入评审确认需求项是否可以进入后续研发安排;归属确认明确由哪个工作空间承接。两者各有作用,通过准入后仍需确认项目归属及其他交付条件。
查看父需求时,可以了解整体诉求和汇总进度;查看需求项时,可以了解某一部分的规格、评审结论与交付情况。判断具体功能是否可以开始实施,应查看对应需求项的状态。
规格:把预期行为写清楚
规格描述系统在特定条件下应当如何工作。 它把业务目标细化为可讨论、可实现、可检查的规则,通常包含目标、场景、业务规则、边界、异常处理和验收条件。
对于“组合条件筛选”,规格可以写成:
当运营人员同时选择“金卡会员”和“上海地区”时,筛选结果只包含同时满足这两个条件的会员。没有匹配会员时,覆盖人数显示为 0,并保留已选条件,方便继续调整。
这段描述明确了条件之间的关系、正常结果和空结果处理。开发人员据此实现功能,测试与验收人员据此准备检查场景。
需求提案侧重说明背景、目标和本次范围;原型帮助讨论页面与交互;技术设计说明实现方式;规格明确需要满足的行为。审阅时,可以将这些材料结合起来,检查是否存在遗漏或矛盾。
软件工厂还提供规格资产,用于集中查看已整理或导入的规格、版本信息和关联关系。团队可以从中查找已有规则,为后续需求提供参考。采用已有规格前,需要确认其适用范围和版本。
规格中的验收条件描述预期结果。判断实现是否满足这些条件,需要检查当前代码、运行效果和实际验证结果。
交付批次:明确本次交付范围
交付批次用于组织同一工作空间内,本次一起推进的需求项。 一个批次可以包含一个或多个符合条件的需求项,这些需求项也可以来自不同的父需求。
例如,团队可以创建“人群筛选首期”批次,纳入“组合条件筛选”和“覆盖人数预估”。“保存筛选方案”仍保留在需求中,等待后续安排。
因此,查看一个批次时,首先要确认它包含哪些需求项。批次完成后,应按本次范围检查交付结果;父需求中未纳入的内容仍需继续跟踪。
交付批次关联具体工作流,由工作流组织方案准备、实施、验证等步骤。创建批次前,系统会检查需求项状态、工作空间归属和已有批次关联等条件,防止不符合条件的需求项进入本次交付。
工作流:规定步骤并记录执行进度
工作流组织一次工作的阶段、可执行操作和阶段之间的衔接。 理解它时,需要区分“流程定义”和“流程实例”。
流程定义是一套可配置的流程模板,规定有哪些阶段、每个阶段可以做什么,以及何时进入下一阶段。模板发布后形成一个确定的版本,供后续执行采用。
流程实例是按某个已发布版本启动的一次具体执行。它关联工作空间和执行环境,记录当前阶段、执行状态、会话及操作历史。查看某次交付进展时,关注的是它关联的流程实例。
实例创建时会固定采用的流程版本。例如,“人群筛选首期”按版本 1 启动后,即使管理员发布版本 2,已有实例仍按版本 1 的规则执行。新实例采用哪个版本,取决于创建时的选择或默认配置。
标准交付流程提供以下预设阶段:
提案确认 → 方案准备 → 生产与测试 → 业务验收 → 上线 → Spec 归档
具体项目可以采用其他已发布的流程定义,页面展示的阶段和可用操作以当前实例为准。流程中可以包含 AI 执行、系统处理和人工确认;需要人工决策时,由具备相应权限的成员完成操作。
交付批次描述本次要做的内容,工作流实例描述这次工作如何推进。平台也可以为问题修复等工作启动相应的流程实例,具体入口取决于项目配置。
会话、执行环境与交付记录
在上述工作中,你还会遇到三类信息:
- 会话:团队与 AI 交流任务背景、补充约束、查看处理过程的入口。判断任务进度时,应同时查看关联需求项或工作流的状态。
- 执行环境:AI 读取项目文件、修改代码和运行命令的工作环境,也称沙箱(Sandbox)。当前仓库内容和实际运行结果是检查实现情况的重要依据。
- 交付记录:阶段文档、报告与产物快照等,用于了解某次执行发生了什么。阅读时应留意对应阶段、生成时间和验证范围。
记录缺失与业务操作失败需要分别判断。如果页面提示某份报告或快照不可用,应结合执行状态、当前环境和错误说明确认影响;验收、授权和发布结果则需要查看对应的正式状态与操作记录。
使用时,可以从当前要解决的问题出发:明确业务诉求时查看需求,核对具体规则时查看规格,确认本次范围时查看交付批次,跟踪执行进度时查看工作流实例。