OneOS1.2/.cursor/skills/yunxiao-requirement-lifecycle/references/lifecycle-rules.md

需求生命周期与项目规则

目录

1. 状态参数化
2. R01–R12规则矩阵
3. 阶段入口和阶段完成
4. 开发开始与开发完成
5. 标签、任务和关键字
6. 规则实例与限制

1. 状态参数化

典型流程为：

待处理 → 已确认 → 分析中 → 分析完成 → 设计中 → 设计完成 → 待开发
→ 开发中 → 开发完成 → 测试中 → 测试完成 → 完成发布/发布完成 → 已完成/已关闭

逐项目读取真实状态。完成发布与发布完成、已完成与已关闭是候选映射，不能静默互换或创建近义重复状态。

2. R01–R12规则矩阵

ID	流转	触发事件	必要条件	动作	方式
R01	待处理 → 已确认	负责人确认	范围、负责人、优先级、验收口径明确	改为已确认	人工
R02	已确认 → 分析中	添加关联任务工作项	当前状态；需求自身标签包含分析	改为分析中	原生规则
R03	分析中 → 分析完成	关联任务状态变化	当前状态；本阶段分析任务全部完成	改为分析完成	原生/条件化
R04	分析完成 → 设计中	添加关联任务工作项	当前状态；需求自身标签包含设计	改为设计中	原生规则
R05	设计中 → 设计完成	关联任务状态变化	当前状态；本阶段设计任务全部完成	改为设计完成	原生/条件化
R06	设计完成 → 待开发	添加关联任务工作项	当前状态；需求自身标签包含开发	改为待开发	原生规则
R07	待开发 → 开发中	添加关联分支或正式关联代码资产	当前状态；仓库已集成；资产正式关联	改为开发中	自动兜底
R08	开发中 → 开发完成	关联合并请求状态变化	当前状态；全部相关MR已合并	改为开发完成	原生规则
R09	开发完成 → 测试中	添加关联任务工作项	当前状态；需求自身标签包含测试	改为测试中	原生规则
R10	测试中 → 测试完成	测试验收任务或获批回调	当前状态；用例、失败复测、缺陷均闭环	改为测试完成	人工/桥接
R11	测试完成 → 发布完成状态	发布变更完成或获批回调	当前状态；目标环境发布证据有效	改为真实发布状态	原生/桥接
R12	发布完成状态 → 项目终态	业务验收	当前状态；验收证据有效	改为真实终态	默认人工

R05–R10与阶段任务自身状态的双向联动见task-lifecycle.md；R10的用例和缺陷口径见test-defect-closure.md；R11、R12见pipeline-release.md；R07、R08的代码资产口径见codeup-integration.md。

3. 阶段入口和阶段完成

R02、R04、R06、R09同时要求：

1. 从需求中“新建并关联”或“关联已有”任务工作项。
2. 当前状态等于前一阶段完成状态。
3. 需求自身包含目标阶段标签。

如果规则编辑器不能读取需求自身标签，标签只能用于筛选和报表；保留人工入口或使用当前状态+显式关联事件，不能声称标签已成为技术门槛。

R03、R05首选“本阶段任务全部完成”。若平台只能判断“全部关联任务工作项”，选择一种明确策略：

• 阶段开始时才创建/关联本阶段任务。
• 使用不同工作项类型，并确认规则能按类型过滤。
• 使用父子需求拆分阶段。
• 保留人工完成动作。

不得把零个关联任务当作全部完成。使用关联项状态变化触发，并执行零关联项负向测试。

4. 开发开始与开发完成

R07采用双轨口径：

• 效能主口径：开发人员真实开工时执行“开始开发”。
• 自动兜底：创建或正式关联需求分支/代码资产后进入开发中。

首次提交可能晚于真实开工，不能作为权威开始时间。自动规则必须要求当前状态=待开发。

R08推荐定义：

事件 = 关联合并请求状态变化
且当前状态 = 开发中
且全部相关合并请求 = 已合并
则状态 = 开发完成

提交活动不能证明开发完成。全部相关前端、后端MR都必须正式关联并合并到实际集成分支。

5. 标签、任务和关键字

分析、设计、开发、测试标签加在产品类需求自身。

“添加关联任务工作项”依赖云效正式关系，不依赖标题关键字。有效方式：

• 在需求详情新建并关联任务。
• 在需求详情关联已有任务。
• 在任务详情选择该需求为父项/关联项，并在页面确认关系。

仅写需求编号、粘贴链接或添加同名标签都不能替代正式关联。编号仍建议出现在标题中，方便检索和审计。

6. 规则实例与限制

每个项目分别记录R01–R12的实际规则显示名/人工门禁、精确触发、源状态、目标状态、全部条件、动作、顺序、启用状态、执行账号和证据。

已知限制：

• 规则通常异步执行，5–30秒内不要过早判失败。
• “全部关联项”只能看到已集成并正式关联的资产。
• 提前创建未来阶段任务可能阻塞“全部任务完成”。
• 需求状态规则不会自动更新阶段任务状态；必须同时配置TK01–TK08。
• 平台能力因模板、版本和权限不同，以当前UI和执行日志为准。