@sokeai/cli 1.0.78 → 1.0.80

package/skills/mono/references/modules/soke-ai-coach-director/platform/adapters/qclaw.md

@@ -1,6 +1,8 @@
 # QClaw 平台适配器
 
 > QClaw 是腾讯电脑管家的桌面 AI 助手，基于 OpenClaw 框架，通过 ClawHub 技能生态和微信远程操控进行交互。
+>
+> **生命周期：可选兼容层。** 仅当交付目标明确包含 QClaw/OpenClaw/ClawHub 时加载；默认 WorkBuddy 运行不依赖本文件。若产品不再支持 QClaw，可删除本文件并同步更新适配器索引、路由说明和变更日志，不得删除通用降级规则。
 
 ## 运行环境检测
 
@@ -44,7 +46,7 @@ QClaw 基于 OpenClaw 框架，可以执行系统命令。soke-cli 为 npm 全
 
 ```bash
 # QClaw 中执行 soke-cli 命令
-soke-cli ai-training +create-scenario --request-file ./step1-create.json --pretty
+soke-cli ai-training +create-scenario --request-file ./step1-create.json > /tmp/step1-create.json 2>/dev/null
 ```
 
 若 soke-cli 在 QClaw 环境中不可用，降级为 REST API 直接调用（参考 `../api-fallback.md`）。

package/skills/mono/references/modules/soke-ai-coach-director/platform/adapters/{wukong.md → qwen.md}

@@ -1,10 +1,10 @@
-# 悟空 (Wukong) 平台适配器
+# 千问 (Qwen) 平台适配器
 
-> 悟空是阿里钉钉的企业级 AI Agent 平台，通过钉钉 IM 进行自然语言对话交互。不支持 `AskUserQuestion` 或 `render_ui`。
+> 千问是阿里钉钉的企业级 AI Agent 平台，通过钉钉 IM 进行自然语言对话交互。不支持 `AskUserQuestion` 或 `render_ui`。
 
 ## 运行环境检测
 
-- 对话上下文包含钉钉/悟空平台特征
+- 对话上下文包含钉钉/千问平台特征
 - 无 `AskUserQuestion` 工具可用
 - 交互方式为自然语言对话
 
@@ -14,11 +14,11 @@
 
 在对话中以 Markdown 纯文本完整展示 Part 内容。使用 `## 🔨 PartN：{标题}` 格式开头，逐字段输出全部正文。
 
-悟空平台支持 Markdown 渲染（标题、列表、加粗），按标准 Markdown 输出即可。
+千问平台支持 Markdown 渲染（标题、列表、加粗），按标准 Markdown 输出即可。
 
 ### 选项确认
 
-使用结构化文本编号确认（悟空不支持弹窗按钮）：
+使用结构化文本编号确认（千问不支持弹窗按钮）：
 
 ```
 请选择：
@@ -38,33 +38,33 @@
 
 ### CLI 执行
 
-悟空内置 Python 3.12 + Node.js + Bun + Chromium，通过 Tauri + Rust 架构执行系统命令。
+千问内置 Python 3.12 + Node.js + Bun + Chromium，通过 Tauri + Rust 架构执行系统命令。
 
-soke-cli 在悟空中的执行方式：
-- 悟空有企业级安全沙箱（不同于 WorkBuddy 的沙箱）
+soke-cli 在千问中的执行方式：
+- 千问有企业级安全沙箱（不同于 WorkBuddy 的沙箱）
 - soke-cli 是 npm 全局安装的 Go 编译二进制，可直接调用
-- 若悟空中 `soke-cli` 命令受限，降级为 REST API 直接调用（参考 `../api-fallback.md`）
+- 若千问中 `soke-cli` 命令受限，降级为 REST API 直接调用（参考 `../api-fallback.md`）
 
 ```bash
-# 悟空中执行 soke-cli 命令（无需 dangerouslyDisableSandbox）
-soke-cli ai-training +create-scenario --request-file ./step1-create.json --pretty
+# 千问中执行 soke-cli 命令（无需 dangerouslyDisableSandbox）
+soke-cli ai-training +create-scenario --request-file ./step1-create.json > /tmp/step1-create.json 2>/dev/null
 ```
 
-### 悟空 Skill 市场打包说明
+### 千问 Skill 市场打包说明
 
-悟空有自己的 AI 能力市场（Skill 市场），使用独立的 Skill 格式。
+千问有自己的 AI 能力市场（Skill 市场），使用独立的 Skill 格式。
 
-要将本技能发布到悟空 Skill 市场：
-1. 将 SKILL.md 转换为悟空 Skill 格式（需查阅悟空 Skill 开发文档）
+要将本技能发布到千问 Skill 市场：
+1. 将 SKILL.md 转换为千问 Skill 格式（需查阅千问 Skill 开发文档）
 2. 交互逻辑使用本适配器的纯文本模式
 3. CLI 执行层保持 soke-cli 原生调用
-4. 如有 MCP 协议需求，悟空内置 MCP 支持
+4. 如有 MCP 协议需求，千问内置 MCP 支持
 
 ## 适配器路由
 
-当检测到以下特征时，启用悟空适配器：
+当检测到以下特征时，启用千问适配器：
 - 对话环境无 `AskUserQuestion` / `render_ui` 工具
 - 平台支持 Markdown 渲染
 - 可执行系统 CLI 命令
 
-> 若 soke-cli 在悟空中完全不可用（如企业安全策略禁止），整条管线降级为：纯文本展示 Part 内容 → 用户确认 → 生成 JSON → 通过 REST API (api-fallback.md) 直接调用 MentorAI API 完成同步。
+> 若 soke-cli 在千问中完全不可用（如企业安全策略禁止），整条管线降级为：纯文本展示 Part 内容 → 用户确认 → 生成 JSON → 通过 REST API (api-fallback.md) 直接调用 MentorAI API 完成同步。

package/skills/mono/references/modules/soke-ai-coach-director/platform/adapters/workbuddy.md

@@ -36,7 +36,7 @@ WebChat 环境额外支持 `render_ui` QuestionForm jsonl。
 
 ```bash
 # 示例
-soke-cli ai-training +create-scenario --request-file ./step1-create.json --pretty
+soke-cli ai-training +create-scenario --request-file ./step1-create.json > /tmp/step1-create.json 2>/dev/null
 ```
 
 ## 适配器路由

package/skills/mono/references/modules/soke-ai-coach-director/platform/api-fallback.md

@@ -51,7 +51,7 @@ Body: step1-create.json 内容
 
 ### 场景查询
 
-**CLI**: `soke-cli ai-training +get-scenario --scenario-id <id> --pretty`
+**CLI**: `soke-cli ai-training +get-scenario --scenario-id <id> --raw > /tmp/scenario_get.json 2>/dev/null`
 
 **API**:
 ```

package/skills/mono/references/modules/soke-ai-coach-director/platform/interaction.md

@@ -1,6 +1,6 @@
 # 弹窗交互规则
 
-定义 Part1-Part5 及发布/知识包/微调的确认契约（标题/问题/选项/分支路由）。跨平台：WorkBuddy 用 AskUserQuestion，WebChat 用 render_ui QuestionForm，纯文本平台降级为编号选项（见 `platform/adapters/`）。
+定义 Part1-Part5 及发布/知识包/微调的确认契约（标题/问题/选项/分支路由）。跨平台：WorkBuddy 用 AskUserQuestion，WebChat 用 render_ui QuestionForm，纯文本平台降级为编号选项（见 `platform/adapters/`）。QClaw 适配器为可选兼容层；未部署 QClaw 时不影响其他平台或通用降级路径。
 
 ## 核心规则
 

package/skills/mono/references/modules/soke-ai-coach-director/platform/platform-support-matrix.md

@@ -0,0 +1,28 @@
+# 多平台支持矩阵
+
+> 本文件是 AI 陪练平台适配器支持状态的唯一事实源。适配器只负责环境检测、内容展示、选项确认和 CLI 执行，不承载 Part1-Part5 业务规则。
+
+| 平台 | 适配器文件 | 状态 | 交互方式 | CLI 执行 | 备注 |
+|---|---|---|---|---|---|
+| WorkBuddy | `adapters/workbuddy.md` | 稳定 | AskUserQuestion / render_ui | Bash 沙箱 | 默认平台 |
+| 千问（Qwen） | `adapters/qwen.md` | 可选 | Markdown + 编号确认 | 平台 CLI / API 降级 | 原悟空适配器已迁移为千问适配器 |
+| Zework | `adapters/zework.md` | 待验证 | 纯文本 + 编号确认 | 内部 CLI / API 降级 | 私有平台适配 |
+| QClaw | `adapters/qclaw.md` | 可选 | Markdown + 编号确认 | OpenClaw Bash | 未部署时不影响主流程 |
+| 通用降级 | `adapters/README.md` | 必须保留 | 纯文本 + 编号确认 | REST API fallback | 平台无法识别时使用 |
+
+## 支持状态定义
+
+- **稳定**：有明确运行环境和交互契约，作为默认交付路径。
+- **可选**：仅在交付目标包含该平台时加载，不是核心流程依赖。
+- **待验证**：保留适配器，但需要真实平台验收后再升级状态。
+- **已弃用**：不再接受新交付；完成迁移后删除文件和索引项。
+
+## 适配器删除规则
+
+删除平台适配器时，必须同时更新：
+
+1. 本矩阵中的平台行；
+2. `adapters/README.md` 的路由和文件索引；
+3. `platform/interaction.md` 中的平台说明；
+4. `CHANGELOG.md` 的迁移记录；
+5. 运行包检查，确保矩阵、索引和实际文件一致。

package/skills/mono/references/modules/soke-ai-coach-director/platform/publish-gate.md

@@ -6,6 +6,7 @@
 
 ### 结构验收
 - Part1 基础字段存在：`name/description/tags/key_points/scene_lang/scenario_cover`
+- Part1 `scene_lang` 必须是 `zh`、`tw` 或 `en`
 - Part2 角色回读正常：无 `角色数据异常`
 - Part4 评分配置存在：`scoring_criteria_config.criteria_data.dimensions` 非空
 - Part5 固定配置有效

package/skills/mono/references/modules/soke-ai-coach-director/platform/soke-ai-training/soke-ai-training.md

@@ -11,12 +11,14 @@ metadata:
 
 # AI教练知识包
 
-**CRITICAL — 开始前 MUST 先读取 [`../../../soke-shared/MODULE.md`](../../../soke-shared/MODULE.md)，其中包含认证、配置和权限处理。**
+## 共用前置
+
+开始前读取 `../../../../../shared/README.md`，并按需加载环境检测、登录验证、对象上下文、输出、写后验证、异步任务和错误处理规则。本子模块只保留知识包同步特例。
 
 ## 使用前提
 
-1. 运行 `soke-cli auth login` 完成用户授权。
-2. 确认 `soke-cli config show` 中有 `APIBaseURL`、`AppKey`、`AppSecret`、`CorpID` 和用户 token。
+1. 按共享登录验证规则确认授权有效，不在本子模块重复维护认证流程。
+2. 不要在对话或仓库中回显 `AppSecret`、用户 token 等敏感配置；租户和对象标识必须使用 CLI 查询结果。
 3. 客户原始 PDF、Word、Excel、网页等资料必须先由本地 Agent/Skills 提炼为 Markdown sources 和结构化 entries JSON。
 
 ## 推荐同步

package/skills/mono/references/modules/soke-ai-coach-director/platform/sync-engine.md

@@ -1,6 +1,6 @@
 # 平台同步引擎（字段参考手册）
 
-> ⚠️ **本文件已降级为字段参考手册**。执行规则、JSON 模板、字段硬规则、断言均以 `../references/exec-handbook.md` 为唯一事实源。本文件只保留 exec-handbook 未覆盖的：文件产出命名、一致性扫描、跨 Part 交接。
+> ⚠️ **本文件已降级为字段参考手册**。执行规则、JSON 模板、字段硬规则、断言均以 `../references/exec-common.md` 与对应的 `../references/exec-partN.md` 为事实源。本文件只保留执行文件未覆盖的：文件产出命名、一致性扫描、跨 Part 交接。
 
 ## 核心原则（补充 exec-handbook）
 
@@ -35,5 +35,5 @@ Part2 角色卡的「我的行为模式」（共鸣触发/关键台词/防御机
 ## 边界
 
 - `interaction.md` 负责：弹窗确认、按钮分支、回退链路。
-- `exec-handbook.md` 负责：确认后的 JSON 生成、CLI 模板、断言、状态快照更新（唯一事实源）。
+- `exec-common.md` 与对应 `exec-partN.md` 负责：确认后的 JSON 生成、CLI 模板、断言和状态快照更新；本文件不维护执行事实。
 - 本文件负责：字段参考、文件命名、一致性扫描。

package/skills/mono/references/modules/soke-ai-coach-director/references/env-check.md

@@ -1,5 +1,8 @@
 # soke-cli 环境检测
 
+> 通用环境与登录规则已抽取到 `../../../shared/environment-check.md` 和 `../../../shared/auth-check.md`。
+> 本文件保留 AI 陪练的兼容入口及额外依赖说明；新流程优先读取共享文件。
+
 独立于页面/创作管线，仅在需要调用平台接口时执行。
 
 ---

package/skills/mono/references/modules/soke-ai-coach-director/references/exec-handbook.md

@@ -12,8 +12,8 @@
 
 | # | 操作 | CLI 命令 | 产物 |
 |---|------|---------|------|
-| 1 | 创建场景 | `soke-cli ai-training +create-scenario --request-file ./part1-create.json --pretty` | `scenario_id` |
-| 2 | 回读验证 | `soke-cli ai-training +get-scenario --scenario-id <id> --pretty` | name/description/key_points/tags 一致 |
+| 1 | 创建场景 | `soke-cli ai-training +create-scenario --request-file ./part1-create.json > /tmp/part1-create.json 2>/dev/null` | `scenario_id` |
+| 2 | 回读验证 | `soke-cli ai-training +get-scenario --scenario-id <id> --raw > /tmp/scenario_get.json 2>/dev/null` | name/description/key_points/tags 一致 |
 
 > Part1 走**创建链路**，不是 preview/apply 更新链路。没有 operations 数组。
 
@@ -25,7 +25,7 @@
   "description": "<场景描述全文，完整搬运不缩略>",
   "tags": ["标签1", "标签2", "标签3"],
   "key_points": "1) 考核点1；2) 考核点2；3) 考核点3",
-  "scene_lang": "简体中文",
+  "scene_lang": "zh",
   "scenario_cover": "https://newsokeeditorcdn.soke.cn/public/ai/cover/lingshou_daogou.png"
 }
 ```
@@ -38,7 +38,7 @@
 | `description` | string | Part1 场景描述全文，禁缩略 | 只写首句摘要 |
 | `tags` | string[] | 3-5 个数组元素 | ❌ 逗号分隔字符串 |
 | `key_points` | **string** | 多条用分号/编号拼成**单字符串** | ❌ 写成数组（平台会接受但字段为空） |
-| `scene_lang` | string | 固定 `"简体中文"`（永不随场景变） | ❌ `"zh-CN"` / `"中文"` |
+| `scene_lang` | string | 仅支持 `zh`、`tw`、`en`（分别为简体中文、繁体中文、英文） | ❌ `"简体中文"` / `"zh-CN"` / `"中文"` |
 | `scenario_cover` | string | 固定默认图 URL | ❌ 占位/本地路径 |
 
 ### 提交前断言（Python 表达式）
@@ -48,7 +48,7 @@ assert isinstance(data["name"], str) and 1 <= len(data["name"]) <= 100
 assert isinstance(data["description"], str) and len(data["description"]) >= 20
 assert isinstance(data["tags"], list) and 3 <= len(data["tags"]) <= 5
 assert isinstance(data["key_points"], str) and len(data["key_points"]) > 0  # 必须是字符串
-assert data["scene_lang"] == "简体中文"
+assert data["scene_lang"] in {"zh", "tw", "en"}
 assert data["scenario_cover"] == "https://newsokeeditorcdn.soke.cn/public/ai/cover/lingshou_daogou.png"
 ```
 
@@ -67,9 +67,9 @@ assert data["scenario_cover"] == "https://newsokeeditorcdn.soke.cn/public/ai/cov
   "tags": "展会拓客,B2B销售,快速识别"
 }
 
-❌ 案例 C：scene_lang 写成 zh-CN
+❌ 案例 C：scene_lang 使用不支持的展示名称或区域码
 {
-  "scene_lang": "zh-CN"
+  "scene_lang": "简体中文"
 }
 
 ❌ 案例 D：封面留空或写占位 URL

package/skills/mono/references/modules/soke-ai-coach-director/references/exec-part1.md

@@ -23,7 +23,7 @@
   "description": "<场景描述全文，完整搬运不缩略>",
   "tags": ["标签1", "标签2", "标签3"],
   "key_points": "1) 考核点1；2) 考核点2；3) 考核点3",
-  "scene_lang": "简体中文",
+  "scene_lang": "zh",
   "scenario_cover": "https://newsokeeditorcdn.soke.cn/public/ai/cover/lingshou_daogou.png"
 }
 ```
@@ -36,7 +36,7 @@
 | `description` | string | Part1 场景描述全文，禁缩略 | 只写首句摘要 |
 | `tags` | string[] | 3-5 个数组元素 | ❌ 逗号分隔字符串 |
 | `key_points` | **string** | 多条用分号/编号拼成**单字符串** | ❌ 写成数组（平台会接受但字段为空） |
-| `scene_lang` | string | 固定 `"简体中文"`（永不随场景变） | ❌ `"zh-CN"` / `"中文"` |
+| `scene_lang` | string | 仅支持 `zh`、`tw`、`en`（分别为简体中文、繁体中文、英文） | ❌ `"简体中文"` / `"zh-CN"` / `"中文"` |
 | `scenario_cover` | string | 固定默认图 URL | ❌ 占位/本地路径 |
 
 ---
@@ -48,7 +48,7 @@ assert isinstance(data["name"], str) and 1 <= len(data["name"]) <= 100
 assert isinstance(data["description"], str) and len(data["description"]) >= 20
 assert isinstance(data["tags"], list) and 3 <= len(data["tags"]) <= 5
 assert isinstance(data["key_points"], str) and len(data["key_points"]) > 0
-assert data["scene_lang"] == "简体中文"
+assert data["scene_lang"] in {"zh", "tw", "en"}
 assert data["scenario_cover"] == "https://newsokeeditorcdn.soke.cn/public/ai/cover/lingshou_daogou.png"
 ```
 
@@ -63,8 +63,8 @@ assert data["scenario_cover"] == "https://newsokeeditorcdn.soke.cn/public/ai/cov
 ❌ 案例 B：tags 写成逗号分隔字符串
 { "tags": "展会拓客,B2B销售,快速识别" }
 
-❌ 案例 C：scene_lang 写成 zh-CN
-{ "scene_lang": "zh-CN" }
+❌ 案例 C：scene_lang 使用不支持的展示名称或区域码
+{ "scene_lang": "简体中文" }
 
 ❌ 案例 D：封面留空或写占位 URL
 { "scenario_cover": "" }

package/skills/mono/references/modules/soke-ai-coach-director/references/platform-api-pitfalls.md

@@ -41,7 +41,7 @@
 - **验收**：apply 后 `+get-scenario --raw` 逐字段核对目标字段；preview/apply 成功≠平台最终解析正常。
 - **JSON 中文引号**：用 Python `json.dump(ensure_ascii=False)` 写入，禁 heredoc/echo（全角双引号会报错）。
 - **类型**：Part3 `max_rounds` 整数、`sort_order` 字符串 `"1"`；Part4 `sort_order` 数字 `1`（两者相反）。
-- **Part1 必填**：`key_points` 是字符串（非数组）、`scene_lang="简体中文"`、`scenario_cover` 固定默认图 `https://newsokeeditorcdn.soke.cn/public/ai/cover/lingshou_daogou.png`。
+- **Part1 必填**：`key_points` 是字符串（非数组）、`scene_lang` 为 `zh/tw/en` 之一、`scenario_cover` 固定默认图 `https://newsokeeditorcdn.soke.cn/public/ai/cover/lingshou_daogou.png`。
 - **身份字段**：`corp_id/user_id/implementation_corp_id` 禁写请求体，不作选租户依据。
 
 ## 推荐顺序

package/skills/mono/references/modules/soke-ai-coach-director/references/self-learning-engine.md

@@ -464,6 +464,10 @@ grep -B5 'Priority\*\*: high' .learnings/*.md | grep '^## \['
 
 | 文件 | 用途 |
 |------|------|
+| `scripts/activator.sh` | 每轮对话后提醒评估学习(可选启用) |
+| `scripts/error-detector.sh` | 命令执行失败时自动检测并提示记录 |
+| `scripts/extract-skill.sh` | 从 learning 提取为新 skill |
+| `scripts/sync.sh` | Part3-5 统一脚本代理执行器(统一返回 success/failed/fail_stage/next_action/updated_at/validation_result) |
 | `assets/LEARNINGS-TEMPLATE.md` | 学习条目记录模板 |
 | `assets/ERRORS-TEMPLATE.md` | 错误条目记录模板 |
 | `assets/FEATURE_REQUESTS-TEMPLATE.md` | 功能请求记录模板 |

package/skills/mono/references/modules/soke-ai-coach-director/references/subs/part1/SOP.md

@@ -4,7 +4,7 @@
 
 ## 固定约束
 
-- 场景语言 `scene_lang` 固定 `"简体中文"`（永不随场景变）。
+- 场景语言 `scene_lang` 仅支持 `zh`（简体中文）、`tw`（繁体中文）、`en`（英文）。
 - 封面固定默认 URL `https://newsokeeditorcdn.soke.cn/public/ai/cover/lingshou_daogou.png`（确认后后台写入）。
 - `key_points` 必须**单个字符串**（多条用分号/编号拼接，非数组）。
 
@@ -14,4 +14,4 @@
 
 ## 自查清单（7 项）
 
-1. name 非空 ≤15 字；2. description 100-200 字；3. scene_lang="简体中文"；4. cover 非空（固定 URL）；5. **key_points 是字符串非数组（最高频错误）**；6. category_id 非空；7. tags 3-5 个。
+1. name 非空 ≤15 字；2. description 100-200 字；3. scene_lang 为 `zh/tw/en` 之一；4. cover 非空（固定 URL）；5. **key_points 是字符串非数组（最高频错误）**；6. category_id 非空；7. tags 3-5 个。

package/skills/mono/references/modules/soke-ai-coach-director/references/subs/publish/SOP.md

@@ -5,7 +5,7 @@
 ## Step 6: 平台同步验证
 
 1. 读取 `state-snapshot.json`，验证所有 Part 的 `applied` 均为 `true`
-2. 执行 `soke-cli ai-training +get-scenario --scenario-id <id> --pretty`
+2. 执行 `soke-cli ai-training +get-scenario --scenario-id <id> --raw > /tmp/scenario_get.json 2>/dev/null`
 3. 逐字段验证：
    - `key_points`、`description`、`name` → 与 `step1-create.json` 一致
    - `ai_roles` 非空 + `role_data.name` ≠ "角色数据异常"
@@ -63,10 +63,10 @@ soke-cli ai-training +publish-scenario \
   --scenario-id <scenario_id> \
   --version 1 \
   --version-description "CLI发布" \
-  --pretty
+  > /tmp/publish_result.json 2>/dev/null
 ```
 
-发布后验收：`+get-scenario --scenario-id <id> --pretty` 确认状态。
+发布后验收：`+get-scenario --scenario-id <id> --raw > /tmp/scenario_get.json 2>/dev/null`，由闸门脚本确认状态。
 
 > 🚦 闸门：发布成功后方可交付。
 

package/skills/mono/references/modules/soke-ai-coach-director/scripts/activator.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# AI 陪练 — 学习提醒钩子
+# 每轮对话后提醒评估学习（可选启用）
+echo "[activator] 提醒：检查本轮是否有新的学习点需要记录"

package/skills/mono/references/modules/soke-ai-coach-director/scripts/error-detector.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# AI 陪练 — 命令错误检测
+# 命令执行失败时自动检测并提示记录
+echo "[error-detector] 检测到错误，建议记录到 .learnings/ERRORS.md"

package/skills/mono/references/modules/soke-ai-coach-director/scripts/extract-skill.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+# AI 陪练 — 学习条目提取为独立 skill
+# 用法: extract-skill.sh LRN-YYYYMMDD-XXX [--dry-run]
+LEARNING_ID="$1"
+DRY_RUN="$2"
+echo "[extract-skill] 从 $LEARNING_ID 提取新 skill"
+[ "$DRY_RUN" = "--dry-run" ] && echo "[dry-run] 预览模式，不实际执行"

package/skills/mono/references/modules/soke-ai-coach-director/scripts/gate_check.py

@@ -63,6 +63,8 @@ def check(sc: dict) -> list:
         errs.append("[闸门8] key_points 为空（检查 Part1 是否误写数组）")
     if not (sc.get("tags") and len(sc.get("tags", [])) >= 3):
         errs.append("[闸门8] tags 少于 3 个")
+    if sc.get("scene_lang") not in {"zh", "tw", "en"}:
+        errs.append(f"[闸门8] scene_lang 必须是 zh、tw 或 en，当前 {sc.get('scene_lang')!r}")
 
     # 12. 整体设定 ≤ 3000 字
     if len(os_text) > 3000:

package/skills/mono/references/modules/soke-ai-coach-director/scripts/validate_operations.py

@@ -54,8 +54,8 @@ def validate_part1(data: dict) -> list[str]:
         errors.append("key_points: ❌ 被写成数组，平台会接受但字段为空。改为分号拼接的单字符串")
 
     # scene_lang
-    if data.get("scene_lang") != "简体中文":
-        errors.append(f"scene_lang: 必须固定为 '简体中文'，当前 {data.get('scene_lang')!r}")
+    if data.get("scene_lang") not in {"zh", "tw", "en"}:
+        errors.append(f"scene_lang: 必须是 zh、tw 或 en，当前 {data.get('scene_lang')!r}")
 
     # scenario_cover 或 cover_url（CLI 接受两者）
     cover = data.get("scenario_cover") or data.get("cover_url")
@@ -70,6 +70,13 @@ def validate_part1(data: dict) -> list[str]:
 def validate_part2(operations: list) -> list[str]:
     errors = []
 
+    for i, op in enumerate(operations):
+        if op.get("type") != "update_basic":
+            continue
+        data = op.get("data", {})
+        if "scene_lang" in data and data.get("scene_lang") not in {"zh", "tw", "en"}:
+            errors.append(f"operations[{i}].data.scene_lang: 必须是 zh、tw 或 en，当前 {data.get('scene_lang')!r}")
+
     # 操作 1: update_basic (OS)
     os_ops = [o for o in operations if o.get("type") == "update_basic"]
     if not os_ops:

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

@@ -11,13 +11,40 @@ metadata:
 
 # AI教练知识包与场景管理
 
-**CRITICAL — 开始前 MUST 先读取 [`../soke-shared/MODULE.md`](../soke-shared/MODULE.md)，其中包含认证、配置和权限处理。**
+## 共用前置
 
-## 使用前提
+开始前读取 `../../shared/README.md`，并按需加载环境检测、登录验证、对象上下文、输出、写后验证、异步任务和错误处理规则。本模块只保留 AI 教练知识包特有规则；陪练场景的 Part1-Part5 生成、确认、发布闸门由 `soke-ai-coach-director` 负责。
 
-1. 运行 `soke-cli auth login` 完成用户授权。
-2. 确认 `soke-cli config show` 中有 `APIBaseURL`、`AppKey`、`AppSecret`、`CorpID` 和用户 token。
-3. 客户原始 PDF、Word、Excel、网页等资料必须先由本地 Agent/Skills 提炼为 Markdown sources 和结构化 entries JSON。
+## 职责
+
+本模块负责 AI 教练知识包的同步与 source 管理、知识包版本与场景绑定、知识计划编译查询，以及已有场景的读取、安全更新、发布和快照恢复；不负责 AI 陪练 Part1-Part5 内容生成及确认流程。
+
+## 输入
+
+根据任务类型提供：
+
+- 知识包同步：manifest、Markdown sources、结构化 entries JSON 和幂等键；
+- 场景绑定：真实 `scenario-id` 与知识包 `version-ids`；
+- 场景更新：当前场景基准、`base_updated_at`、operations 和幂等键；
+- 发布或恢复：真实场景 ID，以及发布版本信息或快照 ID。
+
+客户原始 PDF、Word、Excel、网页等资料必须先由本地 Agent/Skills 提炼为 Markdown sources 和结构化 entries JSON。
+
+## 业务流程
+
+1. 按任务读取当前知识包、source、场景或快照状态；
+2. 校验输入文件、真实对象 ID、版本关系和更新基准；
+3. 先预览场景更新或执行知识包同步，再进行应用、绑定、编译或发布；
+4. 使用查询命令或状态文件验证版本、绑定关系、计划和场景状态；
+5. 只返回已验证的业务对象与状态摘要。
+
+## 放行与完成条件
+
+- 知识包同步：manifest、sources 和 entries 校验通过，且同步状态文件记录成功版本；
+- 场景绑定：场景与版本 ID 均来自当前查询，绑定后知识计划可查询；
+- 场景更新：必须先取得最新 `updated_at`，preview 通过后才 apply；
+- 场景发布：仅在业务模块的发布闸门通过后执行，发布后状态可回读；
+- 只有目标对象、版本/绑定关系和最终状态均可验证时，才能报告完成。
 
 ## 推荐同步
 
@@ -91,6 +118,8 @@ soke-cli ai-training +get-plan --scenario-id scenario_micro_loan_sales --format
 
 ### 创建场景
 
+`scene_lang` 是场景语言代码，合法值仅有 `zh`（简体中文）、`tw`（繁体中文）和 `en`（英文）。CLI flags 与 `--request-file` 使用同一枚举校验；不要传入 `简体中文`、`中文`、`zh-CN` 或其他值。
+
 如果封面图由本地智能体生成，先上传封面并拿到可写入 `scenario_cover` 的 CDN URL：
 
 ```bash
@@ -236,7 +265,22 @@ soke-cli ai-training +restore-scenario-snapshot \
 
 新增场景命令默认输出 MentorAI `BaseResponse.data`；排查错误时加 `--raw` 保留 `success/errorCode/errorMessage/details/traceId`。
 
-## 注意
+## 业务产出与验证
+
+- 知识包任务产出知识包版本、source 清单和 `.mentorai-sync-state.json`；以同步响应、版本列表和状态文件共同验证。
+- 场景绑定任务产出场景与知识包版本的绑定关系及编译后的知识计划；以 `+get-plan` 回读验证。
+- 场景更新任务产出新的场景配置与更新时间；以 `+get-scenario` 回读目标字段验证。
+- 场景发布或恢复任务产出发布状态或恢复后的快照状态；必须回读实际场景状态，不能以命令已发出代替成功。
+
+## 失败与降级
+
+- 发生 409 乐观锁冲突时，重新读取最新场景和 `updated_at`，重新生成更新请求，不复用旧基准重试。
+- manifest、source 或 entries 校验失败时停止同步，不写入伪成功状态文件。
+- 上传、同步、绑定、编译或发布部分成功时，保留已完成对象和失败阶段，先查询真实状态再决定是否重试。
+- 认证、权限、网络和通用 CLI 错误按共享错误处理规则恢复；无法恢复时停止当前任务并报告人工处理入口。
+- 失败后禁止改用伪造 `corp_id`、`user_id`、`object_key` 或未经验证的业务 API 绕过限制。
+
+## 业务特例
 
 - 不要在 manifest 或 entries 中伪造 `corp_id`、`user_id` 或 `object_key`。
 - `object_key` 必须使用 upload-token 返回值。
@@ -246,4 +290,10 @@ 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发布`；不要把它当作局部更新命令。
+- 场景发布需要 `+publish-scenario --scenario-id <id>`，默认带 `version=1` 和 `version_description="CLI发布"`；不要把它当作局部更新命令。
+
+## 输出
+
+- 返回已验证的知识包、source、版本、场景、绑定关系、知识计划或快照状态摘要。
+- 仅在后续流程需要时传递真实对象 ID、版本 ID 和状态文件路径。
+- 原始响应、上传签名、Token 和客户材料遵循共享输出脱敏规则，不直接回显。

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

@@ -7,21 +7,58 @@ tags: [soke, assign, department, user, enrollment]
 
 # 指派管理
 
-## 触发描述
+## 共享前置
 
-课程创建并发布后，需要将课程指派给部门或具体学员时触发本技能。支持查询组织架构、查询用户列表、创建指派记录及查看指派列表。
+开始操作前读取：
 
-## 前置条件
+- `../../shared/environment-check.md`
+- `../../shared/auth-check.md`
+- `../../shared/command-discovery.md`
+- `../../shared/object-context.md`
+- `../../shared/interaction.md`
+- `../../shared/write-guard.md`
+- `../../shared/output-policy.md`
+
+## 职责
+
+负责查询部门和用户，并为已发布的课程、考试或学习地图创建和查询指派关系；不负责资源创建、配置或发布。
+
+## 输入
+
+- 已发布资源的真实 ID
+- 目标部门或用户的真实 ID
+- 指派资源类型、必修/选修属性和用户范围
+- 用户明确的指派或查询动作
+
+## 流程
+
+```text
+确认资源已发布 → 查询部门/用户 → 确认目标范围
+→ 展示指派摘要并获得确认 → 创建指派 → 查询指派结果
+```
 
-- 目标课程 `status = 1`（已发布），未发布的课程不可指派
-- 具有指派权限（管理员或课程负责人）
+## 业务特例
 
-## 执行流程
+- 目标课程必须 `status = 1`（已发布）。
+- 当前命令示例中的 `--module` 为 `course`；考试或学习地图指派须以当前 CLI 帮助和对应模块规则为准。
+- 批量指派建议单次不超过 500 人，超出时分批处理。
+- 取消指派不在 CLI 范围内，需通过后台操作。
+
+## 输出
+
+返回资源名称、指派类型、人数和处理状态等业务摘要；用户姓名可以展示，内部 ID 和完整响应遵循 `../../shared/output-policy.md`。
+
+**完成判定**：指派真正创建成功，当且仅当 `assign +list`（基于资源 ID 查询）能查到对应用户的指派记录，且记录中的必修/选修标记与请求一致。仅 `assign +create` 返回成功提示、但 `+list` 查不到记录时，视为未完成，不得向用户报告“指派成功”。
+
+## 前置条件
+
+- 目标资源已发布
+- 具有指派权限
 
 ### 1. 查询部门 `assign +list-departments`
 
 ```bash
-soke assign +list-departments
+soke-cli assign +list-departments
 ```
 
 返回当前租户下所有部门结构。输出格式预期为部门 ID 与名称的层级列表。
@@ -31,7 +68,7 @@ soke assign +list-departments
 ### 2. 查询用户 `assign +list-users`
 
 ```bash
-soke assign +list-users --department-id <departmentId>
+soke-cli assign +list-users --department-id <departmentId>
 ```
 
 | 参数 | 必填 | 说明 |
@@ -43,7 +80,7 @@ soke assign +list-users --department-id <departmentId>
 ### 3. 创建指派 `assign +create`
 
 ```bash
-soke assign +create \
+soke-cli assign +create \
   --module course \
   --module-id <courseId> \
   --compulsory <1|0> \
@@ -62,7 +99,7 @@ soke assign +create \
 ### 4. 查询指派 `assign +list`
 
 ```bash
-soke assign +list --module-id <courseId>
+soke-cli assign +list --module-id <courseId>
 ```
 
 | 参数 | 必填 | 说明 |
@@ -94,10 +131,12 @@ soke assign +list --module-id <courseId>
 5. 批量指派建议单次 user-ids 不超过 500 人，超出分批处理
 6. 取消指派（删除指派记录）需通过后台操作，CLI 不直接支持
 
+**失败降级**：若 `+create` 报“课程未发布/status 不符”或用户 ID 无效，立即停止并告知用户失败原因，不得假装成功；若批量中部分用户失败，报告成功与失败明细，不要整体宣称完成。
+
 ## 检查清单
 
 - [ ] 课程 status = 1（已发布确认）
 - [ ] 已通过 list-departments / list-users 确认目标用户 ID
 - [ ] compulsory 正确设定（1=必修, 0=选修）
 - [ ] user-ids 为逗号分隔的有效用户 ID 列表
-- [ ] 指派完成后通过 assign +list 验证结果
+- [ ] 指派完成后通过 assign +list 验证结果（查不到记录＝未完成）