# 云效迭代 → 需求清单（AutoVUL 取数）

测试人员只提供**迭代名称**；Agent 负责在云效定位迭代、拉取关联需求、抽出更新素材。

## 安全边界（强制）

- **禁止**在对话、Skill、日志、成稿中写入 Token、密码、Cookie、私钥。
- 优先复用**已登录浏览器会话**操作云效 Projex（与 `yunxiao-requirement-lifecycle` 一致）。
- 若团队已配置本机环境变量访问 OpenAPI，可走 API；Token 只读自环境，永不回显。

建议环境变量（可选，名称可按团队调整）：

| 变量 | 用途 |
|------|------|
| `YUNXIAO_TOKEN` | 个人访问令牌（`x-yunxiao-token`） |
| `YUNXIAO_DOMAIN` | 服务接入点域名 |
| `YUNXIAO_ORG_ID` | 组织 ID（中心版） |
| `YUNXIAO_PROJECT_ID` | 默认项目 ID（或运行时按项目名解析） |

## 默认项目

口令未指定时：`统一运营管理平台PC端`。项目名不精确时先问清再查迭代。

## 判定顺序：解析迭代

| 顺序 | 条件 | 结果 |
|------|------|------|
| 1 | 用户未给迭代名称 | 询问：「请输入云效迭代名称（可复制标题）」；不继续 |
| 2 | 项目未确定 | 询问精确项目名；不继续 |
| 3 | 云效不可访问 | `❌ 无法访问云效…`；不继续 |
| 4 | 名称精确匹配 1 条迭代 | `✅ 已找到迭代…`；进入拉需求 |
| 5 | 0 条 | `❌ 未找到迭代…请重新输入`；不继续 |
| 6 | >1 条相似 | `⚠️ 多个相似…请回复序号或精确名称`；等用户选定 |
| 7 | 命中但关联需求 0 | `⚠️ …暂无关联需求`；不生成对外正文 |

匹配规则：先**全等**（去首尾空格）；全等失败再做包含/去空格模糊；模糊多条必须让用户确认，禁止擅自挑一个。

## 拉取关联需求

只收集工作项类型为**需求（Req）**且正式关联到该迭代的项。

- **浏览器路径**：打开项目 → 迭代 → 该迭代规划/工作项列表 → 筛选类型=需求 → 导出或逐条打开描述。
- **OpenAPI 路径（示意）**：
  1. `ListSprints`：按项目列迭代，用 `name` 匹配用户输入，得到 `sprintId`
  2. `SearchWorkitems`：`category=Req`，`spaceId=项目Id`，`conditions` 中按字段 `sprint` CONTAINS `[sprintId]`（以租户实际 fieldIdentifier 为准；可先在需求列表页过滤后复制 `workitem/list` 的 conditions）
  3. 分页直到收齐（关注响应头 `x-total`）
  4. 需要正文时再 `GetWorkitem` 取 description

每条需求最少记录：

| 字段 | 说明 |
|------|------|
| serialNumber | 如 ONEOSP-123（仅用于核对清单，**不进对外成稿**） |
| subject | 标题 |
| status | 状态展示名 |
| description | 用于抽取「更新内容」 |
| category / type / labels | 辅助判断新功能 vs 修复 |

## 从描述抽「更新内容」

1. 定位标题「更新内容」或「## 更新内容」段落
2. **不要**把「更新内容·历史」并入本版素材（历史仅备查）
3. 若无「更新内容」：用标题 + 需求说明摘要；仍无有效产品语义则跳过并在内部备注

## 成功反馈后的核对清单（推荐短表）

在生成成稿前输出，例如：

```text
✅ 已找到迭代「V1.1.5发版迭代」（进行中），关联需求 5 条：
1. ONEOSP-101 保险采购比价分车提交
2. ONEOSP-102 交还车签章预览
…
正在按 AutoVUL 格式生成更新日志…
```

用户若立刻纠正「某条不要进日志」，从素材中剔除后再出成稿。

## 与发版任务关系

本 Skill **只读**迭代与需求，**不创建**【发版】任务、不改云效状态。发版挂链仍用 `yunxiao-requirement-lifecycle`（如「准备发布」口令 / A08）。