@sokeai/cli 1.0.76 → 1.0.78

package/skills/multi/soke-ai-coach-director/platform/adapters/wukong.md

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

package/skills/multi/soke-ai-coach-director/platform/adapters/zework.md

@@ -0,0 +1,89 @@
+# Zework 平台适配器
+
+> Zework 是内部/私有 AI Agent 平台。由于平台细节未公开，本适配器使用通用降级策略——纯文本交互 + soke-cli 优先 / REST API 兜底。
+
+## 运行环境检测
+
+- 对话上下文包含 Zework 平台特征
+- 无 `AskUserQuestion` 工具可用
+- 交互方式未知（默认按纯文本处理）
+
+## 交互机制
+
+### 内容展示
+
+在对话中以 Markdown 纯文本完整展示 Part 内容。使用 `## 🔨 PartN：{标题}` 格式开头，逐字段输出全部正文。
+
+### 选项确认
+
+使用结构化文本编号确认：
+
+```
+请选择：
+1. {选项1}
+2. {选项2}
+3. {选项3}
+
+回复数字编号即可。
+```
+
+确认选项只展示编号和选项文案，禁止在选项后追加破折号说明、下一步动作说明或执行解释。例如只写：
+
+```
+1. 确认，同步到平台（推荐）
+2. 内容需要微调
+```
+
+不要写：`1. 确认，同步到平台（推荐）— 场景基础信息确认无误，立即创建场景到 MentorAI 平台`。
+
+所有 `.json` 文件名、文件路径、CLI 命令、脚本名、中间同步文件和命令输出均为后台信息，不得展示在 Zework 对话前台。
+
+选项文案和分支路由与 WorkBuddy 完全一致（参考 `../interaction.md` 模板 1-6）。
+
+### CLI / API 执行
+
+优先级：soke-cli（如可用）→ REST API fallback（参考 `../api-fallback.md`）。
+
+## 资源匹配（头像 + 声音）
+
+> ⚠️ **Zework 平台关键问题**：Zework 通常**没有预装 soke-cli**，而角色头像和声音匹配在 CLI 路径下依赖 `soke-cli ai-training +list-role-avatars` / `+list-role-voices` 命令。**若只检测 CLI 不可用就直接跳过资源匹配，角色上线后将无头像无声音。**
+
+### 匹配流程（Zework 专用）
+
+Zework 上的资源匹配**必须走 REST API 路径**：
+
+```
+Part2 完整展示并由用户确认
+  → 检测 soke-cli: which soke-cli → 大概率不可用
+  → ⚠️ 不跳过！路由到 REST API fallback
+  → 获取 Token（引导用户从授客AI开放平台获取，或从 `soke-cli config show` 提取）
+  → 查询头像库: GET /api/v1/ai-training/role-avatars?gender=<g>&age_group=<a>&lang=zh
+  → 查询语音库: GET /api/v1/ai-training/role-voices?gender=<g>&age_group=<a>&lang=zh
+  → 特征匹配（与 WorkBuddy 相同的 P0-P3 降级规则）
+  → 生成含 avatar + voice_id 的角色级 JSON
+  → 逐个角色 PATCH/apply + GET 验证 → 失败重试 1 次
+  → 全部角色与 OS 同步完成后输出 Part3
+```
+
+完整实现细节：`../api-fallback.md`「资源匹配完整流程」
+
+### 匹配规则引用
+
+性别/年龄映射、P0-P3 降级链路、合并写入规则 → `../../references/role-resource-matching.md`
+
+### 用户交互
+
+- 资源匹配过程中，若需要 Token 而 `soke-cli config show` 不可用，在对话中引导用户：「请提供授客AI开放平台的 API Token（从平台设置 → API 密钥获取），用于为角色匹配头像和声音资源」
+- 资源匹配、写入、回读过程默认不在对话中展示；只有失败且影响继续同步时，才输出最小必要异常
+
+## 扩展指南
+
+当 Zework 平台的具体能力明确后，可按以下方式扩展本适配器：
+
+1. **交互增强**：若 Zework 有弹窗/按钮等 UI 能力，在本文件中添加对应渲染模板
+2. **CLI 定制**：若 Zework 有特殊的命令执行沙箱，添加对应的 CLI 调用规则
+3. **Skill 格式**：若 Zework 有自己的 Skill 格式规范，添加打包说明
+
+## 适配器路由
+
+当检测到 Zework 平台特征且无匹配的更具体适配器时启用。默认行为 = 通用降级模式。

package/skills/multi/soke-ai-coach-director/platform/api-fallback.md

@@ -0,0 +1,262 @@
+# MentorAI REST API Fallback
+
+> 内部规则文件。当 soke-cli 在目标平台不可用或受限时，降级为直接调用 MentorAI REST API 完成平台同步。
+>
+> soke-cli 本质是 MentorAI REST API 的命令行封装。本文件记录 API 的直接调用方式，作为跨平台兜底方案。
+
+## 使用条件
+
+以下任一情况触发 API fallback：
+- soke-cli 未安装且无法安装（受限制的企业环境）
+- soke-cli 执行持续失败（沙箱限制、权限问题）
+- 平台不支持 CLI 执行（纯聊天/IM 环境）
+- 用户明确要求使用 API 方式
+
+## API 基础信息
+
+| 项目 | 值 |
+|------|-----|
+| Base URL | `https://api.soke.cn` |
+| 认证方式 | Bearer Token（从 `soke-cli config show` 获取 `user_token`） |
+| Content-Type | `application/json` |
+
+### 获取 Token
+
+若 soke-cli 可用（即使受限无法执行业务命令）：
+```bash
+soke-cli config show
+# 提取 user_token 字段
+```
+
+若 soke-cli 完全不可用：引导用户从授客AI开放平台获取 API Token。
+
+## API 接口映射
+
+soke-cli 命令与 REST API 的对应关系：
+
+### 场景创建 (Part1)
+
+**CLI**: `soke-cli ai-training +create-scenario --request-file ./step1-create.json`
+
+**API**:
+```
+POST /api/v1/ai-training/scenarios
+Headers:
+  Authorization: Bearer <token>
+  Content-Type: application/json
+Body: step1-create.json 内容
+```
+
+**关键字段**: `name`, `description`, `tags`, `key_points`, `language`
+
+### 场景查询
+
+**CLI**: `soke-cli ai-training +get-scenario --scenario-id <id> --pretty`
+
+**API**:
+```
+GET /api/v1/ai-training/scenarios/<scenario_id>
+Headers:
+  Authorization: Bearer <token>
+```
+
+### 场景更新 (Part2-5)
+
+每个 Part 对应一个 operations 文件 (`partN-operations.json`)。
+
+**CLI**: `soke-cli ai-training +preview-scenario-update ...` → `soke-cli ai-training +apply-scenario-update ...`
+
+**API** (两步合一):
+```
+PATCH /api/v1/ai-training/scenarios/<scenario_id>
+Headers:
+  Authorization: Bearer <token>
+  Content-Type: application/json
+Body: operations JSON 内容
+```
+
+> ⚠️ operations JSON 中的 `base_updated_at` 必须先通过 GET 查询获取最新平台状态，再填入。禁止使用过期的时间戳。
+
+### 角色头像列表
+
+**CLI**: `soke-cli ai-training +list-role-avatars [--gender <gender>] [--age-group <age>]`
+
+**API**:
+```
+GET /api/v1/ai-training/role-avatars?gender=<gender>&age_group=<age>
+Headers:
+  Authorization: Bearer <token>
+```
+
+### 角色语音列表
+
+**CLI**: `soke-cli ai-training +list-role-voices [--gender <gender>] [--age-group <age>]`
+
+**API**:
+```
+GET /api/v1/ai-training/role-voices?gender=<gender>&age_group=<age>
+Headers:
+  Authorization: Bearer <token>
+```
+
+### 场景发布
+
+**CLI**: `soke-cli ai-training +publish-scenario --scenario-id <id> --version 1`
+
+**API**:
+```
+POST /api/v1/ai-training/scenarios/<scenario_id>/publish
+Headers:
+  Authorization: Bearer <token>
+  Content-Type: application/json
+Body: {"version": 1, "version_description": "CLI发布"}
+```
+
+## 资源匹配完整流程（头像 + 声音）
+
+> ⚠️ **跨平台关键**：Avatar/voice 匹配在 soke-cli 可用时走 CLI（`role-resource-matching.md`），CLI 不可用时走本节的 REST API 路径。**禁止因 CLI 不可用直接跳过资源匹配**——这会导致角色上线后无头像无声音。
+
+### 匹配时机
+
+Part2 完整内容已展示并由用户确认 → 立即执行资源匹配 → 将 avatar URL 与 voice_id 写入角色级 JSON → 逐个角色 PATCH/apply 并回读验证。整个过程不等待用户触发，也不向用户二次确认。与 CLI 路径的时机完全一致。
+
+### 步骤 1：获取 Token
+
+```bash
+soke-cli config show 2>/dev/null | grep user_token
+# 若 soke-cli 完全不可用，引导用户从授客AI开放平台获取
+```
+
+### 步骤 2：查询头像库
+
+```bash
+# 一阶精准查询（性别+年龄）
+curl -s -H "Authorization: Bearer $TOKEN" \
+  "https://api.soke.cn/api/v1/ai-training/role-avatars?gender=female&age_group=middle-aged&lang=zh"
+
+# 降级：仅按性别
+curl -s -H "Authorization: Bearer $TOKEN" \
+  "https://api.soke.cn/api/v1/ai-training/role-avatars?gender=female&lang=zh"
+
+# 降级：无过滤全量
+curl -s -H "Authorization: Bearer $TOKEN" \
+  "https://api.soke.cn/api/v1/ai-training/role-avatars?lang=zh"
+```
+
+**返回字段**：`id`（资源 ID，不用于回填）、`url`（头像 CDN URL，**回填时用这个**）、`gender`、`age_group`、`sort`。
+
+### 步骤 3：查询语音库
+
+```bash
+# 一阶精准查询
+curl -s -H "Authorization: Bearer $TOKEN" \
+  "https://api.soke.cn/api/v1/ai-training/role-voices?gender=female&age_group=middle-aged&lang=zh"
+
+# 降级链路同头像
+```
+
+**返回字段**：`id`（语音资源 ID，**回填时用这个**）、`name`、`gender`、`age_group`、`sample_url`。
+
+### 步骤 4：特征匹配（与 CLI 路径相同的匹配规则）
+
+性别映射 → `../references/role-resource-matching.md`「性别映射表」
+年龄段映射 → `../references/role-resource-matching.md`「年龄段映射表」
+匹配优先级 → `../references/role-resource-matching.md` P0-P3 降级链路
+
+### 步骤 5：写入 avatar + voice_id 到角色级 JSON
+
+> ⚠️ **必须随角色主体单次写入**，禁止先写角色再分两次补 avatar/voice_id（分开调用导致 updated_at 竞态，第二次可能覆盖第一次结果）。REST API 兜底路径如需 PATCH，也必须把 avatar 与 voice_id 放在同一个角色级操作里。
+
+```bash
+# 1. 先获取最新 updated_at
+curl -s -H "Authorization: Bearer $TOKEN" \
+  "https://api.soke.cn/api/v1/ai-training/scenarios/<scenario_id>" \
+  | python3 -c "import sys,json; d=json.load(sys.stdin); print(d['data']['updated_at'])"
+
+# 2. 写入含 avatar + voice_id 的角色级操作
+curl -s -X PATCH \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "operations": [
+      {
+        "type": "patch_ai_role",
+        "data": {
+          "scenario_role_id": "<角色ID>",
+          "patch": {
+            "role_data": {
+              "avatar": "<头像URL>",
+              "voice_id": "<语音ID>"
+            },
+            "customized_fields": ["avatar", "voice_id"]
+          }
+        }
+      }
+    ],
+    "base_updated_at": "<updated_at>",
+    "idempotency_key": "api-<scenario_short>-part2-resources",
+    "reason": "Part2: 头像声音资源匹配 (REST API)"
+  }' \
+  "https://api.soke.cn/api/v1/ai-training/scenarios/<scenario_id>"
+```
+
+### 步骤 6：强制验证
+
+```bash
+curl -s -H "Authorization: Bearer $TOKEN" \
+  "https://api.soke.cn/api/v1/ai-training/scenarios/<scenario_id>" \
+  | python3 -c "
+import sys, json
+d = json.load(sys.stdin)
+for r in d['data']['ai_roles']:
+    rd = r.get('role_data', {})
+    avatar = rd.get('avatar', '')
+    voice = rd.get('voice_id', '')
+    status = 'OK' if (avatar.startswith('http') and voice) else 'MISSING'
+    print(f'{r[\"name\"]}: avatar={avatar[:50]}... voice_id={voice} [{status}]')
+"
+# 期望输出：每个角色 avatar 以 https:// 开头，voice_id 非空
+```
+
+### 步骤 7：重试与降级
+
+- 验证发现 avatar/voice_id 为空 → 重新 GET `updated_at` → 重试 1 次
+- 重试仍失败 → 标注「⚠️ {角色名} 资源匹配未完成 (REST API)」，不阻断 Part3
+- 头像/语音库 API 查询失败（网络/认证错误）→ 跳过资源匹配，标注「资源匹配未完成」
+
+## 执行规则
+
+### 安全规则
+
+1. **Token 安全**：`user_token` 只在内部使用，严禁写入对话窗口、JSON 文件或日志
+2. **请求验证**：每次 API 调用前，先 GET 获取最新 `updated_at`，避免并发冲突
+3. **错误处理**：4xx 检查字段格式 → 5xx 重试 1 次 → 仍失败则标注并记录
+
+### API fallback 执行流程
+
+```
+检测 soke-cli 不可用
+  → 获取 Token (soke-cli config show 或引导用户获取)
+  → 确认 Token 有效 (GET /api/v1/auth/verify)
+  → 按原管线顺序执行:
+    Part1: POST 创建场景 → 获取 scenario_id
+    Part2: 头像语音匹配（走「资源匹配完整流程」）→ PATCH 更新角色并回读
+    Part3: PATCH 更新流程
+    Part4: PATCH 更新评分
+    Part5: PATCH 更新教练设置
+  → Step 6: GET 验证同步完整性
+  → Step 7: 质量闸门
+  → Step 8: POST 发布场景
+```
+
+### 与 soke-cli 的差异
+
+| 项目 | soke-cli | REST API fallback |
+|------|----------|-------------------|
+| preview 预览 | `+preview-scenario-update` 输出 diff | 无 preview，直接 PATCH（可在 PATCH 前 GET 对比） |
+| 沙箱绕过 | `dangerouslyDisableSandbox: true` | 不适用（HTTP 请求不受沙箱限制） |
+| 命令速查 | `verified-cli-cheatsheet.md` | 本文件 |
+| 字段映射 | `sync-engine.md` 字段映射表 | 相同映射表，JSON 结构一致 |
+| 头像语音查询 | CLI `+list-role-avatars/voices` | GET API 端点 |
+
+> API fallback 路径下，JSON 文件结构、字段映射、自查清单与 soke-cli 路径完全一致。差异仅在传输方式：CLI 命令行 vs HTTP 请求。

package/skills/multi/soke-ai-coach-director/platform/interaction.md

@@ -0,0 +1,103 @@
+# 弹窗交互规则
+
+定义 Part1-Part5 及发布/知识包/微调的确认契约（标题/问题/选项/分支路由）。跨平台：WorkBuddy 用 AskUserQuestion，WebChat 用 render_ui QuestionForm，纯文本平台降级为编号选项（见 `platform/adapters/`）。
+
+## 核心规则
+
+1. **Part1 确认后强制同步**：模板 1 无"取消/跳过同步"选项，确认即创建场景。
+2. Part2-Part5 确认后自动 preview + apply，立即进下一 Part，不等二次确认。
+3. Part1 封面写入、Part2 头像/语音匹配、整包写角色、回读校验均后台自动，失败才提示。
+4. 若 Part3 apply 后回读 conversation_steps 仍为空，提示"CLI/平台版本限制，改走 Web 后台补录"。
+5. **弹窗即时触发（v2.30）+ 弹窗仅做确认（v2.41）**：Part **关键字段摘要**在聊天正文展示后立即弹窗。**弹窗 question 字段只写 ≤2 行引导语**（如「以上是 Part2 的 3 个角色设定，是否确认同步？」），**禁止把 Part 完整内容塞进 question 字段**。
+6. **选项文案与分支路由不因渲染方式变化**：所有平台完全一致，用户回复编号或选项文字均可。
+
+## v2.41 弹窗规则（核心变更，替代 v2.37 弹窗承载完整内容）
+
+**弹窗 question 字段只做确认引导，不承载 Part 内容。** 格式要求：
+
+1. **question 字段**：≤2 行引导语（如「以上是 Part2 的 3 个角色设定，是否确认同步？」）。**禁止把 Part 完整字段值写入 question**。
+2. **options**：只放「确认」「需要调整」等选择项。
+3. **options 的 description 字段**：可放 ≤15 字摘要（如「确认后同步到平台」），帮助用户快速判断。
+4. **聊天正文**：展示 Part 关键字段摘要（场景名/角色名+关键词/环节名+目标/维度名+权重/固定值确认），完整 JSON 直接 Write 落盘 /tmp/。
+
+### question 字段内容模板（v2.41 精简）
+
+**Part1**：`以上是 Part1 基础信息（场景名/描述/标签/考核点），是否确认创建？`
+**Part2**：`以上是 Part2 的 3 个角色设定（<角色1名>/<角色2名>/<角色3名>），是否确认同步？`
+**Part3**：`以上是 Part3 流程设置（<环节1名>/<环节2名>/...共 N 个环节），是否确认写入？`
+**Part4+5**（v2.43 合并）：`以上是 Part4 评分标准 + Part5 教练配置（6 项固定值），是否确认写入？`
+
+## AskUserQuestion 调用形式（WorkBuddy，v2.41 精简）
+
+```
+AskUserQuestion(
+  questions=[{
+    "question": "以上是 Part1 基础信息（场景名/描述/标签/考核点），是否确认创建？",
+    "header": "Part1 确认",
+    "options": [
+      {"label": "确认创建（推荐）", "description": "按上述内容创建场景"},
+      {"label": "需要调整", "description": "告诉我需要修改的地方"}
+    ]
+  }]
+)
+```
+
+选项顺序与正文模板一致（推荐操作第一位），模糊匹配优先选项 1。
+
+---
+
+## 确认契约
+
+### 模板 1：Part1 基础信息确认（强制同步）
+- **header**：Part1 确认
+- **question 字段（≤2 行引导语）**：`以上是 Part1 基础信息（场景名/描述/标签/考核点），是否确认创建？`
+- **options**：① 确认创建（推荐），description="按上述内容创建场景"；② 需要调整，description="告诉我需要修改的地方"
+- ⚠️ 无"取消"逃生路径。确认后立即 `+create-scenario`。
+
+### 模板 2：Part2 AI角色设定确认
+- **header**：Part2 确认
+- **question 字段（≤2 行引导语）**：`以上是 Part2 的 3 个角色设定（<角色1名>/<角色2名>/<角色3名>），是否确认同步？`
+- **options**：① 确认写入（推荐），description="<角色1名>/<角色2名>/<角色3名> 3个角色"；② 需要调整，description="告诉我需要修改的角色或性格"
+
+### 模板 3：Part3 流程设置确认
+- **header**：Part3 确认
+- **question 字段（≤2 行引导语）**：`以上是 Part3 流程设置（<环节1名>/<环节2名>/...共 N 个环节），是否确认写入？`
+- **options**：① 确认写入（推荐），description="<环节1名>/<环节2名>/... N个环节"；② 需要调整，description="告诉我需要调整的环节"
+
+### 模板 4：Part4 评分标准 + Part5 教练配置合并确认（v2.43）
+- **header**：Part4+5 确认
+- **question 字段（≤2 行引导语）**：`以上是 Part4 评分标准 + Part5 教练配置（6 项固定值），是否确认写入？`
+- **options**：① 确认写入（推荐），description="<维度1名><weight>分/... 权重合计100+6项固定配置"；② 需要调整，description="告诉我需要调整的维度或权重"
+- ⚠️ 聊天正文需完整展示 Part4（维度权重表）+ Part5（6 项编号列表）两段内容，禁止只给一行摘要。原模板 5（Part5 单独确认）已随 exec-part5.md 删除（v2.43.1）。
+
+### 模板 6：微调诊断确认
+- **标题**：诊断确认 ｜ **问题**：诊断结果和修改方案是否采纳？
+- **选项**：① 确认修改（推荐）→ 生成 optimize JSON → CLI 同步；② 保持原样 → 退出微调；③ 调整诊断 → 重诊。
+
+### 模板 7：知识包同步确认
+- **标题**：知识包同步确认 ｜ **问题**：场景已发布成功，是否同步知识包到平台？
+- **选项**：① 确认，同步知识包（推荐）→ `+sync` → `+bind-scenario`；② 跳过，暂不同步 → 仅输出摘要。
+
+### 模板 8：发布确认（v2.27）
+- **标题**：发布确认 ｜ **问题**：所有配置已完整同步到平台，确认发布场景吗？
+- **选项**：① 确认，发布场景（推荐）→ `+publish-scenario` → 完成摘要 → 弹模板 7；② 暂不发布 → 保持草稿。
+- 🚦 不可跳过或静默执行。
+
+### 模板 9：微调改动清单确认（v2.28）
+- **标题**：微调改动清单确认 ｜ **问题**：以下改动清单，确认后执行同步。
+- **选项**：① 确认，全部同步（推荐）；② 仅同步部分改动 → 模板 9.1；③ 调整优化方案。
+- ⚠️ 未过此闸门禁止生成 operations JSON 或 apply。
+
+### 模板 9.1：字段级同步范围确认（v2.31，多选）
+- 选项文案禁止用后台字段名，须用业务人员能懂的内容项描述（如「沟通风格与话术样例」而非 `communication_style`）。
+- 映射：`style/tone`→语气风格；`personality/trait`→性格特征；`taboo/objection/red_line`→禁忌底线；`background/story/mindset`→角色背景；`knowledge/fact`→知识水平；`step/flow/opening`→流程环节；`criteria/dimension/scoring`→评分维度。
+- 多选后用 AskUserQuestion `multiSelect=true`，返回选中项映射回字段 → 生成 operations → 模板 6。
+
+---
+
+## 通用规则
+
+- 正向操作带「（推荐）」；选项用业务语言，禁后台字段名。
+- 回复解析：精确匹配编号或完整选项文案；模糊匹配优先选项 1。
+- **状态快照**：每 Part 确认后记录 `state-snapshot.json`（scenario_id/current_part/confirmed_data/applied），仅内部断点续传用，不对用户展示。
+- **回退链路**：模板 2/3/4/5 的「重设」→ 回到内容层重新生成该 Part；「调整」→ 局部修改重确认。

package/skills/multi/soke-ai-coach-director/platform/publish-gate.md

@@ -0,0 +1,44 @@
+# 发布闸门（publish-gate）
+
+> 内部规则文件。负责在发布前统一做结构验收、资源验收和平台限制说明。
+
+## 发布前检查清单
+
+### 结构验收
+- Part1 基础字段存在：`name/description/tags/key_points/scene_lang/scenario_cover`
+- Part2 角色回读正常：无 `角色数据异常`
+- Part4 评分配置存在：`scoring_criteria_config.criteria_data.dimensions` 非空
+- Part5 固定配置有效
+
+### 资源验收
+- `scenario_cover` 等于固定默认图 `https://newsokeeditorcdn.soke.cn/public/ai/cover/lingshou_daogou.png`
+- 每个角色 `avatar` 非空 URL
+- 每个角色 `voice_id` 非空 ID
+
+### 平台限制说明
+- 若 `conversation_steps` 回读为空，标记：`需后台手动补录流程步骤`
+- 该项默认不阻断发布，但必须进入最终交付摘要
+
+## 阻断规则
+
+以下情况任一成立，禁止发布：
+- 固定默认封面缺失或不正确
+- 任一角色头像为空
+- 任一角色声音为空
+- 任一角色回读为 `角色数据异常`
+- 评分标准为空
+
+## 输出要求
+
+### 可发布
+输出：
+- `publish_ready = true`
+- 可执行 `soke-cli ai-training +publish-scenario`
+
+### 不可发布
+输出缺口清单，例如：
+- 固定默认封面缺失或不正确
+- 角色何女士缺少 voice_id
+- 角色陆先生缺少 avatar
+
+并停止发布。

package/skills/multi/soke-ai-coach-director/platform/resource-finalizer.md

@@ -0,0 +1,103 @@
+# 资源完善器（resource-finalizer）
+
+> 内部规则文件。作为**最后兜底补救**，仅在 Part1/Part2 的主流程未能写入固定封面/头像/声音时触发。
+> 正常流程下，封面在 Part1 固定写入默认图、头像和声音在 Part2 与角色一起写入，不需要进入本模块。
+> 本模块默认后台执行，除非修复失败，不向用户暴露执行细节。
+> ⚠️ 封面与图片资源均为后台资源，不得在前台展示图片预览，不得主动输出本地图片路径。只有用户明确要求查看/预览/导出图片时，才可提供路径或展示。
+
+## 目标
+
+避免以下半成品状态进入发布：
+- `scenario_cover` 为空或不是固定默认封面
+- 任一角色 `avatar` 为空
+- 任一角色 `voice_id` 为空
+
+## 执行时机
+
+仅在发布闸门检测到资源缺口，且无法通过主流程自动补齐时触发。正常流程默认不进入本模块。
+
+```
+Part1-Part5 主体完成
+  → resource-finalizer
+    → cover check / fix
+    → avatar check / fix
+    → voice check / fix
+    → resource gate
+  → 通过后才允许 publish
+```
+
+## 资源闸门
+
+### Cover Gate
+以下任一情况判定为未完成：
+- `scenario_cover` 为空
+- `scenario_cover` 为 `null`
+- `scenario_cover` 不等于 `https://newsokeeditorcdn.soke.cn/public/ai/cover/lingshou_daogou.png`
+
+### Avatar Gate
+对每个角色检查：
+- `role_data.avatar` 必须为非空 URL（以 `http` 开头）
+
+### Voice Gate
+对每个角色检查：
+- `role_data.voice_id` 必须为非空 ID
+
+### Role Integrity Gate
+对每个角色检查：
+- `role_data.name` 不能等于 `角色数据异常`
+- `role_data.background` 非空
+
+## 封面补齐规则
+
+### 标准流程
+1. 检查 `scenario_cover` 是否为固定默认图或为空
+2. 若是，按以下优先级补齐：
+
+**唯一规则：默认固定封面回填**
+- 默认使用：`https://newsokeeditorcdn.soke.cn/public/ai/cover/lingshou_daogou.png`
+- 直接用 `update_basic.scenario_cover` 回填该真实 URL
+- `get-scenario` 验证不再为空且为该固定封面
+若固定默认封面回填后仍失败：
+- 标注 `cover_pending`
+- 禁止发布
+
+### 失败处理
+- 固定默认封面回填失败 → 标注 `cover_pending`，禁止发布
+
+## 头像补齐规则
+
+### 标准流程
+1. 对每个角色检查 `avatar`
+2. 若为空，按 `../references/role-resource-matching.md` 查询头像库并匹配
+3. 用 `patch_ai_role` 回填 `avatar`
+4. `get-scenario` 验证头像非空 URL
+
+### 失败处理
+- 查询失败或回填失败 → 标注 `avatar_pending`，禁止发布
+
+## 语音补齐规则
+
+### 标准流程
+1. 对每个角色检查 `voice_id`
+2. 若为空，按 `../references/role-resource-matching.md` 查询语音库并匹配
+3. 用 `patch_ai_role` 回填 `voice_id`
+4. `get-scenario` 验证语音非空
+
+### 失败处理
+- 查询失败或回填失败 → 标注 `voice_pending`，禁止发布
+
+## 默认回填策略
+
+- 头像和语音允许逐个角色回填
+- 若资源库查询结果不足，可使用保守默认资源
+- **宁可回填一套保守默认资源，也不要留空进入发布**
+
+## 发布前最终判定
+
+只有以下全部满足时，才允许执行 `+publish-scenario`：
+- 封面为固定默认图
+- 所有角色头像非空 URL
+- 所有角色声音非空 ID
+- 无“角色数据异常”
+
+否则输出缺口清单并停止在发布前。