OneOS1.2/.cursor/skills/YunxiaoPM/references/sprint.md

创建迭代并关联交付

产品经理可将已交棒（或已有编号）的多条【交付】任务打进同一云效迭代。

口令

创建迭代：版本类型=副；交付任务=ONEOS-a,ONEOS-b,ONEOS-c；名称前缀=统一运营管理平台PC端
创建迭代：版本类型=子；交付任务=ONEOS-99；名称前缀=统一运营管理平台PC端

参数	规则
交付任务	1..N 个任务编号（逗号分隔）；禁止用标题凑数
版本类型	主 / 副 / 子；未点选则停下询问，禁止默认猜
名称前缀	可选；缺省 统一运营管理平台PC端。最终名={前缀}{版本号}

版本号 V{主}.{副}.{子}

版本类型	含义	递增
主	功能重制	主+1，副→0，子→0（V1.3.2→V2.0.0）
副	新功能上线	副+1，子→0（V1.3.2→V1.4.0）
子	bug/优化	子+1（V1.3.2→V1.3.3）

取基线再递增

1. 拉取当前项目云效迭代列表。
2. 从迭代名称解析 V数字.数字.数字；旧名 V数字.数字 视为 .0。
3. 同名称前缀内取最大版本为基线（主→副→子比较）；避免 PC 与小程序串号。
4. 按用户点选类型递增，写入新迭代名称。
5. 无一可解析版本：基线 V0.0.0 再递增（主→V1.0.0，副→V0.1.0，子→V0.0.1）；或口令显式给起始版本。

禁止：手填与规则冲突的版本号却声称自动生成；禁止用交付标题推断版本类型。

创建与关联

步骤	动作
1	算出新版本 → 拼迭代全名
2	创建迭代（起止日期口令未给则询问或用项目默认，禁止瞎填）
3	只挂【交付】：N 个交付任务挂迭代；交付失败不得报完成
4	幂等：同名迭代已存在 → 不新建，补挂尚未关联的交付，回报「复用迭代」
5	回报：迭代名、版本号、identifier、已关联交付编号、失败编号

禁止把需求挂进迭代（需求侧「迭代」字段保持空）。不挂【分析】/【设计】除非口令显式点名。
不在本步创建【开发】/【测试】。仍须 Plan 门禁。

挂接 API（已通 · 校验走 /extra）

PATCH /projex/api/workitem/workitem/{交付id}?_input_charset=utf-8
{"workitemIdentifier":"{交付id}","propertyKey":"sprint","propertyValue":"{sprintId}","operateType":"COVER"}

校验（详情主接口不含 sprint，勿用其判空）：

GET /projex/api/workitem/workitem/{id}/extra?_input_charset=utf-8
→ result.sprint[].identifier

清空误挂的需求迭代：同上 PATCH，propertyValue:"" + operateType:"COVER"（或 CLEAR）。