扩展氢能站点、加氢记录与台账原型链路,新增工作台、车辆资产 H5、自营物流等原型,并同步导航注册、PRD 资源与交付技能。
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
139
.cursor/skills/AutoVUL/SKILL.md
Normal file
139
.cursor/skills/AutoVUL/SKILL.md
Normal file
@@ -0,0 +1,139 @@
|
||||
---
|
||||
name: AutoVUL
|
||||
description: >-
|
||||
Generates OneOS PC version update logs from a Yunxiao (云效) iteration name by
|
||||
loading all linked requirements, or from a pasted changelog list. Use when testers
|
||||
or PMs say AutoVUL, 版本更新日志, 按迭代生成更新日志, 发版公告, or give a 迭代名称.
|
||||
---
|
||||
|
||||
# AutoVUL(OneOS PC 版本更新日志)
|
||||
|
||||
面向**测试人员发版**:输入云效**迭代名称** → 拉取该迭代关联需求 → 自动生成对外版本更新日志。
|
||||
|
||||
也可手动粘贴变更清单(兜底)。**预计维护时长**由人工单独通知,不写进日志。
|
||||
|
||||
## 何时使用
|
||||
|
||||
- 测试说:`按 $AutoVUL` / `生成版本更新日志` / `按迭代 xxx 出更新日志`
|
||||
- 输入含云效「迭代名称」
|
||||
- 发版前需要统一文案口径
|
||||
|
||||
## 主流程(测试 · 按迭代,默认)
|
||||
|
||||
完整取数步骤见 [references/yunxiao-sprint.md](references/yunxiao-sprint.md)。
|
||||
|
||||
```text
|
||||
1. 确认云效项目(缺省:统一运营管理平台PC端;可改)
|
||||
2. 向用户索取「迭代名称」(若口令里已带则直接用)
|
||||
3. 在云效查找该迭代 → 立即反馈成功或失败(见下)
|
||||
4. 成功:列出迭代内关联「需求」清单(编号 + 标题 + 状态)供用户快速核对
|
||||
5. 从每条需求提取变更素材(优先级见「素材优先级」)
|
||||
6. 按本文格式分类、合并、润色 → 输出成稿正文
|
||||
```
|
||||
|
||||
### 迭代读取 · 成功 / 失败反馈(强制)
|
||||
|
||||
查找迭代后**必须先反馈**,再继续或停止:
|
||||
|
||||
| 结果 | 反馈文案(可微调,语义不变) | 下一步 |
|
||||
|------|------------------------------|--------|
|
||||
| 精确命中 1 个迭代 | `✅ 已找到迭代「{名称}」(状态:{状态}),关联需求 {N} 条。` | 继续拉需求并生成 |
|
||||
| 0 个匹配 | `❌ 未找到迭代「{输入}」。请核对后重新输入迭代名称(可复制云效迭代标题)。` | **停止生成**;等待用户重输 |
|
||||
| 多个模糊匹配 | `⚠️ 找到多个相似迭代:1)… 2)… 请回复序号或完整精确名称。` | 等用户选定后再继续 |
|
||||
| 登录/权限失败 | `❌ 无法访问云效(未登录或无权限)。请在浏览器登录云效后重试,或改用手动清单。` | 停止;提示登录或兜底 |
|
||||
| 迭代存在但 0 条需求 | `⚠️ 迭代「{名称}」已找到,但暂无关联需求。请确认规划后再试,或改用手动清单。` | 停止生成对外正文 |
|
||||
|
||||
**失败后**:用户只需再发一次迭代名称(或纠正项目名),从步骤 2 重跑;不要要求用户重装 Skill。
|
||||
|
||||
### 素材优先级(每条需求)
|
||||
|
||||
| 顺序 | 来源 | 用法 |
|
||||
|------|------|------|
|
||||
| 1 | 需求描述中的「更新内容」段(非「更新内容·历史」) | 首选,直接改写成日志条目 |
|
||||
| 2 | AutoPRD「功能变更记录」中可对外部分 | 次选 |
|
||||
| 3 | 需求标题 + 简短描述摘要 | 仅当前两者皆空时;价值句可合理补全 |
|
||||
| — | 纯技术债、内部监控、未对用户开放 | **不写入**对外日志 |
|
||||
|
||||
Bug 类需求(类型/标签含缺陷修复、或更新内容写「修复」)归入【Bug修复】;其余归【新功能】。边界不清优先 Bug修复。
|
||||
|
||||
### 版本号与更新时间
|
||||
|
||||
| 字段 | 规则 |
|
||||
|------|------|
|
||||
| 版本号 | 优先从迭代名解析(如含 `V1.1.5` / `1.1.5`);解析不到再问用户 |
|
||||
| 更新时间 | 用户提供则用;未提供可写迭代计划开始日的 `MM月DD日HH:MM`,或先问 |
|
||||
| 产品线 | 默认 `OneOS PC版` |
|
||||
|
||||
## 兜底流程(手动清单)
|
||||
|
||||
无云效权限、或迭代为空时:用 [input-template.md](input-template.md) 粘贴清单,跳过迭代步骤,直接分类润色。
|
||||
|
||||
## 固定输出格式
|
||||
|
||||
```text
|
||||
OneOS PC版V{主.次.修订}更新日志:
|
||||
更新时间:{MM}月{DD}日{HH}:{MM}
|
||||
----------------------------------------------------
|
||||
【新功能】
|
||||
1「{模块名}」{做了什么},{责任部门}可{用户价值 / 解决的问题}
|
||||
2「{模块名}」{…}
|
||||
|
||||
【Bug修复】
|
||||
3「{模块名}」{修复了什么},{责任部门}可{恢复的能力 / 避免的影响}
|
||||
```
|
||||
|
||||
### 版式硬约束
|
||||
|
||||
| 项 | 规则 |
|
||||
|----|------|
|
||||
| 标题 | `OneOS PC版V` + 版本号 + `更新日志:`(如 `V1.1.5`,无空格) |
|
||||
| 更新时间 | 仅开始时刻;`MM月DD日HH:MM`;**禁止**「预计x分钟内完成」 |
|
||||
| 分隔线 | `----------------------------------------------------` |
|
||||
| 分区 | 仅 `【新功能】` / `【Bug修复】`;空类整段省略 |
|
||||
| 序号 | 全篇连续,从 1 起 |
|
||||
| 模块名 | `「」`;与产品菜单正式名一致 |
|
||||
| 对外正文 | **不写**需求号、缺陷号、迭代 ID(核对清单可另附) |
|
||||
| 结尾 | 无签名、无「感谢使用」、无技术附录 |
|
||||
|
||||
## 分类 / 合并 / 文案(成稿规则)
|
||||
|
||||
| 归入【新功能】 | 归入【Bug修复】 | 不写进对外日志 |
|
||||
|----------------|-----------------|----------------|
|
||||
| 新增能力、新入口、新字段/流程、可感知体验优化 | 原有能力异常、报错、数据错、交互失效 | 技术债、无感性能、未开放灰度、仅内部监控 |
|
||||
|
||||
- **同分区同模块**合并为一条,分点用 `;`
|
||||
- **跨分区**同模块分栏各写一条
|
||||
- 每条含:做什么 + 用户价值 + 责任部门自然嵌入(`{部门}人员可…`)
|
||||
- **禁止**「供…条线…使用」;部门对照 [module-role-mapping.md](module-role-mapping.md)
|
||||
- 禁止编造迭代内不存在的能力;存疑跳过或标待确认(不进正式成稿)
|
||||
- 单条建议 ≤100 字
|
||||
|
||||
排序:先新功能后修复;同分区全员影响优先;资金/合规修复置修复区最前。
|
||||
|
||||
## 输出纪律
|
||||
|
||||
1. **先**输出迭代读取反馈(✅/❌/⚠️)
|
||||
2. 成功时:可先给「本迭代需求清单」短表(含编号,便于测试核对)
|
||||
3. 再输出**纯文本成稿正文**(默认不要 Markdown 大标题包裹成稿)
|
||||
4. 用户明确要求时,可在正文后附「分类依据 / 跳过项」
|
||||
|
||||
## 发布前自检
|
||||
|
||||
- [ ] 已反馈迭代查找结果;失败时未强行编造成稿
|
||||
- [ ] 成稿条目均可追溯到本迭代关联需求素材
|
||||
- [ ] 标题、时间行、分隔线正确;无预计时长
|
||||
- [ ] 同模块合并正确;每条含价值 + 部门自然嵌入
|
||||
- [ ] 对外正文无需求号/缺陷号/技术黑话;序号连续
|
||||
|
||||
## 给测试同事的口令
|
||||
|
||||
```text
|
||||
按 $AutoVUL 生成版本更新日志。
|
||||
项目:统一运营管理平台PC端
|
||||
迭代名称:V1.1.5发版迭代
|
||||
更新时间:07月16日16:00
|
||||
```
|
||||
|
||||
迭代名写错时,按提示改完再发一次即可。
|
||||
|
||||
手动兜底见 [input-template.md](input-template.md);成稿范例见 [examples.md](examples.md)。
|
||||
77
.cursor/skills/AutoVUL/examples.md
Normal file
77
.cursor/skills/AutoVUL/examples.md
Normal file
@@ -0,0 +1,77 @@
|
||||
# AutoVUL 成稿与交互范例
|
||||
|
||||
## 1. 迭代读取失败 → 重输
|
||||
|
||||
**用户:**
|
||||
|
||||
```text
|
||||
按 $AutoVUL,迭代名称:V1.1.5
|
||||
```
|
||||
|
||||
**Agent:**
|
||||
|
||||
```text
|
||||
❌ 未找到迭代「V1.1.5」。请核对后重新输入迭代名称(可复制云效迭代标题)。
|
||||
```
|
||||
|
||||
**用户:**
|
||||
|
||||
```text
|
||||
V1.1.5发版迭代
|
||||
```
|
||||
|
||||
**Agent:**
|
||||
|
||||
```text
|
||||
✅ 已找到迭代「V1.1.5发版迭代」(进行中),关联需求 3 条:
|
||||
1. ONEOSP-201 车辆管理运营城市展示优化
|
||||
2. ONEOSP-202 还车应结款租金计算修复
|
||||
3. ONEOSP-203 业务管理新增租赁物流统计
|
||||
|
||||
OneOS PC版V1.1.5更新日志:
|
||||
更新时间:07月16日16:00
|
||||
----------------------------------------------------
|
||||
【新功能】
|
||||
1「车辆管理」优化车辆「运营城市」展示,运维部人员可快速辨认车辆所属运营区域及数据来源
|
||||
2「业务管理」新增租赁、物流业务统计模块,业务管理组、业务员可查看租赁经营数据,业务服务组、财务部可跟踪自营物流经营情况
|
||||
|
||||
【Bug修复】
|
||||
3「还车应结款」修复租金费用项重复及计算错误,业务管理组、安全部、运维部、能源部人员还车结算金额更准确
|
||||
```
|
||||
|
||||
## 2. 完整成稿风格基准(手动/迭代素材均可)
|
||||
|
||||
> 责任部门对照:`module-role-mapping.md`(OneOS 业务条线说明)
|
||||
|
||||
```text
|
||||
OneOS PC版V1.1.5更新日志:
|
||||
更新时间:07月16日16:00
|
||||
----------------------------------------------------
|
||||
【新功能】
|
||||
1「加氢站管理」升级新版加氢站模块,采购部可统一维护签约站与非签约站信息,签约加氢站可便捷管理站点日常运营
|
||||
2「车辆管理」优化车辆「运营城市」展示,运维部人员可快速辨认车辆所属运营区域及数据来源
|
||||
3「审批中心」支持按客户名称搜索关联合同,业务员、法务部审批时可快速定位合同;还车应结款添加照片附件后,业务管理组、安全部、运维部、能源部会签人员可在审批流中查看完整附件
|
||||
4「保险采购」支持保比价单按车辆单独勾选并分开提交审批,运维部、安全部人员可按车辆分批推进投保审批
|
||||
5「故障管理」增加「故障来源」字段展示,运维部人员可区分上报渠道并跟进处理
|
||||
6「证照管理」特种设备使用登记证/使用标识照片支持OCR识别,运维部、安全部人员可减少手工录入、加快证照建档
|
||||
7「全局显示」统一各模块列表分页样式与交互,各模块操作人员跨页面浏览时体验一致、上手更快
|
||||
8「交还车管理」支持交车/还车签章文件在线预览,运维部、业务管理组、司机可现场核对签章文件;提交时增加胎纹数据必填校验,减少漏填导致的后续结算争议
|
||||
9「还车应结款」调整安全部待办区域权限,安全部人员仅处理职责范围内的还车应结款审批
|
||||
10「业务管理」新增租赁、物流业务统计模块,业务管理组、业务员可查看租赁经营数据,业务服务组、财务部可跟踪自营物流经营情况
|
||||
|
||||
【Bug修复】
|
||||
11「还车管理」修复签字单与还车检查单/还车应结款轮胎数据不一致,运维部、业务管理组人员还车验收与结算依据保持一致
|
||||
12「租赁合同」修复编辑合同提交时异常提示内容冗余,业务员、法务部人员可快速定位真正错误原因
|
||||
13「交还车管理」修复交车/还车签章客户名称关联错误,避免运维部、业务管理组、司机现场核对时客户信息张冠李戴
|
||||
14「车辆氢费明细」修复同客户不同生效时段、以及不同客户成本单价显示异常,能源部人员可准确核对氢费核算单价
|
||||
15「还车应结款」修复租金费用项重复及计算错误,业务管理组、安全部、运维部、能源部人员还车结算金额更准确
|
||||
```
|
||||
|
||||
## 对照要点
|
||||
|
||||
| 规则 | 体现 |
|
||||
|------|------|
|
||||
| 先反馈迭代结果 | 失败可重输;成功列出需求再成稿 |
|
||||
| 无预计时长 | 更新时间仅 `07月16日16:00` |
|
||||
| 对外无需求号 | 成稿正文不出现 ONEOSP-xxx |
|
||||
| 部门自然嵌入 | `运维部人员可…`,无「供…条线使用」 |
|
||||
69
.cursor/skills/AutoVUL/input-template.md
Normal file
69
.cursor/skills/AutoVUL/input-template.md
Normal file
@@ -0,0 +1,69 @@
|
||||
# AutoVUL · 输入模板
|
||||
|
||||
## A. 测试人员 · 按云效迭代(推荐)
|
||||
|
||||
复制下面口令发给 AI(改迭代名即可):
|
||||
|
||||
```text
|
||||
按 $AutoVUL 生成版本更新日志。
|
||||
项目:统一运营管理平台PC端
|
||||
迭代名称:
|
||||
更新时间:
|
||||
```
|
||||
|
||||
### 期望反馈
|
||||
|
||||
- 成功:`✅ 已找到迭代「…」,关联需求 N 条` → 随后输出成稿
|
||||
- 失败:`❌ 未找到迭代「…」。请重新输入迭代名称` → 改名后再发一次即可
|
||||
|
||||
**说明**:预计维护时长由人工单独通知,不写入版本更新日志。
|
||||
|
||||
---
|
||||
|
||||
## B. 手动清单(云效不可用时兜底)
|
||||
|
||||
### 版本元信息
|
||||
|
||||
| 字段 | 填写 | 示例 |
|
||||
|------|------|------|
|
||||
| 产品线 | | OneOS PC版 |
|
||||
| 版本号 | | V1.1.5 |
|
||||
| 更新开始时间 | | 07月16日16:00 |
|
||||
| 发布范围 | 全量 / 灰度(说明) | 全量 |
|
||||
| 是否对外发布 | 是 / 否 | 是 |
|
||||
|
||||
### 新功能(原始材料,可粗糙)
|
||||
|
||||
| 模块 | 做了什么 | 解决什么问题 / 用户故事 | 业务条线 | 责任部门 | 是否写入日志 |
|
||||
|------|----------|-------------------------|----------|----------|--------------|
|
||||
| 例:加氢站管理 | 升级新版模块 | 统一维护站点 | 能源业务条线 | 采购部、加氢站 | 是 |
|
||||
| | | | | | |
|
||||
|
||||
### Bug修复(原始材料,可粗糙)
|
||||
|
||||
| 模块 | 原问题现象 | 修复后表现 | 对用户的影响 | 业务条线 | 责任部门 | 是否写入日志 |
|
||||
|------|------------|------------|--------------|----------|----------|--------------|
|
||||
| 例:还车应结款 | 租金费用项重复 | 金额正确 | 避免结算偏差 | 租赁业务条线 | 业务管理组、安全部、运维部、业务管理组-能源部 | 是 |
|
||||
| | | | | | | |
|
||||
|
||||
### 明确不要写入对外日志
|
||||
|
||||
- (如:重构、依赖升级、仅内部监控、未上线配置)
|
||||
|
||||
### 粘贴给 AI
|
||||
|
||||
```text
|
||||
请按 $AutoVUL 用下方手动清单生成成稿(跳过云效迭代)。
|
||||
要求:同模块合并;每条含「做什么 + 用户价值」;责任部门自然融入;只输出正文。
|
||||
|
||||
【版本元信息】
|
||||
- 产品线:OneOS PC版
|
||||
- 版本号:V
|
||||
- 更新开始时间:
|
||||
|
||||
【新功能】
|
||||
(粘贴)
|
||||
|
||||
【Bug修复】
|
||||
(粘贴)
|
||||
```
|
||||
60
.cursor/skills/AutoVUL/module-role-mapping.md
Normal file
60
.cursor/skills/AutoVUL/module-role-mapping.md
Normal file
@@ -0,0 +1,60 @@
|
||||
# 模块 → 业务条线 / 责任部门对照
|
||||
|
||||
> 数据源:OneOS「业务条线说明」页责任部门定义(租赁 / 能源 / 运维 / 安全 / 自营)
|
||||
> 生成更新日志时,**适用对象**须从此表取 `roles`,不得自造部门名。
|
||||
|
||||
## 五条业务条线
|
||||
|
||||
| ID | 条线名称 |
|
||||
|----|----------|
|
||||
| lease | 租赁业务条线 |
|
||||
| energy | 能源业务条线 |
|
||||
| ops | 运维管理条线 |
|
||||
| safety | 安全管理条线 |
|
||||
| self-operated | 自营业务条线 |
|
||||
|
||||
## 本版变更模块对照
|
||||
|
||||
| 更新日志模块名 | 业务条线 | lines.ts 模块 | 责任部门(roles,原文) |
|
||||
|----------------|----------|---------------|-------------------------|
|
||||
| 加氢站管理 | 能源业务条线 | 加氢站管理 | 采购部、加氢站 |
|
||||
| 车辆管理 | 运维管理条线 | 验车入库 / 车辆管理(资产底座) | 运维部、采购部 |
|
||||
| 审批中心 | 跨条线 | 租赁合同 + 还车应结款(审批场景) | 业务员、法务部、业务管理组、安全部、运维部、业务管理组-能源部 |
|
||||
| 保险采购 | 运维管理条线 | 证照 / 保险(车辆资产关联) | 运维部、安全部 |
|
||||
| 故障管理 | 运维管理条线 | 故障管理 | 运维部、司机 |
|
||||
| 租赁合同 | 租赁业务条线 | 租赁合同 | 业务员、法务部 |
|
||||
| 证照管理 | 运维管理条线 | 证照管理 | 运维部、安全部 |
|
||||
| 全局显示 | 全系统 | 系统介绍(五条条线) | 业务管理组、运维部、采购部、安全部、法务部、财务部、业务管理组-能源部、业务服务组 |
|
||||
| 交还车管理 | 运维管理条线 | 交车管理 + 还车管理 | 运维部、业务管理组、司机 |
|
||||
| 还车应结款 | 租赁业务条线 | 还车应结款 | 业务管理组、安全部、运维部、业务管理组-能源部 |
|
||||
| 还车管理 | 运维管理条线 | 还车管理 | 运维部、业务管理组 |
|
||||
| 车辆氢费明细 | 能源业务条线 | 车辆氢费明细 | 业务管理组-能源部 |
|
||||
| 业务管理 · 租赁统计 | 租赁业务条线 | 租赁业务台账 / 客户管理 | 业务管理组、业务员 |
|
||||
| 业务管理 · 物流统计 | 自营业务条线 | 自营台账 | 业务服务组、财务部 |
|
||||
|
||||
## 写法规则
|
||||
|
||||
- 部门名与 `roles` **完全一致**(`业务管理组-能源部` 对外可简写「能源部人员」)
|
||||
- **禁止**「供…业务条线…使用」「供…人员使用」
|
||||
- **推荐**:`{部门}人员可…` / `{部门}可…` / `{部门}审批时可…`
|
||||
- 同模块合并后,多部门用顿号或分号自然串联
|
||||
- 找不到模块时:查 `lines.ts`;仍无则标「待产品确认」不进成稿
|
||||
|
||||
## 自然表述示例
|
||||
|
||||
| 模块 | 生硬(禁止) | 自然(推荐) |
|
||||
|------|--------------|--------------|
|
||||
| 车辆管理 | 供运维管理条线运维部使用 | 运维部人员可快速辨认车辆所属运营区域 |
|
||||
| 加氢站管理 | 供能源业务条线采购部、加氢站使用 | 采购部可统一维护站点信息,加氢站可便捷管理日常运营 |
|
||||
| 还车应结款 | 供租赁业务条线业务管理组…使用 | 业务管理组、安全部、运维部、能源部还车结算金额更准确 |
|
||||
|
||||
## 常见错误(禁止)
|
||||
|
||||
| 错误写法 | 正确写法 |
|
||||
|----------|----------|
|
||||
| 氢能运营业务人员 | 采购部、加氢站(能源 · 加氢站管理) |
|
||||
| 车辆运营及资产管理业务人员 | 运维部、采购部(运维 · 车辆管理) |
|
||||
| 各业务条线审批人员 | 业务员、法务部、…(按审批场景枚举) |
|
||||
| 保险采购业务人员 | 运维部、安全部 |
|
||||
| 还车结算业务人员 | 业务管理组、安全部、运维部、业务管理组-能源部 |
|
||||
| 经营分析及管理部门 | 业务管理组、业务服务组(分租赁 / 自营) |
|
||||
81
.cursor/skills/AutoVUL/references/yunxiao-sprint.md
Normal file
81
.cursor/skills/AutoVUL/references/yunxiao-sprint.md
Normal file
@@ -0,0 +1,81 @@
|
||||
# 云效迭代 → 需求清单(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)。
|
||||
Reference in New Issue
Block a user