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

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-21 17:15:39 +08:00
parent e39df1c7c8
commit a01d2ab708
242 changed files with 102296 additions and 4866 deletions
--- a/.cursor/skills/yunxiao-requirement-lifecycle/references/simple-role-commands.md
+++ b/.cursor/skills/yunxiao-requirement-lifecycle/references/simple-role-commands.md
@@ -0,0 +1,417 @@
+# 云效日常口语化操作口令
+
+## 1. 先说一次项目
+
+每次新会话先输入：
+
+```text
+项目：统一运营管理平台PC端
+```
+
+之后直接说口令即可。项目没有明确、同一编号可能属于多个项目或用户切换项目时，Codex必须先问清项目，不能猜。
+
+口令可以自然表达，不要求标点完全一致。例如：
+
+- `记录需求：增加车辆批量导出`
+- `帮我记录一个需求，增加车辆批量导出`
+
+两句话含义相同。
+
+## 2. 产品和需求
+
+### 记录需求
+
+产品输入：
+
+```text
+记录需求：增加车辆批量导出
+```
+
+Codex执行：查重后在当前项目创建产品类需求，初始状态为`待处理`，返回需求编号。只有标题也可以先记录；云效必填字段缺失时只追问缺少的字段。
+
+**带模块/原型的记录（OneOS）：** 若口令含模块名或原型（如「记录需求：保险采购」），创建前**先调用 `$oneos-autoprd`**，把「需求说明」写入描述；若用户同时定稿，一并写入「更新内容」。
+
+**统一运营管理平台 · 快路径（强制）：** 项目为「统一运营管理平台 / PC 端」时，先读 [oneos-pc-fast-path.md](oneos-pc-fast-path.md) 与 [oneos-pc-runtime-ids.json](../assets/oneos-pc-runtime-ids.json)。用已验证 `POST /workitem/workitem` 建单（创建时带 `document`），不要探测 `/workitem/create`。推进至「开发中」时状态连跳：`待处理 → 设计完成 → 待开发 → 开发中`。
+
+**优先级 / 推进至 Plan 单选门禁（强制）：** 用户要求 Plan 模式单选，或口令含「优先级」「推进至」需点选时：
+
+1. 先用 `AskQuestion`（可用时）或 Plan 确认拿到 A（紧急/高/中/低）与 B（分析中/设计中/设计完成/开发中）。
+2. **禁止**未选时默认「中 + 分析中」并继续建单。
+3. 「批准 / Implement 计划」本身不等于已选 A+B；计划里仍是空选项时必须先问清。
+4. 标签须用户从云效标签 catalog（`oneos-pc-tag-catalog.md`）点选；禁止按业务条线说明/`lines.ts` 自动推断。点选后 API 打标，失败则停并请用户回复标签名，禁止假装成功。
+
+**完整可复制提示词（推荐）：** 统一运营管理平台建单优先用 [oneos-pc-record-requirement-prompt.md](oneos-pc-record-requirement-prompt.md)——含 `$yunxiao-requirement-lifecycle` + `$oneos-autoprd`、A/B/C 三门禁与 30 项标签枚举。复制该文件「用户口令」整段发给 Agent；确认后再执行快路径。
+
+简短版（填需求名与模块后复制）：
+
+```text
+使用 $yunxiao-requirement-lifecycle + $oneos-autoprd
+记录需求到云效 · 统一运营管理平台
+
+【需求名】（填写）
+【描述来源】$oneos-autoprd，原型/模块：（填写）
+
+请先 Plan 让我点选 A 优先级、B 推进至、C 标签（30 项 catalog，见 oneos-pc-record-requirement-prompt.md；禁止 lines.ts 推断）。
+我确认后再执行快路径建单。
+```
+
+确认回复示例：`优先级：高；推进至：设计完成；标签：运维管理条线`
+
+### 确认需求
+
+产品输入：
+
+```text
+确认需求：ONEOSP-123
+```
+
+Codex执行：检查范围、负责人、优先级和验收标准，齐全后把需求改为`已确认`。
+
+`确认需求`默认不创建分析任务。确认和真实开始分析是两个事件，防止开始时间失真。由分析人员下一步输入`开始分析`。
+
+### 需求定稿（原型 + AutoPRD）
+
+产品输入：
+
+```text
+保险采购需求定稿
+```
+
+或：
+
+```text
+需求定稿：ONEOSP-123；模块=保险采购
+```
+
+Codex执行：
+
+1. 调用 `$oneos-autoprd` 定稿流程：更新原型 `.spec/requirements-prd.md` 第 10 章「功能变更记录」与 `autoprd-baseline.json`（只记功能/逻辑，不记样式/UI/表结构）。
+2. 若已有云效需求编号：刷新描述中的「需求说明」与「更新内容」；旧更新内容 →「更新内容·历史」。
+3. 若口令要求进待开发/发对象存储：继续走下方「快速进入开发」或 OneOS 快轨口令，不得跳过 AutoPRD。
+
+### 快速进入开发
+
+产品输入：
+
+```text
+快速开发：ONEOSP-123；原因=小改动；负责人=张三；范围=只改后端
+```
+
+Codex执行：检查项目是否允许快轨、验收标准是否明确，再跳过不需要的分析/设计阶段并建立必要开发任务。条件不齐时不跳状态，只提示缺少什么。
+
+**OneOS 模块已定型进待开发（推荐）：**
+
+```text
+「保险采购」需求已经确定：先 AutoPRD 写需求说明与更新内容；发布对象存储并写入描述；
+推进到待开发；自动建与需求同名的【交付】任务并正式关联；负责人何斐。
+```
+
+执行前必须先跑 `$oneos-autoprd`（含定稿变更记录若用户刚定稿）。进入待开发时**必须**执行 [auto-stage-task.md](auto-stage-task.md)（同名任务、标签交付、负责人何斐、时间沿用需求）；已有唯一交付任务则复用并改负责人为何斐，禁止建第二条。
+
+### 需求变更
+
+产品输入：
+
+```text
+变更需求：ONEOSP-123；增加导出时间筛选
+```
+
+Codex执行：先分析受影响的任务、MR、用例、缺陷和发布范围，给出应回到哪个阶段；产品确认后再修改，不直接覆盖历史说明。涉及原型功能变更时，同步 `$oneos-autoprd` 更新 PRD；用户再说「定稿」时写入第 10 章。
+
+## 3. 分析和设计
+
+### 开始分析
+
+分析人员输入：
+
+```text
+开始分析：ONEOSP-123；负责人=李四
+```
+
+Codex执行：
+
+1. 将需求推进到`分析中`（或确认已在分析中）。
+2. **按 [auto-stage-task.md](auto-stage-task.md)**：查重后创建/复用与需求**同名**任务；标签=`分析`；正式关联需求；负责人默认=需求**创建人**（口令写了负责人则用口令）；计划开始/创建时间沿用需求。
+3. 任务进入`处理中`（或项目约定的开工态）。
+4. `stage_tasks`：需求标签含`分析`。`oneos_delivery`：不因此再建第二条【交付】主任务。
+
+### 分析完成
+
+分析人员输入：
+
+```text
+分析完成：ONEOSP-123；说明=https://...
+```
+
+Codex执行：检查分析产物和未决项；完成对应任务或主任务阶段，核查需求进入`分析完成`。
+
+### 开始设计
+
+设计人员输入：
+
+```text
+开始设计：ONEOSP-123；负责人=王五
+```
+
+Codex执行：
+
+1. 将需求推进到`设计中`。
+2. **按 auto-stage-task**：同名任务；标签=`设计`；正式关联；负责人默认=需求**创建人**（口令可覆盖）；时间沿用需求。
+3. 任务开工态同上。
+4. `oneos_delivery`：不同时新建交付主任务（交付主任务在待开发时建/复用）。
+
+### 设计完成
+
+设计人员输入：
+
+```text
+设计完成：ONEOSP-123；原型=https://...
+```
+
+Codex执行：检查原型或设计说明，完成设计任务/主任务阶段，核查需求进入`设计完成`。
+
+如果项目已经部署并验证自动建开发任务的桥接，而且负责人、仓库和范围明确，Codex继续查重并创建开发任务；否则停在`设计完成`，提示技术负责人输入`安排开发`。不得创建无负责人或重复任务。
+
+**进入待开发时（含快轨）：** 必须再跑 auto-stage-task：同名任务、标签`交付`（或`开发`）、负责人**何斐**、正式关联、时间沿用需求。
+
+## 4. 开发
+
+### 安排开发
+
+技术负责人输入：
+
+```text
+安排开发：ONEOSP-123；前端=张三/ln-one-os-web；后端=李四/ln-cloud
+```
+
+只改一端时可以说：
+
+```text
+安排开发：ONEOSP-123；只改后端=李四/ln-cloud
+```
+
+Codex执行：按实际范围创建一条或多条`【开发】`任务，正式关联需求；`oneos_delivery`还要关联交付主任务。任务初始为`待处理`，需求进入`待开发`。明确“不涉及”的仓库不会成为完成门禁。
+
+### 开始开发
+
+开发人员输入：
+
+```text
+开始开发：ONEOSP-123；任务=TASK-456；仓库=ln-cloud
+```
+
+Codex执行：记录真实开始时间，确认真实基线`dev`或`develop`，创建`feature/ONEOSP-123`并同时正式关联需求和开发任务。任务进入`处理中`，需求进入`开发中`。
+
+首次提交只作兜底，不覆盖这次真实开始时间。
+
+### 提交代码
+
+开发人员输入：
+
+```text
+提交代码：ONEOSP-123；任务=TASK-456；仓库=ln-cloud
+```
+
+Codex执行：检查改动和测试，先拉取并处理冲突，再提交、推送并创建合并到真实`dev/develop`的MR；MR同时关联需求和开发任务。提交成功不等于开发完成。
+
+### 开发完成
+
+开发人员或技术负责人输入：
+
+```text
+开发完成：ONEOSP-123
+```
+
+Codex执行：汇总该需求所有非取消开发任务、前后端仓库和正式关联MR。只有全部任务完成、全部相关MR已合并，才确认需求进入`开发完成`；少一个仓库也不提前完成。
+
+条件满足后，如果项目已配置并验证唯一测试任务桥接，则查重创建测试任务；否则提示测试负责人输入`提交测试`。
+
+## 5. 测试和缺陷
+
+### 提交测试
+
+测试负责人或开发负责人输入：
+
+```text
+提交测试：ONEOSP-123；test流水线=oneos-web-test
+```
+
+Codex执行：确认开发完成，触发或核查明确的test流水线。部署成功后，查重创建并正式关联唯一测试任务和需求用例包，进入`待测试/测试中`的项目真实状态。
+
+test成功只允许开始测试，不能变成发布完成。
+
+### 开始测试
+
+测试人员输入：
+
+```text
+开始测试：ONEOSP-123；负责人=赵六
+```
+
+Codex执行：核查test部署和测试任务，把测试任务改为`测试中/处理中`，需求进入`测试中`。
+
+### 发现Bug
+
+测试人员输入：
+
+```text
+发现Bug：ONEOSP-123；用例=CASE-12；现象=车辆来源显示0；期望=显示中文来源
+```
+
+Codex执行：查重后创建缺陷，正式关联需求、原失败用例和必要开发任务；用例保持未通过，需求保持`测试中`。
+
+### Bug修复完成
+
+开发人员输入：
+
+```text
+Bug修复完成：BUG-123；MR=456；已部署test
+```
+
+Codex执行：核查代码、MR和test部署后，把缺陷改为`已修复`并交给测试复测。不会关闭缺陷，也不会把原用例直接改成通过。
+
+### 复测通过
+
+测试人员输入：
+
+```text
+复测通过：BUG-123；用例=CASE-12
+```
+
+Codex执行：重新记录原用例为通过，把缺陷改为项目真实关闭态，再检查该需求是否还有失败、阻塞、未执行用例或未关闭缺陷。
+
+### 复测失败
+
+测试人员输入：
+
+```text
+复测失败：BUG-123；用例=CASE-12；现象=仍显示0
+```
+
+Codex执行：原用例保持未通过，缺陷重开或回到处理中，并通知修复负责人；需求保持`测试中`。
+
+### 测试完成
+
+测试负责人输入：
+
+```text
+测试完成：ONEOSP-123
+```
+
+Codex执行：检查本需求用例包，不按整个迭代一刀切。只有没有未执行、阻塞、失败用例，且所有缺陷都经过测试复测关闭，才完成测试任务并推进需求到`测试完成`。
+
+## 6. 发布和验收
+
+### 准备发布
+
+运维或项目负责人输入：
+
+```text
+准备发布：迭代V1.3；需求=ONEOSP-123,ONEOSP-124；窗口=今晚22:00
+```
+
+Codex执行：检查本批需求均测试完成，查重创建或复用唯一`【发版】`任务，正式关联迭代和需求，生成发布范围及回滚清单。
+
+### 开始发布
+
+运维输入：
+
+```text
+开始发布：发版任务=TASK-900；prod流水线=oneos-prod；审批人=王经理
+```
+
+Codex执行：核查审批、本批范围、生产流水线和回滚方案后进入`发布中`。这句话授权执行明确的本次生产发布，但不授权修改生产流水线定义。
+
+### 发布成功
+
+运维输入：
+
+```text
+发布成功：执行ID=PIPE-789；发版任务=TASK-900
+```
+
+Codex执行：到生产流水线核查环境、执行ID、范围和成功证据，确认后推进本批需求到`发布完成`并停留，等待验收。只说“成功”但没有生产证据时不改状态。
+
+### 发布失败
+
+运维输入：
+
+```text
+发布失败：执行ID=PIPE-789；原因=镜像拉取失败
+```
+
+Codex执行：核查失败证据，记录原因并进入项目真实`发布失败`状态；项目尚无该状态时记录阻塞并给出人工处置，不创建近义重复状态。
+
+### 验收通过
+
+产品或业务输入：
+
+```text
+验收通过：ONEOSP-123；验收人=王经理；证据=https://...
+```
+
+Codex执行：核查生产发布完成和验收证据后，把需求改为`已关闭`。发布成功不能代替本句验收。
+
+### 验收不通过
+
+产品或业务输入：
+
+```text
+验收不通过：ONEOSP-123；问题=导出字段缺失
+```
+
+Codex执行：创建或关联可追踪问题，判断应回到开发、测试还是重新发布，先给出处理建议；不关闭需求，不覆盖原发布记录。
+
+## 7. 随时可用的查询口令
+
+```text
+查状态：ONEOSP-123
+下一步：ONEOSP-123
+为什么没流转：ONEOSP-123
+查重复任务：ONEOSP-123
+查关联代码：ONEOSP-123
+查测试闭环：ONEOSP-123
+给我回滚方案：刚才那条规则
+```
+
+这些口令默认只查询或出方案，不修改云效。
+
+## 8. Codex的简短回报格式
+
+处理成功：
+
+```text
+已处理：ONEOSP-123
+状态：已确认 → 分析中
+任务：已创建并关联分析任务 TASK-456
+下一步：分析人员输入“分析完成：ONEOSP-123；说明=链接”
+```
+
+条件不足：
+
+```text
+暂未处理：ONEOSP-123
+缺少：开发负责人
+请补充：安排开发：ONEOSP-123；只改后端=负责人/仓库
+```
+
+自动化未触发：
+
+```text
+未触发：ONEOSP-123 仍为待开发
+原因：分支只写了需求编号，没有在云效正式关联开发任务
+下一步：我可以补正式关联，然后再核查一次
+```
+
+## 9. Codex执行口令的规则
+
+1. `记录、确认、开始、完成、提交、修复、复测、准备发布、发布、验收`属于当前项目和明确工作项的执行授权。
+2. `查、看看、为什么、下一步、给方案`只允许读取或规划。
+3. 写操作前必须确认当前项目；项目不清楚只问项目名。
+4. 其他必要字段缺失时只追问最少信息，不发送长表单。
+5. 先查重、再创建；任务幂等键使用项目ID、需求ID和阶段类型。
+6. 项目使用`stage_tasks`还是`oneos_delivery`由Codex识别，同事不需要记规则编号。
+7. 当前平台或桥接不支持的动作要明确说“需要人工一步”，不能伪装成已自动化。
+8. 自动规则执行后等待5–30秒，再回看状态、正式关联和执行日志。
+9. 不用手工改最终状态冒充自动化通过。
+10. 不修改生产流水线定义，不删除规则、分支、MR、任务或测试资产，除非用户单独明确授权。