3.5 KiB
3.5 KiB
记录需求 · 元字段（优先级 / 标签 / 提交部门 / 提交人）
建单前消费网页 / AutoRDO / 口令中的四类元信息。细则与 assets/runtime-ids.json 对齐；禁止臆造未验证的 fieldIdentifier。
口令形态
记录需求：…；优先级=紧急|高|中|低；标签=…；提交部门=…；提交人=…；推进至=…
四字段均可选出现；网页或 AutoRDO 提示里已带的值与口令等价。
Plan 是否追问
记录需求 一律走 compact-select.md 字母表（类型/项目/优先级/标签），即使用户口令已写齐；给出建议压缩串，等用户回 1a2b3a4d（或改字母）并「执行」。
| 条件 | 行为 |
|---|---|
| 口令已含类型/项目/优先级/标签 | 对应选项标 ★ + 建议压缩串；仍须压缩确认或显式点选 |
| 标签名 0 命中 / 多命中 | 自动重拉一次标签候选并重生 4.A/B/C…；仍失败则停 |
| 仅缺提交部门/提交人 | 压缩 1–4 确认后，缺则追问或写入描述页脚 |
| 仅缺「推进至」等 | 按既有口令规则；可作 5. 题字母表 |
写入策略
优先级（已验证）
- 映射：
runtime-ids.json→priority（紧急 / 高 / 中 / 低）。 - create 时写入
fieldIdentifier: "priority"（与 live-api.md /live_create_fast.py一致）。 - 未给优先级时：Plan 追问；脚本默认「中」仅作既有兜底，口令/网页有值时以用户值为准。
标签（已验证）
- 映射：
runtime-ids.json→tags（按显示名取 tagId）。 - 标签须 PATCH
propertyKey: "tag"（create 带 tag 不落库）。 - 口令/网页给出的标签名若不在候选：按 compact-select.md 自动重拉一次标签列表并重生选项；仍无则停在 Plan，勿猜 ID。
提交部门 / 提交人（已验证 · 2026-07-27 · ONEOS-293）
| 字段 | fieldIdentifier |
|---|---|
| 提交部门 | 3132597a9718d1c282b7ba5a0c |
| 提交人 | 9e01269e96f91fbb97d36bf5b3 |
| 规则 | 说明 |
|---|---|
| 写入 | POST /projex/api/workitem/workitem/field/value/{workitemId}，Content-Type: application/x-www-form-urlencoded，参数 fieldValueList = JSON 数组字符串 [{"fieldIdentifier","value"}] |
| 形态 | 均为普通文本 input（非人员选择器）；口令值原样写入 |
| 页脚 | 仍可在描述页脚重复一份，便于检索；不能替代字段写入 |
| 计划开始 | 字段 79，同一 field/value API；推荐 YYYY-MM-DD 12:00:00。快轨：【交付】/【设计】创建当日写入；【设计】另写计划完成 80=当日 23:59:59 |
| 预计工时 | 字段 101586 禁止直接 PATCH；用 POST …/time/estimate（spentTime）登记；删多余用 DELETE …/time/estimate/{workitemId}/{estimateId} |
| 实际工时 | POST …/workitem/time，body actualTime（非 spentTime）+ gmtStart/gmtEnd（epoch ms 字符串）；快轨待开发需求默认 2 |
| 描述更新 | PATCH …/workitem/{id}/document，{"content","formatType":"RICHTEXT"} |
| 快轨标签 | 【交付】【设计】建单后 PATCH propertyKey=tag，propertyValue 与需求 tagId 一致（多标签逗号拼接） |
与描述双段的关系
页脚元信息写在「原始诉求」段末或整篇描述末尾均可，不得覆盖 ## 产品说明（AutoPRD） / ## 工作项编号（系统） 区块（见 description-split.md）。