@sokeai/cli 1.0.76 → 1.0.78

package/skills/mono/references/modules/soke-supervisor/MODULE.md

@@ -0,0 +1,186 @@
+---
+name: soke-supervisor
+summary: 授客 AI 督导模块：督导场景创建、评分标准配置、指派、发布、详情查询和关闭
+version: 1.0.0
+description: "授客 AI 督导模块：通过 soke-cli supervisor 对接督导场景接口，覆盖场景列表、创建草稿、选择评分标准、更新配置、部门/成员查询、创建指派、发布、详情、关闭前检查和关闭。当用户需要创建或维护 AI 督导场景、配置督导评分标准、给用户或部门指派督导任务、发布或关闭督导场景时使用。"
+metadata:
+  requires:
+    bins: ["soke-cli"]
+  cliHelp: "soke-cli supervisor --help"
+---
+
+# AI 督导模块 (supervisor)
+
+**CRITICAL — 开始前 MUST 先读取 [`../soke-shared/MODULE.md`](../soke-shared/MODULE.md)，其中包含认证、配置、权限处理。**
+
+## 核心概念
+
+- **Supervisor Scenario（督导场景）**：AI 督导配置主体，通过 `scenario_id` 标识。
+- **Scoring Criteria（评分标准）**：督导评分模板或自定义评分维度。选择模板后，取 `data.list[].id` 作为 `template_id`，并复用其 `dimensions[]` 组装更新请求。
+- **Assignment（指派）**：将督导场景分配给用户或部门，`type=user` 时目标是 `user_id`，`type=department` 时目标是部门 `id`。
+- **Resource Check（关闭前检查）**：关闭前必须先检查 `resource_type=ai_supervisor`、`resource_id=scenario_id`，仅当 `data.can_operate=true` 才允许关闭。
+
+## 命令总览
+
+| 命令 | 说明 |
+|---|---|
+| `soke-cli supervisor +list-scenarios` | 查询督导场景列表 |
+| `soke-cli supervisor +create-scenario` | 创建督导场景草稿 |
+| `soke-cli supervisor +list-scoring-criteria` | 查询评分标准模板 |
+| `soke-cli supervisor +update-scenario` | 更新场景信息并设置评分标准 |
+| `soke-cli supervisor +list-assigns` | 查询场景已有指派 |
+| `soke-cli supervisor +list-department-children` | 查询可指派部门 |
+| `soke-cli supervisor +list-department-members` | 查询部门成员 |
+| `soke-cli supervisor +assign-scenario` | 创建用户/部门指派 |
+| `soke-cli supervisor +publish-scenario` | 发布督导场景 |
+| `soke-cli supervisor +get-scenario` | 查询督导场景详情 |
+| `soke-cli supervisor +check-resource` | 关闭前检查 |
+| `soke-cli supervisor +close-scenario` | 关闭督导场景 |
+
+默认输出格式化后的 `data` JSON；需要关闭缩进时使用 `--pretty=false`，排障时加 `--raw` 查看完整 `{code,status,message,data,request_id}`。
+
+## 推荐创建流程
+
+1. 创建草稿：
+
+```bash
+soke-cli supervisor +create-scenario \
+  --name "电话服务质检督导" \
+  --description "用于检查客服录音中的关键服务动作" \
+  --key-points "开场确认身份；倾听客户诉求；给出清晰处理方案；合规结束" \
+  --pretty
+```
+
+记录返回的 `data.id` 作为 `scenario_id`。
+
+2. 查询评分标准：
+
+```bash
+soke-cli supervisor +list-scoring-criteria --page 1 --page-size 10 --pretty
+```
+
+选择模板时，保存 `data.list[].id` 和该模板的 `dimensions[]`。
+
+3. 更新场景和评分配置：
+
+```bash
+soke-cli supervisor +update-scenario \
+  --scenario-id "<scenario_id>" \
+  --name "电话服务质检督导" \
+  --description "用于检查客服录音中的关键服务动作" \
+  --key-points "开场确认身份；倾听客户诉求；给出清晰处理方案；合规结束" \
+  --status 0 \
+  --template-id "<template_id>" \
+  --template-name "金融贷款评分标准" \
+  --template-version "1.0" \
+  --criteria-name "电话服务质检评分标准" \
+  --criteria-description "电话服务质检评分标准" \
+  --criteria-dimension-name "合规表达" \
+  --criteria-dimension-description "表达是否合规" \
+  --criteria-dimension-weight 100 \
+  --criteria-dimension-rule "符合则得分" \
+  --criteria-dimension-sort-order 1 \
+  --pretty
+```
+
+4. 指派前查重：
+
+```bash
+soke-cli supervisor +list-assigns \
+  --scenario-id "<scenario_id>" \
+  --page 1 \
+  --page-size 50 \
+  --pretty
+```
+
+检查 `target_id`、`assign_type`、`status`，避免重复指派。
+
+5. 查询部门和成员：
+
+```bash
+soke-cli supervisor +list-department-children --corp-id "<corp_id>" --pretty
+
+soke-cli supervisor +list-department-members \
+  --department-id "<department_id>" \
+  --corp-id "<corp_id>" \
+  --page 1 \
+  --page-size 50 \
+  --pretty
+```
+
+6. 创建指派：
+
+```bash
+# 指派用户
+soke-cli supervisor +assign-scenario \
+  --scenario-id "<scenario_id>" \
+  --type user \
+  --target-ids "user_id_1,user_id_2" \
+  --pretty
+
+# 指派部门
+soke-cli supervisor +assign-scenario \
+  --scenario-id "<scenario_id>" \
+  --type department \
+  --target-ids "department_id_1" \
+  --pretty
+```
+
+7. 发布并验收：
+
+```bash
+soke-cli supervisor +publish-scenario --scenario-id "<scenario_id>" --pretty
+
+soke-cli supervisor +get-scenario --scenario-id "<scenario_id>" --pretty
+```
+
+发布后检查 `status`、`status_text`、`scoring_criteria_config`。
+
+## 关闭流程
+
+关闭前必须先检查：
+
+```bash
+soke-cli supervisor +check-resource --scenario-id "<scenario_id>" --pretty
+```
+
+只有当 `data.can_operate=true` 时才执行：
+
+```bash
+soke-cli supervisor +close-scenario --scenario-id "<scenario_id>" --pretty
+```
+
+如果 `can_operate=false`，根据 `block_message` 和 `bind_maps` 处理阻塞关系，不要强行关闭。
+
+## JSON 请求文件
+
+### 创建草稿
+
+```json
+{
+  "name": "电话服务质检督导",
+  "description": "用于检查客服录音中的关键服务动作",
+  "key_points": "开场确认身份；倾听客户诉求；给出清晰处理方案；合规结束",
+  "status": 0
+}
+```
+
+### 创建指派
+
+```json
+{
+  "scenario_id": "<scenario_id>",
+  "assignments": [
+    {
+      "type": "user",
+      "target_ids": ["<user_id>"]
+    }
+  ]
+}
+```
+
+## 排错
+
+- 查部门成员时无数据：确认 `--corp-id` 与部门所属企业一致，并使用 `+list-department-children` 返回的部门 `id`。
+- 发布后详情无评分配置：重新检查 `+update-scenario` 的 `scoring_criteria_config.criteria_data.dimensions` 是否为空。
+- 关闭被阻塞：先查看 `+check-resource --raw --pretty` 中的 `block_message` 和 `bind_maps`。

package/skills/mono/references/modules/soke-task/MODULE.md

@@ -0,0 +1,146 @@
+---
+name: soke-task
+summary: 授客学堂异步任务管理（创建统计任务/查询任务状态/获取报表文件），支持学习地图和课程学员统计的报表导出与统计生成，通过 soke-cli 操作
+version: 1.1.0
+description: "授客学堂异步任务管理：通过 soke-cli task 创建统计任务、查询任务状态、获取导出文件。支持学习地图学员统计和课程学员统计的报表导出与统计生成。当用户需要生成学习地图或课程学员统计报表、生成统计、查询任务状态或获取文件下载地址时使用。"
+metadata:
+  requires:
+    bins: ["soke-cli"]
+  cliHelp: "soke-cli task --help"
+---
+
+# 异步任务管理 (soke-task)
+
+**CRITICAL — 开始前 MUST 先读取 [`../soke-shared/MODULE.md`](../soke-shared/MODULE.md)，其中包含认证、配置和权限处理。**
+
+## 核心规则
+
+- 任务接口是独立模块，命令统一使用 `soke-cli task ...`，不要使用 `soke-cli learning-map ...` 创建或查询任务。
+- 创建任务后必须保存返回的 `data.id`，再调用 `+get` 查询任务详情。
+- 默认用 `--format json` 获取结构化输出；需要人工快速查看时可省略 format 输出表格。
+- 当前已知任务类型是学习地图学员统计和课程学员统计；`--module` 默认 `learningMapUser`，课程学员统计使用 `--module courseUser`。
+- `--target-id` 是统一目标 ID：`--module learningMapUser` 时会提交为 `学习地图id`，`--module courseUser` 时会提交为 `课程id`。
+- `--departments` 和 `--users` 可传英文逗号分隔 ID 或 JSON 数组；CLI 会转换为接口需要的对象数组。
+- `--action` 默认 `export`，`--type` 默认 `aloneDept`。
+- 查询 `soke-cli task +get --id "TASK-ID"` 后，必须根据创建任务时传入的 `--action` 判断状态字段：`action=export` 看 `data.export_status`，`action=report` 看 `data.status`。
+
+## 命令
+
+### 创建学习地图学员统计任务
+
+```bash
+soke-cli task +create \
+  --target-id "MAP-UUID" \
+  --learn-type "required" \
+  --type "aloneDept" \
+  --departments "130110584" \
+  --users "1302105847786" \
+  --custom-tags "job_number,position" \
+  --limit 4500 \
+  --format json
+```
+
+### 创建课程学员统计任务
+
+```bash
+soke-cli task +create \
+  --target-id "COURSE-UUID" \
+  --module courseUser \
+  --learn-type "required" \
+  --type "aloneDept" \
+  --departments '[130110584]' \
+  --users '[1302105847786]' \
+  --limit 4500 \
+  --format json
+```
+
+完整参数：
+
+| 参数 | 必填 | 默认值 | 说明 |
+|------|------|--------|------|
+| `--target-id` | 是 | - | 目标 UUID；`learningMapUser` 时作为 `map_id`，`courseUser` 时作为 `course_id` |
+| `--module` | 否 | `learningMapUser` | 任务模块：`learningMapUser` 学习地图学员统计，`courseUser` 课程学员统计 |
+| `--learn-type` | 否 | `required` | 学习类型，如 `required` |
+| `--learn-status` | 否 | 空 | 学习状态筛选：空值表示不限，`learning` 未完成，`finished` 已完成 |
+| `--eligible-status` | 否 | 空 | 达标状态筛选，空值表示不限 |
+| `--limit` | 否 | `4500` | 任务处理上限 |
+| `--action` | 否 | `export` | 操作类型：`export` 生成报表，`report` 生成统计 |
+| `--type` | 否 | `aloneDept` | 部门导出类型：`aloneDept` 单列导出，`manyDept` 部门多列导出 |
+| `--is-leave` | 否 | `0` | 是否离职：`0` 否，`1` 是 |
+| `--taskId` | 否 | 空字符串 | 任务 ID，默认空字符串 |
+| `--departments` | 否 | 空 | 部门 ID 列表，多个 ID 用英文逗号分隔；也可传 JSON 数组 |
+| `--users` | 否 | 空 | 用户 ID 列表，多个 ID 用英文逗号分隔；也可传 JSON 数组 |
+| `--custom-tags` | 否 | 空 | 导出的自定义字段列表，多个字段用英文逗号分隔；也可传 JSON 字符串数组 |
+
+响应关键字段：
+
+| 字段 | 说明 |
+|------|------|
+| `data.id` | 任务 ID，查询任务详情时传给 `+get --id` |
+| `data.key` | 任务去重或配置缓存 Key |
+| `data.config_result` | 上游配置模块检查结果 |
+
+默认输出会打印单行任务 ID，例如 `id:13288419`。需要完整字段时使用 `--format json`。
+
+### 查询异步任务
+
+```bash
+soke-cli task +get --id "TASK-ID" --format json
+```
+
+状态判断规则：
+
+| 创建任务时的 `--action` | 查询完成状态字段 | 说明 |
+|-------------------------|------------------|------|
+| `export` | `data.export_status` | 生成报表时用导出状态判断是否生成文件 |
+| `report` | `data.status` | 生成统计时用任务执行状态判断是否完成 |
+
+响应关键字段：
+
+| 字段 | 说明 |
+|------|------|
+| `data.status` | 任务执行状态；`action=report` 生成统计时用此字段判断任务状态，接口示例中 `2` 表示执行完成 |
+| `data.export_status` | 导出状态；`action=export` 生成报表时用此字段判断导出状态，接口示例中 `2` 表示已生成导出文件 |
+| `data.filePath` | 导出文件访问地址，未生成时为空 |
+| `data.filename` | 导出文件名 |
+| `data.filesize` | 导出文件大小 |
+| `data.params` | 创建任务参数的 JSON 字符串 |
+
+## 推荐工作流
+
+```bash
+TASK_ID=$(soke-cli task +create \
+  --target-id "$MAP_UUID" \
+  --learn-type "required" \
+  --type "aloneDept" \
+  --custom-tags "工号,岗位,入职日期" \
+  --limit 4500 \
+  --format json | jq -r '.data.id')
+
+soke-cli task +get --id "$TASK_ID" --format json | jq -r '.data.filePath'
+```
+
+按创建任务的 action 查询状态：
+
+```bash
+# action=export
+soke-cli task +get --id "$TASK_ID" --format json | jq -r '.data.export_status'
+
+# action=report
+soke-cli task +get --id "$TASK_ID" --format json | jq -r '.data.status'
+```
+
+## API 接口映射
+
+| CLI 命令 | API 路径 | 方法 |
+|----------|----------|------|
+| `task +create` | `/skills/job/task` | POST (form) |
+| `task +get` | `/skills/job/task/{id}` | GET |
+
+## 排错
+
+- `data.filePath` 为空：任务可能还未完成，等待后重新执行 `task +get --id "TASK-ID" --format json`。
+- `未登录授权`：按 `soke-shared` 执行 `soke-cli auth login` 后重试。
+- 自定义字段没有导出：确认已通过 `--custom-tags "字段1,字段2"` 指定，字段名需与当前任务类型支持的自定义字段一致。
+- 任务创建失败：确认 `--target-id` 与 `--module` 匹配；学习地图用 `--module learningMapUser`，课程用 `--module courseUser`。
+- 部门或用户筛选无效：先用 `soke-cli assign +list-departments` / `soke-cli assign +list-users` 确认可用 ID，再传给 `--departments` / `--users`。

package/skills/mono/references/modules/soke-training-demand/MODULE.md

@@ -0,0 +1,221 @@
+---
+name: soke-training-demand
+summary: 授客学堂培训需求收集（提交需求/浏览列表/投票），提交时分步引导选择分类、标签、描述、紧急程度，通过 soke-cli 操作
+version: 2.5.0
+description: "授客学堂培训需求收集：通过 soke-cli training-demand 浏览需求列表、获取需求分类、分步引导提交培训需求（分类、标签、描述、紧急程度）以及为需求投票。当用户需要提交培训需求、浏览需求列表、给需求投票或查看需求分类时使用。"
+metadata:
+  requires:
+    bins: ["soke-cli"]
+  executionGuard:
+    - "提交培训需求时，MUST 严格按 4 步依次执行（1->2->3->4），每完成一步 MUST 等待用户回复后才能进入下一步。NEVER 跳步、NEVER 合并多步为一步、NEVER 在用户未回复时自行推进。"
+    - "步骤 2（选择标签）是独立步骤，NEVER 被跳过（除非分类 tag 为空/null）。即使用户在步骤 1 选择了分类，也 MUST 先展示标签列表让用户选择或跳过，然后才能进入步骤 3。"
+    - "每一步输出后 MUST STOP 等待用户输入。NEVER 在同一个回复中同时展示两个步骤的提示。"
+    - "NEVER 自行发挥、NEVER 添加 skill 未定义的步骤或提示文字。所有输出格式和提示语必须严格按本 skill 中常见工作流的定义，一字不差。"
+    - "步骤 2 展示标签时，MUST 严格使用步骤 1 中用户选定的那个分类对象（通过用户选择的序号从 +list-categories 返回的 data.list 数组中精确取出）的 tag 字段。NEVER 使用其他分类的 tag、NEVER 凭记忆猜测标签、NEVER 用列表中其他位置分类的 tag。"
+  cliHelp: "soke-cli training-demand --help"
+---
+
+# 培训需求收集
+
+**CRITICAL — 开始前 MUST 先读取 ../soke-shared/MODULE.md，其中包含认证、配置和权限处理。**
+
+## 🛑 执行守卫（EXECUTION GUARD）
+
+> **以下规则是硬性约束，违反任何一条即为执行错误：**
+>
+> 1. **逐步执行**：提交需求 MUST 严格按 4 步顺序（1->2->3->4）逐步引导，每步 MUST 等待用户回复后再进入下一步。NEVER 跳步、NEVER 合步。
+> 2. **步骤独立**：每个步骤 MUST 单独输出为一个回复。NEVER 在同一个回复中同时展示两个步骤的提示。步骤 1 输出后 STOP 等用户选分类；步骤 2 输出后 STOP 等用户选标签；步骤 3 输出后 STOP 等用户输入描述；步骤 4 输出后 STOP 等用户选紧急程度。
+> 3. **步骤 2 不可省略**：步骤 2（选择标签）是独立步骤，NEVER 被省略（除非分类 tag 为空/null）。NEVER 在步骤 1 的回复中同时展示标签选项。
+> 4. **严禁自行发挥**：所有提示语、输出格式 MUST 严格照搬本 skill 常见工作流中的定义，NEVER 自行发挥、NEVER 添加额外文字或解释、NEVER 改变提示格式。
+>
+> 5. **标签-分类严格绑定**：步骤 2 展示标签时，MUST 严格使用步骤 1 中用户选定的分类对象（通过序号从 +list-categories 的 data.list 中精确取出）的 tag 字段。NEVER 用其他分类的 tag、NEVER 凭记忆猜测、NEVER 用列表中其他位置分类的 tag。不确定时 MUST 重新调用 +list-categories 按序号精确匹配。
+
+## 核心规则
+
+- 分类、标签必须与管理后台设置完全一致，**禁止自行拓展或创造分类/标签**。标签来源仅限用户所选分类的 tag 字段。
+- 提交培训需求必须严格按以下 **4 步顺序** 引导用户，不可跳步或合并：
+  1. **选择分类**（单选） → 2. **选择标签**（选填，可多选≤5，可跳过，无标签时自动跳过） → 3. **填写培训需求**（≤200字，必填） → 4. **紧急程度**（1-5，选填）
+- 分类：从 +list-categories 返回的 data.list[].title 中选择，**仅限单选**，不可同时选多个分类。
+- 标签：从所选分类的 data.list[].tag 字段中按逗号拆分，编号列出供用户选择。**标签为选填，用户可以选择标签也可以不选直接跳过**。可多选最多5个。若该分类 tag 为空或不存在，提示"📌 该分类暂无标签"，自动跳过标签步骤进入步骤3。
+- 培训需求描述：即 --title，**必填，最多 200 字符**，纯文本输入。
+- 紧急程度：即 --level，1=普通、2=较普通、3=一般、4=较紧急、5=最紧急，**选填**，不选时默认 0（不设置等级）。
+- 投票前，先执行 +list，使用返回的培训需求 uuid。不要把分类 uuid 传给投票接口。
+- 创建和投票是写操作。用户意图不明确时，先确认要提交或投票的对象。
+- 默认用 --format json 获取结构化输出。
+
+### 提交成功后的展示规则
+- **不显示需求 UUID**：提交成功后向用户展示的详情表格中，不要包含 uuid 字段。UUID 仅用于内部投票等操作，不向用户暴露。
+- **时间加8小时**：API 返回的 create_time 是 UTC 时间，向用户展示时必须加 8 小时转换为 UTC+8（北京时间）。例如返回 "2026-07-23 01:56:31" 应展示为 "2026-07-23 09:56:31"。
+
+### 标签处理规则
+
+- **隐藏接口字段**：所选分类的 tag 字段原始值是接口内部数据，**严禁在对话中向用户展示**（如不得出现"所选分类的 tag 字段为：公司介绍,规章制度"之类的话）。步骤 2 只展示编号后的标签选项列表，不暴露原始 tag 字段值或任何接口字段名。
+
++list-categories 返回的每个分类对象中 tag 字段是一个逗号分隔的字符串，例如 "企业文化培训,企业发展历程培训,营销战略发展规则培训"。提交需求时：
+- **标签来源仅限当前分类**：从用户所选的那个分类的 tag 字段按逗号拆分出所有可选标签，编号列出供用户选择。**严禁跨分类混合标签或自行创造标签**。
+- **🛑 标签-分类严格绑定（防错硬约束）**：步骤 2 展示标签时，MUST 从步骤 1 中用户选定的分类对象（即 +list-categories 返回的 data.list 中，按用户选择的序号精确匹配的那一条）的 tag 字段按逗号拆分。NEVER 使用其他分类的 tag 字段、NEVER 凭记忆猜测标签内容、NEVER 用列表中其他位置分类的 tag。如果记忆可能出错或不确定，MUST 重新执行 +list-categories 并严格按序号匹配对应分类对象后再拆分其 tag。
+- 用户选中后，将选中的标签用逗号拼接传给 --tag。
+- **标签选填**：标签为选填项，用户可以选择标签也可以**不选任何标签直接跳过**。跳过时不传 --tag（CLI 会从 --category-tag 自动合并）。用户输入"0"、"不选"、"跳过"等表示不选择标签，直接进入步骤 3。
+- **最多选 5 个标签**：选择超过5个时提醒"❌ 最多只能选择5个标签，请减少选择"。
+- **无标签时自动跳过**：若所选分类的 tag 为空字符串（""）或不存在/为 null，提示"📌 该分类暂无标签，无需选择"，自动跳过步骤 2 进入步骤 3。
+- --category-tag 必须传所选分类的原始完整 tag 字段值（未拆分、未修改）。
+
+## 命令
+
+### 查询培训需求列表
+
+```bash
+soke-cli training-demand +list \
+  --page 1 \
+  --limit 10 \
+  --status 1 \
+  --keyword "" \
+  --is-owner 0 \
+  --create-time-order desc \
+  --owner-vote 0 \
+  --format json
+```
+
+列表返回的 data.list[].uuid 是投票使用的培训需求 UUID。
+
+### 查询培训需求分类
+
+```bash
+soke-cli training-demand +list-categories --format json
+```
+
+分类返回的 data.list[].uuid、data.list[].title 和 data.list[].tag 只用于创建需求。
+
+### 提交培训需求
+
+单分类提交时使用 --category-uuid：
+
+```bash
+soke-cli training-demand +create \
+  --title "门店销售沟通训练" \
+  --tag "职场心态,需求测试" \
+  --level 0 \
+  --category-uuid "FA0C937C-EE52-463B-BE3A-C13F96C426AE" \
+  --format json
+```
+
+- --title：培训需求描述，**必填，最多 200 字符**。
+- --tag：从所选分类 tag 中用户选中的标签，逗号拼接；不传时 CLI 从 --category-tag 自动合并。
+- --level：紧急程度，1=普通、5=最紧急，**选填**，默认 0。
+- --category-uuid：所选分类的 uuid。
+- 分类为单选，不使用 --category-list。
+
+### 给培训需求投票
+
+```bash
+soke-cli training-demand +vote \
+  --uuid "41EA8B23-5E5E-48FD-99A3-FF8F420752A6" \
+  --format json
+```
+
+--uuid 必须来自 +list 返回的需求 UUID。
+
+## 常见工作流
+
+### 提交培训需求（严格 4 步流程）
+
+用户说"我想提一个培训需求"或类似意图时，**必须**按以下 4 步依次引导，不可跳步：
+
+**步骤 1 — 选择分类（单选）**
+**🛑 本步骤 MUST 单独输出，NEVER 与步骤 2 合并在同一回复中。**
+
+1. 执行 soke-cli training-demand +list-categories --format json。
+2. 将返回的 data.list[].title 编号列出，格式严格如下（NEVER 自行发挥格式）：
+   ```
+   请选择培训需求分类（单选）：
+   1. 企业文化
+   2. 职业素养
+   3. 企业培训
+   ...
+   ```
+   让用户**单选一个分类**。
+3. 记录用户所选分类的 uuid、title 和 tag（原始完整值）。
+4. **🛑 STOP HERE** — 等待用户选择分类后，再进入步骤 2。NEVER 在同一回复中展示步骤 2 的标签列表。
+
+**步骤 2 — 选择标签（选填，可多选≤5，可跳过；无标签时自动跳过）**
+**🛑 本步骤 MUST 单独输出，NEVER 与步骤 1 合并在同一回复中。**
+
+1. **展示分类标签**：从步骤 1 记录的所选分类 tag 字段中按逗号拆分，编号列出所有可选标签。**严禁在对话中暴露 tag 字段原始值或接口字段名**，只展示编号列表供用户选择。格式示例：
+   **🛑 关键防错**：MUST 确保标签来自步骤 1 中用户选定分类对象的 tag 字段。用户选择分类序号 N 后，MUST 从 +list-categories 返回的 data.list[N-1]（序号从1开始，数组索引从0开始）取出分类对象，然后用其 tag 字段拆分展示。NEVER 凭记忆选其他分类的 tag、NEVER 用序号偏移后的分类。如不确定，必须重新调用 +list-categories 并严格按序号匹配。
+   ```
+   请选择标签（选填，可多选，最多5个，也可不选直接跳过）：
+   1. 企业文化培训
+   2. 企业发展历程培训
+   3. 营销战略发展规则培训
+   ...
+
+   请输入序号（多选用逗号分隔，如 1,3,5；不选可输入"0"或"跳过"）
+   ```
+2. **无标签判断**：若所选分类的 tag 为空字符串（""）或不存在/为 null，直接显示：
+   ```
+   📌 该分类暂无标签，无需选择
+   ```
+   然后自动跳过步骤 2，进入步骤 3。
+3. **选填，可跳过**：标签为选填项，用户可以选择标签也可以**不选任何标签直接跳过**。用户输入"0"、"不选"、"跳过"等表示不选择标签，直接进入步骤 3。
+4. **多选交互**：让用户输入序号多选标签（如"1,3,5"），最多选 5 个；选择超过 5 个时提醒"❌ 最多只能选择5个标签，请减少选择"。
+5. **确认选择**：若用户选择了标签，简要展示确认（如"✅ 已选择标签：企业文化培训, 营销战略发展规则培训"），提交时用逗号拼接为 --tag 参数值。若用户跳过，显示"⏭ 未选择标签，继续下一步"。
+6. **⚠️ 重要**：标签来源仅限当前所选分类的 tag 字段，严禁跨分类混合标签或自行创造标签。
+7. **🛑 STOP HERE** — 等待用户选择/跳过标签后，再进入步骤 3。NEVER 在同一回复中同时展示步骤 3 的提示。
+
+**步骤 3 — 填写培训需求描述（必填，≤200字符）**
+**🛑 本步骤 MUST 单独输出，NEVER 与步骤 2 合并在同一回复中。**
+
+1. 提示用户输入培训需求描述（纯文本），提示语严格如下（NEVER 自行发挥）：
+   ```
+   请输入培训需求描述（必填，最多200字符）：
+   ```
+2. 记录输入内容，即 --title 参数值。
+3. 若用户输入超过 200 字符，提醒"❌ 需求描述最多200字符，请缩短或重新填写"。
+4. **🛑 STOP HERE** — 等待用户输入需求描述后，再进入步骤 4。NEVER 在同一回复中同时展示步骤 4 的提示。
+
+**步骤 4 — 紃急程度（选填）**
+**🛑 本步骤 MUST 单独输出，NEVER 与步骤 3 合并在同一回复中。**
+
+1. 提示用户选择紧急程度，提示语严格如下（NEVER 自行发挥）：
+   ```
+   请选择紧急程度（选填，不选默认为0）：
+   1 = 普通
+   2 = 较普通
+   3 = 一般
+   4 = 较紧急
+   5 = 最紧急
+
+   输入数字或输入"0"/"跳过"表示不设置
+   ```
+2. 不选则默认 0（不设置等级）。用户输入"0"或"跳过"表示不设置。
+3. 记录选择值，即 --level 参数值。
+
+**最终提交**
+用步骤 1-4 收集的数据执行 +create。提交前可向用户展示汇总确认。
+
+### 投票需求
+
+用户说"帮我给某个需求投票"：
+- 执行 +list --keyword "<关键词>" --format json。
+- 用需求标题和创建人等信息确认目标。
+- 执行 +vote --uuid "<需求uuid>"。
+
+### 浏览需求
+
+用户只想浏览需求：
+- 执行 +list --page 1 --limit 10 --create-time-order desc。
+- 返回标题、分类、标签、票数、是否已投票和需求 UUID。
+
+## 字段依赖
+
+| 场景 | 依赖字段 | 来源 |
+|------|----------|------|
+| 创建需求 | --category-uuid / --tag / --title / --level | +list-categories 的 data.list[] + 用户输入 |
+| 投票 | uuid | +list 的 data.list[].uuid |
+
+## 排错
+
+- 创建失败提示分类无效：重新执行 +list-categories，不要自行手写分类 UUID。
+- 创建失败提示标签无效：重新执行 +list-categories，从所选分类返回的 tag 中选择，不要自行编写标签。**确保 --category-tag 传的是原始完整 tag 字段值**。
+- 投票失败提示需求无效：确认传入的是培训需求 UUID，不是分类 UUID。
+- 鉴权失败：按 soke-shared 执行 soke-cli auth login 后重试。