@sokeai/cli 1.0.77 → 1.0.79

package/skills/mono/SKILL.md

@@ -0,0 +1,223 @@
+---
+name: soke-cli
+description: "授客AI CLI 全业务 Mono Skill。通过 soke-cli 管理课程、考试、题库、素材、课件、指派、学习地图、学习档案、证书、图片库、培训需求、AI 教练和 AI 督导。当用户需要从自然语言执行或了解上述业务操作时使用。"
+metadata:
+  requires:
+    bins:
+      - soke-cli
+---
+
+# 授客AI CLI 全业务 Skill
+
+本目录是可独立复制和安装的 Mono 发布包。所有参考文档、工作流、案例和脚本均位于本目录内，不依赖原始代码仓库。
+
+## 前置条件
+
+开始任何业务操作前，先读取 [安装与认证](./references/installation.md) 和 [共享 CLI 规则](./references/shared/cli-basics.md)。
+
+## 意图路由
+
+按用户意图选择对应模块，并按需读取该模块的 `MODULE.md`：
+
+| 场景 | 模块 |
+|---|---|
+| 课程、课程发布、学习记录 | [soke-course](./references/modules/soke-course/MODULE.md) |
+| 考试、题库、试卷、成绩 | [soke-exam](./references/modules/soke-exam/MODULE.md) |
+| 题库答题练习 | [soke-exam-question-pool](./references/modules/soke-exam-question-pool/MODULE.md) |
+| 素材上传与管理 | [soke-material](./references/modules/soke-material/MODULE.md) |
+| 课件与课程章节 | [soke-lesson](./references/modules/soke-lesson/MODULE.md) |
+| 课程/考试/地图指派 | [soke-assign](./references/modules/soke-assign/MODULE.md) |
+| 学习地图 | [soke-learning-map](./references/modules/soke-learning-map/MODULE.md) |
+| 学员学习档案 | [soke-learning-profile](./references/modules/soke-learning-profile/MODULE.md) |
+| 证书、图片库、培训需求 | 对应模块目录 |
+| AI 教练、AI 督导 | 对应模块目录 |
+
+## 共享规则
+
+- 所有命令使用 `soke-cli`，不要绕过 CLI 直接调用 HTTP API。
+- 不编造 UUID、用户 ID、课程 ID 等标识符，必须先通过命令查询。
+- 写入、删除、发布等高风险操作遵循模块文档中的确认要求。
+- 详细资料按需读取，避免一次性加载整个参考目录。
+
+## 目录说明
+
+- `references/modules/`：各业务模块的完整参考资料
+- `references/shared/`：认证、权限、错误处理和 CLI 共用规则
+- `references/workflows/`：跨模块流程
+- `references/cases/`：AI 教练案例资料
+- `scripts/`：本 Skill 随附的辅助脚本
+
+## 严格禁止（NEVER DO）
+
+- 不要绕过 `soke-cli` 直接使用 `curl`、HTTP API 或浏览器操作业务接口。
+- 不要编造课程 ID、考试 ID、题库 ID、用户 ID、部门 ID 或其他 UUID；必须从 CLI 返回结果中提取。
+- 不要输出 `app_secret`、`access_token`、`refresh_token` 等敏感凭证。
+- 不要把示例值当成真实业务数据，不要自行补全用户未提供的信息。
+- 不要在未确认目标对象、影响范围和用户意图时执行删除、发布、指派或其他写操作。
+- 不要把 `soke-cli api` 当作绕过业务 Skill 约束的替代方案；只有模块文档明确要求时才使用。
+
+## 必须执行（MUST DO）
+
+- 开始任何业务操作前，先读取 [安装与认证](./references/installation.md) 和 [共享 CLI 规则](./references/shared/cli-basics.md)。
+- 先判断用户的核心动作，再选择业务模块；名词相似时不能仅凭关键词猜测。
+- 执行命令前使用对应命令的 `--help` 核对当前版本真实可用的参数，不要凭旧文档猜 flag。
+- 需要机器解析时优先使用 `--format json`；展示给用户时提炼关键字段，不回显大段原始 JSON。
+- 查询得到真实 ID 后才能执行后续依赖该 ID 的操作，并在多步流程中沿用同一对象。
+- 写操作完成后，根据模块文档要求报告结果；失败时保留具体错误，不静默改用未经验证的替代命令。
+
+## 前置检查
+
+```bash
+soke-cli --version
+soke-cli config show
+soke-cli auth login       # 首次使用或认证失效时执行
+soke-cli doctor           # 当前版本支持时执行健康检查
+```
+
+认证、Token、权限和通用错误处理以 [共享 CLI 规则](./references/shared/cli-basics.md) 为准。
+
+## 完整意图路由
+
+| 用户意图 | 模块参考 |
+|---|---|
+| 创建、发布、查询课程，配置课程设置 | [soke-course](./references/modules/soke-course/MODULE.md) |
+| 上传或查询视频、音频、文档素材 | [soke-material](./references/modules/soke-material/MODULE.md) |
+| 创建、查询、排序课程课件 | [soke-lesson](./references/modules/soke-lesson/MODULE.md) |
+| 将课程、考试或学习地图指派给用户/部门 | [soke-assign](./references/modules/soke-assign/MODULE.md) |
+| 创建、管理、发布、查询考试/题库/试卷 | [soke-exam](./references/modules/soke-exam/MODULE.md) |
+| 进行可练习题库的随机答题 | [soke-exam-question-pool](./references/modules/soke-exam-question-pool/MODULE.md) |
+| 创建、发布、查询学习地图 | [soke-learning-map](./references/modules/soke-learning-map/MODULE.md) |
+| 查询学员学习档案和学习统计 | [soke-learning-profile](./references/modules/soke-learning-profile/MODULE.md) |
+| 查询证书、证书分类和获得人员 | [soke-certificate](./references/modules/soke-certificate/MODULE.md) |
+| 上传、查询或删除图片库图片 | [soke-photo-gallery](./references/modules/soke-photo-gallery/MODULE.md) |
+| 创建统计导出任务、查询任务状态 | [soke-task](./references/modules/soke-task/MODULE.md) |
+| 查询、提交或投票培训需求 | [soke-training-demand](./references/modules/soke-training-demand/MODULE.md) |
+| AI 教练知识包、场景和知识计划 | [soke-ai-training](./references/modules/soke-ai-training/MODULE.md) |
+| AI 陪练创建、微调、平台同步和质量闸门 | [soke-ai-coach-director](./references/modules/soke-ai-coach-director/MODULE.md) |
+| AI 督导场景、评分标准、指派和发布 | [soke-supervisor](./references/modules/soke-supervisor/MODULE.md) |
+
+### 易混淆场景
+
+- 上传课程文件 → `soke-material`；把已上传素材放进课程章节 → `soke-lesson`。
+- 创建课程/考试/地图后的对象分配 → `soke-assign`，不要自行构造指派请求。
+- 查询考试成绩 → `soke-exam`；按题库随机答题 → `soke-exam-question-pool`。
+- 学习地图或课程统计导出 → `soke-task`，不要把导出任务当作普通列表查询。
+- AI 教练知识包同步 → `soke-ai-training`；陪练创建、微调、资源匹配和发布闸门 → `soke-ai-coach-director`。
+- AI 督导场景管理 → `soke-supervisor`，不要与普通课程指派混用。
+
+## 意图判断与执行流程
+
+1. **识别动作**：区分查询、创建、更新、发布、指派、删除、导出、同步或答题练习。
+2. **确认范围**：明确模块、目标对象、组织/用户范围和输出要求；存在歧义时先询问。
+3. **读取规则**：读取本入口、共享规则和对应模块 `MODULE.md`；复杂场景再读取专项参考资料。
+4. **发现命令**：先运行父级帮助，再运行叶子命令 `--help` 核对参数。
+5. **查询前置数据**：先获取分类、对象或用户的真实 ID，禁止猜测。
+6. **执行与衔接**：按模块定义顺序执行，每一步返回值作为下一步输入。
+7. **确认高风险操作**：发布、指派、删除和批量写入前展示摘要并等待明确确认。
+8. **汇报结果**：只报告相关结果、ID、状态和下一步，不泄露凭证或无关调试输出。
+
+## 命令发现与参数边界
+
+`soke-cli` 的命令帮助是当前二进制的最终事实源。文档示例用于理解流程，不能替代实际帮助输出。
+
+```bash
+soke-cli --help
+soke-cli course --help
+soke-cli exam --help
+soke-cli course +list-courses --help
+soke-cli exam +get-exam-user --help
+soke-cli course +list-courses --format json
+```
+
+- 有精确覆盖用户意图的 `+verb` shortcut 时，优先使用该 shortcut。
+- shortcut 不存在或不能覆盖完整流程时，按模块文档使用标准命令或 `api` 命令。
+- 文档与 `--help` 不一致时，以当前 `--help` 为准，并说明差异。
+- 不要为了验证参数而执行实际写操作；命令支持 `--dry-run` 时先使用预览模式。
+- 不要把列表响应、详情响应或 `--help` 输出误认为业务操作已经成功。
+
+## 输出与交互规范
+
+- 列表结果应说明分页、筛选条件和结果数量，不能把第一页当作全量结果。
+- 需要用户从固定选项中选择时，使用当前 Agent 可用的选择交互，不要求用户重新输入长编号列表。
+- 多步骤流程中，前一步未获得必要结果或用户选择时，不得擅自推进下一步。
+- AI 陪练主管流程必须遵循其前台/后台输出边界，不回显中间 JSON 或调试输出。
+
+## 高风险操作确认
+
+以下操作执行前必须展示操作摘要，并获得明确同意：
+
+| 操作类别 | 示例 | 必须说明 |
+|---|---|---|
+| 删除 | 删除课程、考试、证书、图片或任务 | 目标对象和不可逆影响 |
+| 发布/上线 | 发布课程、试卷、考试、学习地图、AI 场景 | 发布对象和可见范围 |
+| 指派 | 给部门或批量用户指派课程、考试、学习地图 | 资源、对象范围和必修/选修属性 |
+| 批量写入 | 批量创建或更新记录 | 数量、字段和失败处理方式 |
+| AI 平台同步 | 应用场景、绑定知识包、发布或关闭场景 | 将要修改的场景和配置摘要 |
+
+确认流程：
+
+```text
+Step 1 → 展示操作类型、目标对象、影响范围
+Step 2 → 等待用户明确确认
+Step 3 → 按模块文档执行命令；仅在命令要求时使用确认参数
+Step 4 → 返回执行结果和真实对象 ID
+```
+
+## 跨模块标准工作流
+
+### 课程创建与发布
+
+```text
+课程分类 → 创建课程 → 上传素材 → 创建课件 → 配置课程 → 发布课程 → 指派学员
+```
+
+必须按 `soke-course` 流程执行。课件创建参数必须来自 `soke-material` 的真实上传结果。
+
+### 考试创建与成绩查询
+
+```text
+题库分类 → 题库 → 试题 → 试卷 → 发布试卷 → 考试 → 指派 → 查询成绩
+```
+
+填空题、发布参数和题库/试卷 ID 依赖以 [soke-exam](./references/modules/soke-exam/MODULE.md) 为准。
+
+### 学习地图与统计导出
+
+```text
+地图分类 → 创建地图 → 查询课程 → 创建阶段 → 发布地图 → 指派 → 创建 task 导出 → 查询 task
+```
+
+统计导出统一读取 [soke-task](./references/modules/soke-task/MODULE.md)，不要重复实现异步轮询。
+
+## 错误处理
+
+1. 记录失败命令、模块、参数摘要和完整错误信息，敏感字段必须脱敏。
+2. 参数错误时运行同一叶子命令的 `--help`，修正后再试；不要换成猜测的命令。
+3. 认证错误时检查配置并执行 `soke-cli auth login`。
+4. 权限错误时告知缺失权限或需要管理员开通的范围，不要绕过权限。
+5. 写操作重试前确认是否可能已经成功，避免重复创建或重复指派。
+6. 仍无法解决时报告失败阶段、错误摘要和建议的人工处理动作。
+
+## 随附脚本
+
+发布包只保留有实际职责的 Python 辅助脚本：
+
+- AI 陪练质量闸门：[gate_check.py](./references/modules/soke-ai-coach-director/scripts/gate_check.py)
+- AI 陪练操作校验：[validate_operations.py](./references/modules/soke-ai-coach-director/scripts/validate_operations.py)
+- Mono 环境检查：[check_readiness.py](./scripts/check_readiness.py)
+
+使用脚本前先阅读对应模块说明，并使用 `python3` 执行。脚本输出中的凭证、完整响应和调试数据不得直接回显给用户。
+
+## 详细参考（按需读取）
+
+- [安装与认证](./references/installation.md)
+- [共享 CLI 规则](./references/shared/cli-basics.md)
+- [课程模块](./references/modules/soke-course/)
+- [考试模块](./references/modules/soke-exam/)
+- [AI 陪练主管](./references/modules/soke-ai-coach-director/)
+- [AI 教练知识包](./references/modules/soke-ai-training/)
+- [学习地图](./references/modules/soke-learning-map/)
+- [培训需求](./references/modules/soke-training-demand/)
+- [案例库](./references/cases/)
+
+除非用户明确要求全量内容，否则只读取与当前意图直接相关的模块和参考文件。

package/skills/{soke-course/soke-cli/345/256/211/350/243/205/346/214/207/345/215/227.md → mono/references/installation.md}

@@ -434,9 +434,6 @@ npx skills add liuchenlong1111/soke-cli -y -g
 
 ### 📖 阅读详细文档
 
-- [README.md](../README.md) - 项目概览
-- [CLAUDE.md](../CLAUDE.md) - 项目架构和开发规范
-- [skills/README.md](../skills/README.md) - AI Agent Skills 详细说明
 
 ---
 

package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/README.md

@@ -98,7 +98,8 @@ soke-ai-coach-director/
     ├── validate_operations.py
     ├── extract-skill.sh
     ├── error-detector.sh
-    └── activator.sh
+    ├── activator.sh
+    └── gate_check.py
 ```
 
 ## 关键规则速查

package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/coaching/prompt-engineer/parts/part1-basic.md

@@ -23,7 +23,7 @@
    - 每条都能在 Part4 中找到对应评分维度
    - 不写空泛价值观，必须写成可观察行为或明确结果
 5. **考核关键点是 `step1-create.json.key_points` 的直接来源**：Part1 确认后生成 `step1-create.json` 时，必须将考核关键点拼接为单个字符串写入 `key_points`（多条用分号或编号拼接，不能是数组）
-6. **`scene_lang` 固定为 `"简体中文"`**：永远写死为简体中文，取值不随用户语言、场景语种变化。→ 直接来源 `step1-create.json.scene_lang`
+6. **`scene_lang` 必须是语言代码**：仅支持 `zh`（简体中文）、`tw`（繁体中文）、`en`（英文）。→ 直接来源 `step1-create.json.scene_lang`
 
 #### 推荐输出格式
 

package/skills/{soke-ai-coach-director → 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

@@ -0,0 +1,123 @@
+---
+name: soke-ai-training
+summary: AI教练知识包同步、source管理、场景绑定和知识计划查询
+version: 1.0.0
+description: "用于本地Agent通过soke-cli调用开放平台AI教练知识包接口，完成Markdown source上传、结构化entries同步、source管理、场景知识包版本绑定和知识计划编译查询。"
+metadata:
+  requires:
+    bins: ["soke-cli"]
+  cliHelp: "soke-cli ai-training --help"
+---
+
+# AI教练知识包
+
+**CRITICAL — 开始前 MUST 先读取 [`../../../soke-shared/MODULE.md`](../../../soke-shared/MODULE.md)，其中包含认证、配置和权限处理。**
+
+## 使用前提
+
+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。
+
+## 推荐同步
+
+```bash
+soke-cli ai-training +sync \
+  --manifest ./knowledge-package.json \
+  --idempotency-key cli-rcb-loan-products-20260610-001
+```
+
+`+sync` 会完成：
+
+1. 读取 manifest 和 entries。
+2. 校验 Markdown 文件、source_refs、entry_id/source_id 唯一性。
+3. 调用 `/skills/ai-training/knowledge-packages/upload-tokens`。
+4. 直传 Markdown 到服务端返回的 `upload_url`。
+5. 调用 `/skills/ai-training/knowledge-packages/sync`。
+6. 写入 `.mentorai-sync-state.json`。
+
+## Manifest 示例
+
+```json
+{
+  "package": {
+    "package_id": "rcb-loan-products",
+    "name": "农商银行贷款产品知识包",
+    "domain": "banking_loan",
+    "tags": ["贷款产品"]
+  },
+  "sources": [
+    {
+      "source_id": "src_manual",
+      "path": "./sources/manual.md",
+      "display_name": "贷款产品手册",
+      "origin_type": "pdf",
+      "origin_filename": "loan-manual.pdf"
+    }
+  ],
+  "entries_path": "./knowledge-package.entries.json"
+}
+```
+
+## entries 格式（2026-08-18 实测补全）
+
+`entries_path` 指向的 JSON 是数组，每项字段：
+
+- `entry_id`：条目唯一 ID（如 `e_upgrade_super`）
+- `entry_type`：**必填枚举**，只能是 `customer_topic` / `disclosure_step` / `advisor_golden_script` / `evaluation_rubric_evidence` / `business_fact`（传其他值会 422）
+- `source_id`：来源 source 的 ID
+- `title`：条目标题
+- `content`：条目正文
+- `source_refs`：**对象数组**（不是字符串数组），形如 `[{"source_id": "src_manual"}]`（传字符串数组会 422）
+- `tags`：标签数组
+
+```json
+[
+  {
+    "entry_id": "e_001",
+    "entry_type": "business_fact",
+    "source_id": "src_manual",
+    "title": "产品权益",
+    "content": "……",
+    "source_refs": [{"source_id": "src_manual"}],
+    "tags": ["产品"]
+  }
+]
+```
+
+## 查询和管理
+
+```bash
+soke-cli ai-training +list-packages --format json
+soke-cli ai-training +list-versions --package-id rcb-loan-products
+soke-cli ai-training +list-sources --package-id rcb-loan-products
+soke-cli ai-training +rename-source --package-id rcb-loan-products --source-id src_manual --display-name "贷款产品手册2026Q2"
+soke-cli ai-training +delete-source --package-id rcb-loan-products --source-id src_manual
+```
+
+## 场景绑定
+
+```bash
+soke-cli ai-training +bind-scenario \
+  --scenario-id scenario_micro_loan_sales \
+  --version-ids 8ed4c1c4-5b3c-4d44-ae8e-d5b064bf1e12 \
+  --compile-plan
+
+soke-cli ai-training +compile-plan \
+  --scenario-id scenario_micro_loan_sales \
+  --version-ids 8ed4c1c4-5b3c-4d44-ae8e-d5b064bf1e12 \
+  --force
+
+soke-cli ai-training +get-plan --scenario-id scenario_micro_loan_sales --format json
+```
+
+## 注意
+
+- 不要在 manifest 或 entries 中伪造 `corp_id`、`user_id` 或 `object_key`。
+- `object_key` 必须使用 upload-token 返回值。
+- 不要把客户原始资料、token、app_secret 或 OSS 签名写入仓库。
+- `advisor_golden_script` 不应进入 AI 客户角色可见知识。
+- ⚠️ `+sync` **不支持 `--pretty`** 参数（加了会报 unknown flag，用 `--format json` 替代）。
+- ⚠️ `origin_filename` 用**纯 ASCII**（如 `manual.pdf`），中文文件名会触发 500「生成知识包上传凭证失败」（2026-08-18 实测）。
+- ⚠️ **v2.37 知识包复用提炼稿**：知识包 Markdown source 直接复用材料提炼稿（`/tmp/xxx_refined.md`），**禁止从零重写**（内容已在上下文中，重写浪费 3-5 积分）。只需按 entries 格式拆条目。
+- ⚠️ **v2.37 CLI 全重定向**：`+sync` / `+bind-scenario` 输出一律 `> /tmp/xxx.json 2>/dev/null`，Python 从重定向文件提取 `version_id` / `package_id`，**禁止 `--format json` 直出到对话**。

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

@@ -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/{soke-ai-coach-director → 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/{soke-ai-coach-director → 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/{soke-ai-coach-director → 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/scripts/gate_check.py

@@ -0,0 +1,114 @@
+#!/usr/bin/env python3
+"""
+soke-ai-coach-director · 闸门一次性校验器（v2.42）
+Usage:
+    python3 scripts/gate_check.py /tmp/scenario_get.json
+
+输入：+get-scenario 重定向后的 JSON 文件（自动处理 {data:{...}} 嵌套）
+输出：单行结果 —— 全过输出 "GATE PASS"，否则 "GATE FAIL" + 逐项失败原因
+退出码：0 = 通过，1 = 失败
+
+设计目的：消除闸门阶段逐字段拆轮探查（历史实测浪费 ~8 积分）。
+AI 只需跑这一个脚本，禁止再用 Python 逐步看返回结构。
+"""
+
+import json
+import sys
+
+
+def unwrap(raw):
+    """处理 CLI 返回的可能嵌套：{data:{...}} / {code,data} / 裸对象。"""
+    if not isinstance(raw, dict):
+        return raw
+    d = raw.get("data")
+    if isinstance(d, dict):
+        return d
+    return raw
+
+
+def check(sc: dict) -> list:
+    errs = []
+
+    # ---------- Step 8 发布闸门（4 项，任一缺失禁止发布） ----------
+
+    # 1. 封面 = 固定默认图（非空且正确前缀）
+    cover = sc.get("scenario_cover") or sc.get("cover")
+    if not cover or "roles_avatars" in str(cover) or not str(cover).startswith("http"):
+        errs.append(f"[发布1] 封面缺失或非法: {cover!r:.80}")
+
+    # 2/3. 全部角色 avatar / voice_id 非空
+    roles = sc.get("ai_roles") or []
+    if not roles:
+        errs.append("[发布2] ai_roles 为空")
+    for i, r in enumerate(roles):
+        rd = r.get("role_data") or r
+        av = rd.get("avatar")
+        vi = rd.get("voice_id")
+        if not av or not str(av).startswith("http"):
+            errs.append(f"[发布2] 角色{i}({rd.get('name','?')}) avatar 非法: {av!r:.60}")
+        if not vi:
+            errs.append(f"[发布3] 角色{i}({rd.get('name','?')}) voice_id 为空")
+
+    # 4. 无"角色数据异常"：OS 存在且足够长
+    os_text = sc.get("ai_roles_overall_description") or ""
+    if len(os_text) < 500:
+        errs.append(f"[发布4] OS 过短({len(os_text)}<500)，疑似角色数据异常")
+
+    # ---------- Step 7 补查 3 项（Part 自检已过的 9 项跳过） ----------
+
+    # 8. Part 内容完整：name/key_points/tags 非空
+    if not sc.get("name"):
+        errs.append("[闸门8] 场景名为空")
+    if not sc.get("key_points"):
+        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:
+        errs.append(f"[闸门12] OS 超长({len(os_text)}>3000)")
+
+    # 5. Part3 环节存在（回读 conversation_steps 非空；空则提示 CLI 限制，不阻塞）
+    steps = sc.get("conversation_steps") or []
+    if not steps:
+        print("WARN: conversation_steps 为空——已知 CLI/平台限制，发布后走 Web 后台补录（不阻塞）")
+
+    # 6. Part4 评分维度存在且权重和 = 100
+    cd = ((sc.get("scoring_criteria_config") or {}).get("criteria_data")) or sc.get("criteria_data") or {}
+    dims = cd.get("dimensions") or []
+    if not dims:
+        print("WARN: 评分维度在 get 返回中不可见——以 Part4 自检 + apply 成功为准（不阻塞）")
+    else:
+        w = sum(d.get("weight", 0) for d in dims)
+        if w != 100:
+            errs.append(f"[闸门6→发布] 维度权重和={w}≠100")
+
+    return errs
+
+
+def main() -> int:
+    if len(sys.argv) != 2:
+        print("Usage: gate_check.py <scenario_get.json>", file=sys.stderr)
+        return 1
+    try:
+        with open(sys.argv[1], encoding="utf-8") as f:
+            raw = json.load(f)
+    except Exception as e:
+        print(f"GATE FAIL: JSON 读取失败 {e}", file=sys.stderr)
+        return 1
+
+    sc = unwrap(raw)
+    errs = check(sc)
+    if errs:
+        print("GATE FAIL")
+        for e in errs:
+            print(f"  {e}")
+        return 1
+    print("GATE PASS")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())