@sokeai/cli 1.0.65 → 1.0.66

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@sokeai/cli",
-    "version": "1.0.65",
+    "version": "1.0.66",
     "description": "授客AI官方CLI工具 - 支持AI Agent Skills",
     "bin": {
         "soke-cli": "scripts/run.js"

package/skills/soke-ai-training/SKILL.md

@@ -87,7 +87,7 @@ soke-cli ai-training +get-plan --scenario-id scenario_micro_loan_sales --format
 
 ## 场景读取与更新
 
-场景配置更新必须先读取当前场景，再基于 `updated_at` 构造 `base_updated_at`。不要调用管理端完整 `PUT /api/v1/scenarios/{scenario_id}`。
+场景配置更新必须先读取当前场景，再基于 `updated_at` 构造 `base_updated_at`。只修改描述、角色、评分或流程时，使用 `+preview-scenario-update` 和 `+apply-scenario-update`；发布场景时才使用 `+publish-scenario`。
 
 ### 创建场景
 
@@ -128,6 +128,12 @@ soke-cli ai-training +create-scenario \
 ### 读取和资源选择
 
 ```bash
+soke-cli ai-training +list-scenarios \
+  --page 1 \
+  --page-size 20 \
+  --keyword "销售" \
+  --pretty
+
 soke-cli ai-training +get-scenario \
   --scenario-id scenario_micro_loan_sales \
   --pretty \
@@ -144,6 +150,8 @@ soke-cli ai-training +list-role-voices \
   --pretty
 ```
 
+`+list-scenarios` 默认输出 MentorAI `BaseResponse.data`，用于发现可操作场景 ID。列表 query 不要伪造 `corp_id`、`company_id`、`user_id` 或 `implementation_corp_id`；可见范围由开放平台 token、用户登录态和 MentorAI 权限决定。拿到场景 ID 后，优先执行 `+get-scenario` 保存完整基准 JSON。
+
 头像更新写入 `ai_roles[].role_data.avatar` 时使用头像资源的 `url`，不是资源 `id`。声音更新写入 `ai_roles[].role_data.voice_id` 时使用声音资源的 `id`，不是 `sample_url`。
 
 ### 预览和应用
@@ -198,6 +206,18 @@ soke-cli ai-training +preview-scenario-update \
 
 `+apply-scenario-update` 必须有 `idempotency_key`，可放在 `--request-file` 中，或用 `--idempotency-key` 覆盖补充。遇到 409 乐观锁冲突时，重新执行 `+get-scenario` 获取最新 `updated_at` 后再生成更新请求。
 
+### 发布场景
+
+发布场景使用独立命令：
+
+```bash
+soke-cli ai-training +publish-scenario \
+  --scenario-id scenario_micro_loan_sales \
+  --pretty
+```
+
+MentorAI `POST /api/v1/scenarios/{scenario_id}/publish` 使用路径中的 `scenario_id`，并在 body 中发送 `version` 和 `version_description`。CLI 默认 `--version 1`、`--version-description "CLI发布"`，不再提供 `--request-file`。不要用 `+publish-scenario` 做任意局部更新；如果只是修改描述、角色字段、评分项或对话步骤，继续走 preview/apply。发布接口返回 409/422 时，加 `--raw` 保留 `errorCode/errorMessage/details/traceId`。
+
 ### 快照
 
 ```bash
@@ -226,3 +246,4 @@ soke-cli ai-training +restore-scenario-snapshot \
 - 场景更新请求体或 query 中不要伪造 `corp_id`、`company_id`、`user_id`。
 - 场景创建请求体中的 `corp_id`、`company_id`、`user_id`、`implementation_corp_id` 会由代理剥离，不要依赖它们选择租户。
 - 场景更新前必须以 `+get-scenario` 的 `updated_at` 作为 `base_updated_at`。
+- 场景发布需要 `+publish-scenario --scenario-id <id>`，默认带 `version=1` 和 `version_description=CLI发布`；不要把它当作局部更新命令。