@sokeai/cli 1.0.77 → 1.0.78

package/skills/multi/soke-ai-coach-director/README.md

@@ -0,0 +1,121 @@
+# soke-ai-coach-director
+
+> 授客 AI 陪练场景创建与微调技能包 · v2.43.1
+
+## 这是什么
+
+面向授客 AI 平台的陪练场景全流程技能包，覆盖从客户材料到场景上线全链路：
+
+- **创建型**：PDF/Word/Excel 等非结构化材料 → 提炼 → Part1-5 五段式生成 → 平台同步 → 发布
+- **微调型**：已有陪练提示词 → 诊断（F/I/O/L/E/S/R/K/T/D 十标签）→ 优化改稿 → 复测方案
+- **技术排障**：ASR/TTS/权限/跳转等平台问题分流处理
+
+适用对象：AI 陪练运营人员、场景设计师、技术对接人员。
+
+## 环境依赖
+
+| 依赖 | 最低版本 | 用途 |
+|------|----------|------|
+| Node.js | v22+ | 运行时 |
+| Python 3 | 3.10+ | 脚本执行（validate_operations.py 等） |
+| soke-cli | 1.0.76+ | 平台 CLI（场景创建/同步/发布） |
+| pdftotext | 系统自带 | PDF 材料文本提取 |
+
+### soke-cli 安装与登录
+
+```bash
+# 安装（如平台已提供安装包，按平台指引安装）
+soke-cli --version  # 确认安装成功
+
+# 登录（必须人工执行，无法自动化）
+soke-cli auth login
+```
+
+> ⚠️ `auth login` 需要用户在浏览器中手动授权，这是平台安全设计，不可跳过。详见 `references/env-check.md`。
+
+## 快速上手
+
+### 创建一个新陪练
+
+1. **准备材料**：客户提供的 PDF/Word/Excel/URL 等非结构化材料
+2. **发起请求**：在 OpenClaw 对话中说「帮我搭建一个 [行业] [场景] AI 陪练」
+3. **跟随流程**：技能包会自动执行 Step 0-10 管线，你只需在确认闸门做决策
+
+```
+Step 0    平台就绪检测        🔇 后台
+Step 0.5  材料格式分流         🔇 后台
+Step 1    材料完整性检查       📺 仅缺口
+Step 2    场景类型判定         📺 前台确认
+Step 3    链路需求判定         📺 前台判定
+Step 4    7项清单确认          📺 仅 ⚠️ 项
+Step 5    Part1-3 逐段生成     📺 摘要+弹窗确认（Part4+5 合并一个弹窗，v2.43）
+Step 6    平台同步验证         🔇 后台（get 结果仅 gate_check.py 读取）
+Step 7    质量闸门(精简)     🔇 后台（gate_check.py 单行输出 PASS/FAIL）
+Step 8    发布闸门(资源)       🔇 后台（同一脚本内含资源校验）
+Step 9    场景发布            🔇 后台
+Step 10   知识包绑定           📺 弹窗询问（条目用预生成 kb-entries.json）
+```
+
+### 微调一个已有陪练
+
+1. **准备材料**：当前提示词原文 + 对话样本 + 反馈
+2. **发起请求**：「帮我微调 [陪练名称]」
+3. **诊断输出**：自动匹配标签 → 优化改稿 → 复测方案
+
+## 目录结构
+
+```
+soke-ai-coach-director/
+├── SKILL.md                      # 技能入口（调度表+管线总览）
+├── README.md                     # 本文件
+├── CHANGELOG.md                 # 变更日志
+├── assets/                       # 模板文件
+├── coaching/                    # 子技能
+│   ├── knowledge-packager/      # 材料提炼
+│   ├── prompt-engineer/         # Part1-5 生成
+│   ├── prompt-optimizer/         # 微调诊断
+│   └── role-profiler/           # 按需角色画像
+├── platform/                    # 平台层
+│   ├── sync-engine.md           # 字段参考手册
+│   ├── interaction.md           # 弹窗交互规则
+│   ├── api-fallback.md          # REST API 降级
+│   ├── resource-finalizer.md    # 资源回填
+│   ├── publish-gate.md          # 发布闸门
+│   ├── adapters/                # 跨平台适配器
+│   └── soke-ai-training/        # 知识包同步
+├── references/                  # 参考规则
+│   ├── exec-handbook.md         # 唯一执行事实源
+│   ├── env-check.md             # 环境检测协议
+│   ├── verified-cli-cheatsheet.md # CLI 速查
+│   ├── role-resource-matching.md  # 资源匹配规则
+│   ├── platform-api-pitfalls.md   # 平台 API 陷阱
+│   ├── gate-check-matrix.md     # 闸门矩阵
+│   ├── micro-tune-labels.md    # 微调标签
+│   ├── self-learning-engine.md # 自主学习
+│   ├── cases/                   # 案例库
+│   └── subs/                    # 分段 SOP
+└── scripts/                     # 工具脚本
+    ├── validate_operations.py
+    └── gate_check.py
+```
+
+## 关键规则速查
+
+- **创建型管线锁**：Step 0→10 严格串行，禁止跳步
+- **Part2 同步策略**：整包 `replace_ai_roles` 优先，失败降级逐个
+- **JSON 硬规则**：string 字段禁写数组；number 不加引号；boolean 不加引号；null 写 null 不写 ""
+- **头像库**：前缀 `https://newsokeeditorcdn.soke.cn/public/ai/roles_avatars/`
+- **Part5 固定配置**：6 项写死值，禁止按场景调整（v2.43.1 起规则并入 exec-part4.md，exec-part5.md 已删除）
+- **积分优化（v2.43.1）**：交付后不写日志 / get 回读零上下文（gate_check.py 专读）/ 知识包条目预生成 / Part4+5 合并应用 / 加载顺序清单 / 材料预过滤+限流
+- **交付边界**：平台同步+发布+知识包绑定完成后直接结束，不写技能日志（仅用户明确要求维护时才写）
+
+> 完整执行规则见 `references/exec-partN.md`（按 Part 加载）+ `references/exec-common.md`（通用约束）。
+
+## 版本
+
+- **当前版本**：v2.43.1（2026-08-19）
+- **变更日志**：`CHANGELOG.md`
+
+## 反馈
+
+问题或建议请通过 OpenClaw 对话反馈。

package/skills/multi/soke-ai-coach-director/SKILL.md

@@ -0,0 +1,220 @@
+---
+name: soke-ai-coach-director
+description: 授客AI平台同步技能。统一调度入口,自动分析意图、检查输入完整性、调度专项技能并执行质量闸门。覆盖创建陪练、微调陪练、技术排障、客户交付与平台同步。
+---
+
+# 授客AI平台同步技能
+
+## 版本
+v2.43.1 — 交付后不写日志 / get 回读零上下文 / 知识包条目预生成 / Part4+5 合并应用（exec-part5.md 已删除，规则并入 exec-part4.md）/ sed 输出限流 / 工具化闸门（gate_check.py）/ OS 结构内联 / 材料 sed 单命令 / 积分目标 ≤75（内容生成为不可压地板 ~49）/ 弹窗仅做确认（question ≤2 行）/ 加载顺序清单 / CLI 全静默重定向 / apply 禁止用于验证 / 提炼稿一次成型 / 知识包复用提炼稿
+
+## 🔇 前台/后台输出边界（全局规则）
+
+前台可见：意图识别（≤5行）/ 决策确认 / 材料缺口 / ⚠️ 项清单 / **Part 关键字段摘要（在聊天正文中展示）** / 确认弹窗（仅做确认/调整选择，question 字段 ≤2 行引导语） / 失败通知 / 完成摘要。
+后台静默：环境检测 / 材料提炼 / JSON 操作 / CLI 命令 / preview/apply 输出 / 回读验证 / 资源匹配 / 同步中间状态 / 质量闸门 / 发布细节 / 知识包调试。
+
+**执行层强制规则**：后台 CLI/Python 输出仅内部决策用，严禁原文回显；后台成功确认、print() 输出、JSON 大小、snapshot_id/updated_at/warnings 一律吞掉。仅失败、回读不一致、资源匹配失败、完成摘要时才提及后台结果。平台同步完成后直接结束，除非用户明确要求维护技能，不再写入技能文件或运行日志。
+
+**v2.38 弹窗与正文分工规则（v2.41 强化：摘要化展示）**：
+- **聊天正文**展示 Part **关键字段摘要**（非完整 JSON 全文）——Part1 展示场景名/描述前 50 字/标签/考核点；Part2 展示角色名+画像关键词（非完整 background 全文）；Part3 展示环节名+目标（非完整 ai_task 全文）；Part4 展示维度名+权重（非完整 scoring_rule 全文）；Part5 展示固定值确认。**完整 JSON 直接 Write 落盘到 /tmp/，不经过对话上下文**。
+- **AskUserQuestion 弹窗**仅做确认/调整选择——`question` 字段只写 ≤2 行引导语，`options` 只放「确认」「需要调整」等选择项。
+- 弹窗 options 的 description 字段可放 ≤15 字摘要。
+- 聊天正文 Part 摘要展示后，紧接弹窗确认；用户确认后仅输出 `PartN ✅`，不重述内容。
+
+**省积分执行约定（v2.41 五次强化，目标 ≤60 积分）**：
+1. 生成 JSON 用 Write 工具直接落盘，或 Python `json.dump` **静默写**（成功不 print、不跑冗长断言脚本）；断言用最小 Python 表达式，失败才报错。
+2. `+get-scenario` 回读一律 `> /tmp/xxx.json` 重定向，再用 Python 只打印关键字段布尔判断，**不打印完整 JSON**。
+3. preview/apply 输出强制 `2>/dev/null | tail -3`，只看结尾状态行，**不回显 operations/warnings/snapshot_id/updated_at**。
+4. 每个 Part 只做 1 次 preview + 1 次 apply + 1 次回读，不重复验证；乐观锁统一在 apply 前取一次最新 `updated_at`。
+5. 执行期避免重复 Read 已在上下文中的文件（SKILL.md / exec-handbook / 各 SOP 加载一次即可复用）。
+6. **PartN ✅ 确认后静默（v2.35）**：用户弹窗确认 Part 后，前台仅输出 `PartN ✅`，**禁止重述** Part 正文内容、snapshot_id/updated_at/warnings、回读验证结果、资源匹配结果。直接进入下一 Part 的完整展示。
+7. **材料预处理只喂提炼稿（v2.35）**：非结构化材料（PDF/DOCX/PPT）经 knowledge-packager 提炼为 Markdown 稿后，**原始材料全文不再进入后续 Part 上下文**。后续 Part1-5 生成只读提炼稿，不重复读原始 PDF/DOCX。提炼稿只保留 Part1-5 所需结构化要素（业务背景/训练对象/话术/画像线索/异议/红线/评分线索），删除无关段落。
+8. **材料提炼稿字数硬上限（v2.36）**：knowledge-packager 提炼稿 **≤1500 字**（硬上限，超了二次压缩只保留核心要素）。原始 PDF/DOCX 只允许 `pdftotext` 提取到 `/tmp/` 后 **grep 关键词定位关键段落**（如 `grep -C 2 "升舱"`），严禁把全文 Read/Grep 进上下文；提炼稿产出后原始文件一律不再碰。
+9. **弹窗合并（v2.36）**：前置确认（场景范围 + 旅客角色数）合并为 **1 个弹窗**；发布确认（模板8）+ 知识包确认（模板7）合并为 **1 个弹窗**（两个问题同框）。逐 Part 的模板 1-5 确认保持独立（确认契约不可合并）。
+10. **get-scenario 全流程仅回读 2 次（v2.36）**：① Part1 创建后（只 Python 打印 `id`/`name`/`key_points` 布尔判断）；② 发布闸门前（一次性取全量做闸门校验）。中间 Part2-5 的 apply 返回只 Python 打印 True/False，**不回显 snapshot_id/updated_at/warnings，不额外 get**。
+11. **闸门批量校验（v2.36）**：Step 7 质量闸门 12 项 + Step 8 发布闸门 4 项，合并为**一次** `+get-scenario` + 一个 Python 布尔判断脚本（16 个断言单行输出），不分批、不逐项 get。
+12. **CLI 全静默重定向（v2.37 新增）**：所有 soke-cli 命令输出一律 `> /tmp/xxx.json 2>/dev/null`，**禁止 `--pretty` 直出到对话**（create-scenario / list-role-avatars / list-role-voices / apply / get / publish / sync 全部重定向）。Python 只从重定向文件提取需要的字段（scenario_id / updated_at / avatar URL / voice_id），**不回显 JSON 原文**。
+13. **apply 禁止用于验证（v2.37 新增）**：apply 是写入操作，不是读取操作。验证数据用 `+get-scenario`，**禁止用 apply 回读环节**（会导致 add_conversation_step 重复添加 → 需快照回滚 → 浪费 3-5 积分）。apply 后只从返回值提取 `updated_at`（`tail -1` 或 Python 提取），不回显 operations/snapshot_id。
+14. **材料提炼稿一次成型（v2.37 新增）**：pdftotext 提取后，**一次性**用 grep 定位 + sed 读取关键段落 + Write 落盘提炼稿到 `/tmp/xxx_refined.md`，**禁止分多轮 sed 回看**（每轮 sed 回看消耗 1-2 积分）。提炼稿落盘后，后续 Part1-5 只 Read 这一个文件。
+15. **资产库瘦身（v2.37 新增）**：创建型任务**只读** `AI陪练场景分类库.md`（Step2 判定用）+ `exec-handbook.md`（Part1-5 模板用）。`AI陪练提示词模块库.md` / `AI陪练评分标准组件库.md` / `AI陪练客户材料清单与访谈题库.md` **不在创建型加载**（exec-handbook 已含完整模板和断言，模块库/组件库是微调型才用的参考素材）。标杆案例**不加载**（除非用户明确要求参考）。
+16. **知识包复用提炼稿（v2.37 新增）**：知识包 Markdown source 直接复用材料提炼稿（`/tmp/xxx_refined.md`），**禁止从零重写**（内容已在上下文中，重写浪费 3-5 积分）。只需按知识包 entries 格式拆条目。
+17. **闸门精简（v2.39）**：Part 自检通过后，闸门仅补查 3 项（非 Part 自检覆盖项），断言从 16→7。详见 `gate-check-matrix.md`。
+18. **文件读取预算（v2.39）**：全流程技能文件读取 ≤8 次。state-snapshot.json 记录 `file_reads` 计数器，超限触发警告。首次加载 5 次（SKILL+exec-handbook+gate-matrix+当前Part SOP+当前Part框架），后续每 Part +1 次。
+19. **CLI 命令内联（v2.40 新增）**：高频 CLI 命令格式直接内联到下方「CLI 速查」表，**禁止为查命令格式而 Read `verified-cli-cheatsheet.md`**（该文件仅在命令失败排障时读）。
+20. **禁止标杆案例查找（v2.40 新增）**：创建型任务**不搜索、不加载标杆案例**（exec-handbook 已含完整模板，标杆案例是微调型参考素材）。
+21. **Part3 回读限制（v2.40 新增）**：Part3 apply 后只做 1 次布尔断言（`python3 -c "import json;d=json.load(open('/tmp/p3.json'));print(bool(d.get('operations')))"`），**禁止多次 get-scenario 回读调查**（已知 CLI bug 导致 applied=false，不影响最终发布）。
+22. **exec-handbook 按 Part 拆分加载（v2.41 新增）**：原 exec-handbook.md（26KB）拆为 5 个文件 `references/exec-partN.md`（各 ~5KB）。**每个 Part 只加载对应的 exec-partN.md**，不再一次性加载全部 5 个 Part 模板。通用约束（CLI 参数/材料铁律/字段类型硬规则）提取到 `references/exec-common.md`（~4KB），首次加载 1 次。总加载量从 26KB 降至 ~9KB（当前 Part 5KB + common 4KB）。
+23. **Part 展示摘要化（v2.41 新增）**：聊天正文只展示 Part **关键字段摘要**（场景名/角色名+关键词/环节名+目标/维度名+权重/固定值确认），**完整 JSON 直接 Write 落盘到 /tmp/partN.json**，不经过对话上下文。中文 token 密度降低 ~60%。
+24. **材料预过滤（v2.41 新增）**：pdftotext 前先看文件名/标题，**只对与场景直接相关的材料做提取**。无关材料（如升舱场景中的「特殊旅客运输」「不正常航班处置」）跳过 pdftotext+grep，直接标注「已跳过：与场景无关」。
+25. **apply --reason 内联（v2.41 新增）**：apply 命令必须带 `--reason "PartN 同步"`，格式内联到 CLI 速查表。**禁止省略 --reason 参数**（会导致 422 重试浪费 3-5 积分）。
+26. **CLI 合并调用（v2.41 新增）**：Part2 头像+语音列表合并为 1 次 Bash 调用（`soke-cli +list-role-avatars ... & soke-cli +list-role-voices ... & wait`），省 1 次独立调用。
+27. **闸门工具化（v2.42 新增，针对 79.64 实测最大超支点 ~8 分）**：Step 7+8 闸门校验**只跑一个脚本**：`python3 scripts/gate_check.py /tmp/scenario_get.json`，输出 `GATE PASS` 或 `GATE FAIL`+逐项原因。**禁止再用 Python 逐步探查 get-scenario 返回结构**（看结构→看 data 字段→定位字段→查状态——历史实测 8 轮探查浪费 ~8 积分）。脚本已内置 {data:{...}} 嵌套解包、Part3 steps 空值告警（已知 CLI 限制不阻塞）、Part4 权重校验。
+28. **材料 sed 单命令（v2.42 新增，针对实测 ~4.5 分超支）**：提炼稿只允许**一个 sed 命令**读取全部关键段落——用 `sed -n '/值机话术/,/^$/p; /升舱产品/,/^$/p; /公示/p' 手册.txt > /tmp/key_sections.txt` 一次抓完，再 Read 这一个文件写提炼稿。**禁止分多轮 sed 逐段读**（历史实测 4 轮 sed 浪费 ~4.5 积分）。
+29. **OS 结构内联（v2.42 新增，消除被迫读取）**：A1-A7 OS 写作结构已内联到 `exec-part2.md`。**禁止为写 OS 去读 `coaching/prompt-engineer/parts/part2-roles.md`**（该文件已列入禁止加载清单）。
+30. **apply 后零校验（v2.42 新增，针对实测 ~3.6 分超支）**：apply/publish/sync/bind 成功后**只提取状态行**（`tail -3` 已含），**禁止再做任何额外校验**（Part2/Part3 后不再查角色数据、发布后不再 get 复核）。验证统一收敛到闸门阶段的 gate_check.py 一次完成。
+31. **交付后不写技能日志（v2.43 新增）**：创建型任务在平台同步、发布和知识包绑定成功后，直接输出完成摘要并结束。**禁止自动编辑 SKILL.md、CHANGELOG.md、README.md 或项目工作日志**；禁止为记录本次运行新增学习条目。只有用户明确提出“更新技能/记录经验/维护日志”时，才进入维护流程。`state-snapshot.json` 仅保留断点恢复所需状态，不属于日志写入。
+32. **get 回读零上下文（v2.43 新增，针对实测 Step6-8 花 7.40 偏高）**：`/tmp/scenario_get.json` **只允许 gate_check.py 脚本读取**，AI 禁止 Read/head/tail/cat 该文件或把其内容引入上下文（10-20KB JSON 进一次上下文 ≈ 3-4 积分）。闸门结果只看 gate_check.py 的单行输出 `GATE PASS`/`GATE FAIL`。关键字段核对已由脚本完成（头像/语音/OS 长度/权重和），**禁止再人工逐项复核一遍**（双份工作）。
+33. **知识包条目预生成（v2.43 新增，针对 Step10 花 13.07 偏高）**：Step 0.5 写提炼稿时**同步产出** `/tmp/kb-entries.json`（提炼稿的每个知识块一条 entry：产品权益/话术/流程/红线各拆一条）。Step 10 只剩 `+sync` + `+bind` 两个 CLI 调用，**禁止到 Step 10 才从提炼稿重新推导拆条**（内容同源，二次推导浪费 2-3 积分）。
+34. **Part4+Part5 合并应用（v2.43 新增，展示规则修正）**：Part5 固定配置**不再单独弹窗**，但**聊天正文必须完整展示 Part4 + Part5 两段内容**——Part4 展示维度名+权重+一票否决，紧接 Part5 完整展示 6 项固定配置（1.练习时长不限 2.最大10次 3.通关60分 4.全环节完成 5.AI辅助开启 6.难度2），用编号列表。弹窗引导语：`以上是 Part4 评分标准 + Part5 教练配置（6 项固定值），是否确认写入？`。确认后输出 `Part4 ✅ Part5 ✅`，两个 operation 合并一批 apply（省 1 弹窗 + 1 apply）。**禁止把 Part5 压缩成一行摘要省略展示**。v2.43.1：exec-part5.md 已删除，Part5 全部规则（固定值禁调整/不同步收尾话术等）并入 exec-part4.md。
+35. **材料 sed 输出限流（v2.43 新增）**：sed 抓取关键段落后接 `| head -c 6000`，防止命中文段过长（如 1.1 万行手册中关键词密集段一次抓出几万字），控制进入上下文的体积。
+
+---
+
+## 技能定位
+
+统一调度入口：意图识别 → 输入完整性检查 → 资产库选择 → 调度专项技能 → 质量闸门 → 平台同步。
+执行规则按 Part 粒度加载：`references/exec-partN.md`（当前 Part 的 JSON 模板/断言/字段硬规则）+ `references/exec-common.md`（通用约束）。
+
+---
+
+## 调度技能清单
+
+| 技能 | 功能 | 路径 |
+|------|------|------|
+| `prompt-engineer` | Part1-5 生成 + 一致性校验 | `coaching/prompt-engineer/prompt-engineer.md` |
+| `role-profiler` | 可选增强：复杂资料按需画像 | `coaching/role-profiler/role-profiler.md` |
+| `prompt-optimizer` | 微调诊断 → 四段式报告 | `coaching/prompt-optimizer/prompt-optimizer.md` |
+| `interaction` | 弹窗交互规则 | `platform/interaction.md` |
+| `publish-gate` | 发布前资源验收 | `platform/publish-gate.md` |
+| `soke-ai-training` | 知识包同步 | `platform/soke-ai-training/soke-ai-training.md` |
+
+参考：`exec-partN.md`（按 Part 加载的模板/断言）/ `exec-common.md`（通用约束）/ `env-check`（环境检测）/ `role-resource-matching`（资源匹配）/ `platform-api-pitfalls`（致命陷阱）/ `gate-check-matrix`（闸门）/ `verified-cli-cheatsheet`（命令速查，排障时读）/ `micro-tune-labels`（微调标签）/ `api-fallback`（REST 降级）。
+
+---
+
+## 标准任务类型
+
+1. **创建型**：搭建新陪练。→ 严格顺序管线 Step 0→10，🔒 不得跳步。
+2. **微调型**：优化已有提示词。→ prompt-optimizer，走 G9 改动清单闸门。
+3. **技术排障型**：ASR/TTS/权限/跳转/录音/部署等。禁止改提示词。
+4. **客户交付/复盘型**：培训包/看板/数据/复盘。纯流程型。
+5. **平台同步型**：知识包/提示词同步。
+
+---
+
+## 资产调用规则（分步按需加载，禁全量预读）
+
+路径 `references/cases/`。仅到达对应管线阶段才读取，未读文件零消耗：
+
+| 阶段 | 读取 | v2.37 变更 |
+|------|------|------|
+| Step 2 场景判定 | `AI陪练场景分类库.md` | ✅ 保留（判定必需） |
+| Part1-5 生成 | `exec-partN.md`（当前 Part）+ `exec-common.md` | ✅ v2.41 拆分加载，只读当前 Part 模板 |
+| Step 1 材料检查 | ~~`AI陪练客户材料清单与访谈题库.md`~~ | ❌ 不加载（材料检查靠提炼稿+业务常识） |
+| Part2 生成前 | ~~`AI陪练提示词模块库.md`~~ | ❌ 不加载（exec-handbook 已含 Part2 完整模板） |
+| Part4 生成前 | ~~`AI陪练评分标准组件库.md`~~ | ❌ 不加载（exec-handbook 已含 Part4 完整模板） |
+| 测试阶段 | `AI陪练测试用例库.md` | 仅用户要求测试时加载 |
+
+标杆案例（`cases/create/`）**v2.37 起默认不加载**（除非用户明确要求参考）。微调型必读：微调问题库 / Bad Case 样本库 / 技术边界排障库。
+
+---
+
+## 加载顺序清单（v2.41.1 新增，结构性约束替代声明性规则）
+
+> **按此清单执行，禁止自行判断"要不要多读一个文件求稳"。每步只读清单中列出的文件，不读其他。**
+
+| Step | 读取文件 | 次数 |
+|------|---------|------|
+| Step 0 环境检测 | SKILL.md（已在上下文）+ env-check.md | 1 |
+| Step 0.5 材料提炼 | 无（pdftotext/grep/sed/Write 操作） | 0 |
+| Step 1-4 意图+确认 | AI陪练场景分类库.md（Step 2 判定用） | 1 |
+| Part1 生成 | exec-common.md + exec-part1.md | 2 |
+| Part1 创建后 | 无（CLI 操作） | 0 |
+| Part2 生成 | exec-part2.md（common 已在上下文） | 1 |
+| Part2 同步 | 无（CLI 操作） | 0 |
+| Part3 生成 | exec-part3.md | 1 |
+| Part3 同步 | 无 | 0 |
+| Part4+5 生成（v2.43 合并） | exec-part4.md（已含 Part5 全部规则，v2.43.1 删除 exec-part5.md） | 1 |
+| Part4+5 同步 | 无（一批 apply） | 0 |
+| Step 6-8 闸门 | 跑 `scripts/gate_check.py`（gate-check-matrix.md 可选） | 1 |
+| Step 9 发布 | 无 | 0 |
+| Step 10 知识包 | soke-ai-training.md（仅首次；条目用预生成 kb-entries.json） | 1 |
+| **合计** | | **≤9** |
+
+**禁止加载的文件**（创建型任务）：
+- ❌ `verified-cli-cheatsheet.md`（CLI 速查已内联 SKILL.md，排障时才读）
+- ❌ `platform-api-pitfalls.md`（排障时才读）
+- ❌ `sync-engine.md`（字段参考手册，exec-common 已含通用约束）
+- ❌ `interaction.md`（弹窗规则已内联 SKILL.md）
+- ❌ `publish-gate.md`（闸门规则已内联 gate-check-matrix）
+- ❌ `role-resource-matching.md`（头像/语音匹配规则已内联 exec-part2）
+- ❌ `coaching/prompt-engineer/parts/partN-*.md`（内容框架已内联 exec-partN）
+- ❌ `references/subs/partN/SOP.md`（自检清单已内联 exec-partN）
+- ❌ 所有 `cases/` 下的文件（标杆案例不加载）
+- ❌ `exec-part5.md`（v2.43.1 已删除——Part5 规则并入 exec-part4.md，若发现此文件说明是旧版残留）
+
+> ⚠️ 如果执行中发现需要某个禁止加载的文件，说明 exec-partN.md 或 exec-common.md 缺少必要信息，应**补全 exec 文件**而非临时读取禁止文件。
+
+---
+
+## CLI 速查（v2.41 内联，禁止为查格式而 Read cheatsheet 文件）
+
+| 命令 | 格式 | 重定向 |
+|------|------|--------|
+| 创建场景 | `soke-cli ai-training +create-scenario --request-file /tmp/part1.json --output /tmp/p1.json` | `> /tmp/p1.json 2>/dev/null` |
+| 列头像+语音 | `soke-cli ai-training +list-role-avatars --lang zh --show-detail --output /tmp/avatars.json & soke-cli ai-training +list-role-voices --lang zh --output /tmp/voices.json & wait` | `> /tmp/res.json 2>/dev/null` |
+| 应用 Part | `soke-cli ai-training +apply-scenario-update --scenario-id <id> --operations-file /tmp/partN.json --base-updated-at <ts> --idempotency-key "cli-<short>-partN-apply" --reason "PartN同步" --output /tmp/partN_apply.json` | `2>/dev/null` |
+| 回读场景 | `soke-cli ai-training +get-scenario --scenario-id <id> --raw --output /tmp/scenario_get.json` | `> /tmp/scenario.json 2>/dev/null` |
+| 发布 | `soke-cli ai-training +publish-scenario --scenario-id <id> --version 1 --version-description "CLI发布" --output /tmp/publish.json` | `2>/dev/null` |
+| 知识包同步 | `soke-cli ai-training +sync --manifest /tmp/manifest.json --idempotency-key "cli-<pkg>-sync" --format json` | `> /tmp/kb_sync.json 2>/dev/null`（⚠️ 不支持 --output） |
+| 知识包绑定 | `soke-cli ai-training +bind-scenario --scenario-id <sid> --version-ids <vid> --compile-plan --format json` | `> /tmp/kb_bind.json 2>/dev/null` |
+
+> ⚠️ 所有命令必须带 `ai-training`（`soke-cli ai-training +...`）；apply 命令是 `+apply-scenario-update`（非 `+apply-scenario`）；bind 用 `--version-ids`（非 `--package-id`）；`+sync` 不支持 `--output`，用 `--format json` + shell 重定向。
+
+**排障时才读** `verified-cli-cheatsheet.md`（命令失败/参数不确定/重定向规则不明时）。
+
+---
+
+## 创建型任务流程（严格顺序管线）
+
+```
+Step 0   平台就绪检测   🔇 env-check.md：node≥14 → soke-cli → token → corp_id，全过才继续
+Step 0.5 材料格式分流   🔇 预过滤 → 相关材料 pdftotext → sed 单命令抓段（`| head -c 6000` 限流，v2.43）→ **一次成型**写提炼稿 /tmp/xxx_refined.md（≤1500 字）+ **同步预生成** /tmp/kb-entries.json（知识包条目，v2.43）
+Step 1   材料完整性检查 📺 齐全通过 / 不足列缺口（只读提炼稿，不读原始 PDF/DOCX）
+Step 2   场景类型判定   📺 读场景分类库，判定结果给用户确认
+Step 3   链路需求判定   📺 简洁→标准链路；复杂→role-profiler 完整链路
+Step 4   7项清单确认    📺 全✅则问是否生成 Part1；有⚠️列缺口
+Step 5   逐 Part 生成    📺 Part1-3 各自摘要展示+弹窗；Part4+5 同一段正文**完整展示两段**（Part4 维度权重 + Part5 六项固定配置编号列表）+ 1 个弹窗，确认后 `Part4 ✅ Part5 ✅` 两 operation 合一批 apply（v2.43）→ 🔇 同步静默
+Step 6   平台同步验证    🔇 get-scenario 重定向落盘（该 JSON 只允许 gate_check.py 读取，AI 零上下文接触，v2.43）
+Step 7   质量闸门(精简)  🔇 跑 `scripts/gate_check.py /tmp/scenario_get.json`，只看单行输出（v2.42：Part 自检通过的 9 项跳过）
+Step 8   发布闸门(资源)  🔇 同一脚本内含 4 项资源校验（头像/语音/封面/OS），GATE PASS 才发布
+Step 8.5 发布确认弹窗    📺 用户确认才发布，不可跳过（与 Step 10 知识包确认合并为 1 个弹窗）
+Step 9   场景发布        🔇 +publish-scenario，成功展示完成摘要
+Step 10  知识打包        📺 是否同步知识包，🚦 强制触发（与 Step 8.5 合并弹窗）→ 直接用 Step 0.5 预生成的 /tmp/kb-entries.json（v2.43，禁止二次推导拆条）→ +sync +bind 后直接完成，不写技能日志
+```
+
+### 关键硬规则（必守）
+
+1. **所有 soke-cli 命令**设 `dangerouslyDisableSandbox: true`（Go 二进制在沙箱受限）。
+2. **Part1 创建链路**：确认后必须 `+create-scenario` → 提取 `scenario_id` → 写 `state-snapshot.json`。scenario_id 未获取禁止展示 Part2。
+3. **弹窗即时触发（v2.30）+ 聊天正文承载摘要（v2.41）**：Part **关键字段摘要**在聊天正文展示（场景名/角色名+关键词/环节名+目标/维度名+权重/固定值确认），**完整 JSON 直接 Write 落盘到 /tmp/partN.json**。展示后紧接 AskUserQuestion 弹窗。弹窗仅做确认/调整选择。
+4. **Part 关键约束**：Part2 整包 `replace_ai_roles`（OS 用 update_basic 单独写）；Part3 开场语+环节同批原子提交；Part4 权重和 100 + shell 字段在 config 顶层；Part5 固定值禁调整。
+5. **发布 + 知识包**：模板 8 发布确认、模板 7 知识包确认均不可静默跳过；两确认合并为 1 个弹窗（两个问题同框，发布确认在前、知识包在后）。
+
+各 Part 的 JSON 模板、字段硬规则、断言、反面案例 → `references/exec-partN.md`（按 Part 加载）+ `references/exec-common.md`（通用约束）。
+
+---
+
+## 微调型任务流程
+
+1. 收集输入包 → 2. 确认分析对象（AI角色 vs 学员）→ 3. 先判技术问题（是则分流）→ 4. F/I/O/L/E/S/R/K/T/D 标签诊断 → 5. 匹配资产库 → 6. prompt-optimizer 出报告 → 7. 🔴 G9 改动清单确认（未过禁生成 JSON/apply）→ 8. 模板6 确认 → 平台同步。
+
+缺失规则：无原始对话→只做结构审查；无提示词→只给优化方向；只有"感觉不像"→追问具体片段。
+
+---
+
+## 技术问题分流
+
+ASR/TTS/权限/跳转/按钮/录音/部署/数据同步 → 按技术处理，禁止改提示词。排障见 `platform-api-pitfalls.md`。
+
+---
+
+## 质量闸门
+
+创建 12 项 / 微调 8 项 → `gate-check-matrix.md`。闸门↔模板映射：G1↔模板1(Part1)、G2↔模板2(Part2)、G3↔模板3(Part3)、G4+G5↔模板4(Part4+5 合并确认，v2.43.1)、G9↔模板9(微调改动清单)。
+
+---
+
+## 输出格式
+
+任务开始先输出 `## 🎯 意图识别`（≤5行）。创建型前台：意图识别 → Step0-4（仅缺口/⚠️）→ 确认闸门 → Part1-5（**关键字段摘要在聊天正文展示**，完整 JSON 落盘 /tmp/ + 弹窗仅做确认）。Part 摘要禁用 Markdown 表格，用编号列表。**确认后仅输出 `PartN ✅`，不重述内容、不回显后台中间状态**，直接进入下一 Part。用户说"直接做"可跳过确认，但不可跳过 Step0-4。

package/skills/multi/soke-ai-coach-director/assets/ERRORS-TEMPLATE.md

@@ -0,0 +1,5 @@
+# Errors Log
+
+Command failures, exceptions, and unexpected behaviors.
+
+---

package/skills/multi/soke-ai-coach-director/assets/FEATURE_REQUESTS-TEMPLATE.md

@@ -0,0 +1,5 @@
+# Feature Requests
+
+Capabilities requested by user that don't currently exist.
+
+---

package/skills/multi/soke-ai-coach-director/assets/LEARNINGS-TEMPLATE.md

@@ -0,0 +1,44 @@
+# Learnings
+
+Corrections, insights, and knowledge gaps captured during development.
+
+**Categories**: correction | insight | knowledge_gap | best_practice
+**Areas**: frontend | backend | infra | tests | docs | config
+**Statuses**: pending | in_progress | resolved | wont_fix | promoted | promoted_to_skill
+
+## Status Definitions
+
+| Status | Meaning |
+|--------|---------|
+| `pending` | Not yet addressed |
+| `in_progress` | Actively being worked on |
+| `resolved` | Issue fixed or knowledge integrated |
+| `wont_fix` | Decided not to address (reason in Resolution) |
+| `promoted_to_skill` | Extracted as a reusable skill |
+
+## Skill Extraction Fields
+
+When a learning is promoted to a skill, add these fields:
+
+```markdown
+**Status**: promoted_to_skill
+**Skill-Path**: skills/skill-name
+```
+
+Example:
+```markdown
+## [LRN-20250115-001] best_practice
+
+**Logged**: 2025-01-15T10:00:00Z
+**Priority**: high
+**Status**: promoted_to_skill
+**Skill-Path**: skills/docker-m1-fixes
+**Area**: infra
+
+### Summary
+Docker build fails on Apple Silicon due to platform mismatch
+...
+```
+
+---
+

package/skills/multi/soke-ai-coach-director/assets/SKILL-TEMPLATE.md

@@ -0,0 +1,177 @@
+# Skill Template
+
+Template for creating skills extracted from learnings. Copy and customize.
+
+---
+
+## SKILL.md Template
+
+```markdown
+---
+name: skill-name-here
+description: "Concise description of when and why to use this skill. Include trigger conditions."
+---
+
+# Skill Name
+
+Brief introduction explaining the problem this skill solves and its origin.
+
+## Quick Reference
+
+| Situation | Action |
+|-----------|--------|
+| [Trigger 1] | [Action 1] |
+| [Trigger 2] | [Action 2] |
+
+## Background
+
+Why this knowledge matters. What problems it prevents. Context from the original learning.
+
+## Solution
+
+### Step-by-Step
+
+1. First step with code or command
+2. Second step
+3. Verification step
+
+### Code Example
+
+\`\`\`language
+// Example code demonstrating the solution
+\`\`\`
+
+## Common Variations
+
+- **Variation A**: Description and how to handle
+- **Variation B**: Description and how to handle
+
+## Gotchas
+
+- Warning or common mistake #1
+- Warning or common mistake #2
+
+## Related
+
+- Link to related documentation
+- Link to related skill
+
+## Source
+
+Extracted from learning entry.
+- **Learning ID**: LRN-YYYYMMDD-XXX
+- **Original Category**: correction | insight | knowledge_gap | best_practice
+- **Extraction Date**: YYYY-MM-DD
+```
+
+---
+
+## Minimal Template
+
+For simple skills that don't need all sections:
+
+```markdown
+---
+name: skill-name-here
+description: "What this skill does and when to use it."
+---
+
+# Skill Name
+
+[Problem statement in one sentence]
+
+## Solution
+
+[Direct solution with code/commands]
+
+## Source
+
+- Learning ID: LRN-YYYYMMDD-XXX
+```
+
+---
+
+## Template with Scripts
+
+For skills that include executable helpers:
+
+```markdown
+---
+name: skill-name-here
+description: "What this skill does and when to use it."
+---
+
+# Skill Name
+
+[Introduction]
+
+## Quick Reference
+
+| Command | Purpose |
+|---------|---------|
+| `./scripts/helper.sh` | [What it does] |
+| `./scripts/validate.sh` | [What it does] |
+
+## Usage
+
+### Automated (Recommended)
+
+\`\`\`bash
+./skills/skill-name/scripts/helper.sh [args]
+\`\`\`
+
+### Manual Steps
+
+1. Step one
+2. Step two
+
+## Scripts
+
+| Script | Description |
+|--------|-------------|
+| `scripts/helper.sh` | Main utility |
+| `scripts/validate.sh` | Validation checker |
+
+## Source
+
+- Learning ID: LRN-YYYYMMDD-XXX
+```
+
+---
+
+## Naming Conventions
+
+- **Skill name**: lowercase, hyphens for spaces
+  - Good: `docker-m1-fixes`, `api-timeout-patterns`
+  - Bad: `Docker_M1_Fixes`, `APITimeoutPatterns`
+
+- **Description**: Start with action verb, mention trigger
+  - Good: "Handles Docker build failures on Apple Silicon. Use when builds fail with platform mismatch."
+  - Bad: "Docker stuff"
+
+- **Files**:
+  - `SKILL.md` - Required, main documentation
+  - `scripts/` - Optional, executable code
+  - `references/` - Optional, detailed docs
+  - `assets/` - Optional, templates
+
+---
+
+## Extraction Checklist
+
+Before creating a skill from a learning:
+
+- [ ] Learning is verified (status: resolved)
+- [ ] Solution is broadly applicable (not one-off)
+- [ ] Content is complete (has all needed context)
+- [ ] Name follows conventions
+- [ ] Description is concise but informative
+- [ ] Quick Reference table is actionable
+- [ ] Code examples are tested
+- [ ] Source learning ID is recorded
+
+After creating:
+
+- [ ] Update original learning with `promoted_to_skill` status
+- [ ] Add `Skill-Path: skills/skill-name` to learning metadata
+- [ ] Test skill by reading it in a fresh session