扩展氢能站点、加氢记录与台账原型链路,新增工作台、车辆资产 H5、自营物流等原型,并同步导航注册、PRD 资源与交付技能。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
王冕
2026-07-21 17:15:39 +08:00
parent e39df1c7c8
commit a01d2ab708
242 changed files with 102296 additions and 4866 deletions

View File

@@ -0,0 +1,81 @@
# 云效迭代 → 需求清单AutoVUL 取数)
测试人员只提供**迭代名称**Agent 负责在云效定位迭代、拉取关联需求、抽出更新素材。
## 安全边界(强制)
- **禁止**在对话、Skill、日志、成稿中写入 Token、密码、Cookie、私钥。
- 优先复用**已登录浏览器会话**操作云效 Projex`yunxiao-requirement-lifecycle` 一致)。
- 若团队已配置本机环境变量访问 OpenAPI可走 APIToken 只读自环境,永不回显。
建议环境变量(可选,名称可按团队调整):
| 变量 | 用途 |
|------|------|
| `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