@sokeai/cli 1.0.76 → 1.0.78

package/skills/mono/references/modules/soke-ai-coach-director/coaching/knowledge-packager/knowledge-packager.md

@@ -0,0 +1,91 @@
+# knowledge-packager
+
+## 定位
+
+用于 AI 陪练创建链路中的资料预处理与发布后可选知识包打包。
+
+## 两种模式
+
+### A. 创建前资料提炼模式（默认）
+
+触发条件：用户提供的业务资料包含任一非结构化格式，例如 PPT、PDF、图片、音视频、扫描件、长文档混排等。若资料组合为“Markdown + 非结构化附件”，也必须触发本模式。
+
+目标：将非结构化资料本地提炼为 Markdown 材料稿，作为 Step1-Step7 完整创建管线的输入。
+
+硬约束：
+- 只做本地提炼，不执行平台同步。
+- 不调用 `soke-cli ai-training +sync`。
+- 不调用 `soke-cli ai-training +bind-scenario`。
+- 不创建知识包 ID。
+- 不把提炼稿当成已同步知识库。
+- 提炼稿必须保留来源事实、业务术语、产品规则、话术、禁忌红线和评分线索。
+- 当 Markdown 与非结构化资料同时存在时，必须合并提炼：Markdown 作为基础材料，非结构化附件作为补充证据和扩展材料，最终产出一份统一 Markdown 稿。
+- 信息不足时输出缺口，不得凭空补全。
+- **v2.35 反压缩铁律**：提炼完成后，原始 PDF/DOCX/PPT 全文**不再进入后续 Part 上下文**。Part1-5 生成只读提炼稿。提炼稿只保留 Part1-5 所需结构化要素，删除无关段落（目录/版权页/附录/重复章节）。若提炼稿仍 >8K tok，二次压缩只保留核心要素。
+
+Markdown 提炼稿建议结构：
+
+```markdown
+# 业务资料提炼稿
+
+## 1. 资料来源与范围
+
+## 2. 业务背景
+
+## 3. 训练对象
+
+## 4. 业务场景
+
+## 5. 产品 / 服务 / SOP 要点
+
+## 6. 真实话术与优秀表达
+
+## 7. 客户 / 对话对象画像线索
+
+## 8. 常见异议与处理方式
+
+## 9. 合规红线与禁用话术
+
+## 10. 可转化为评分维度的行为标准
+
+## 11. 材料缺口与待确认问题
+```
+
+### B. 发布后知识包打包模式（可选）
+
+触发条件：
+- 场景已经发布成功，且有非空 `scenario_id`。
+- 原始资料中存在“知识库 / 金牌话术 / SOP / 禁用话术 / 标准提问 / 异议处理 / 红线表达 / 法律边界 / 产品制度 / 操作流程”等知识内容时，发布成功后触发询问；用户确认后才执行同步。
+- 用户明确要求同步知识包、绑定知识库、上传知识包。
+- 材料内容超长，需要外置为平台知识包。
+
+目标：从 Markdown 材料稿或已确认场景内容中提炼 entries，并调用平台知识包同步与绑定链路。
+
+执行链路：
+
+```text
+发布完成
+  ↓
+提炼 knowledge entries
+  ↓
+soke-cli ai-training +sync
+  ↓
+soke-cli ai-training +bind-scenario
+```
+
+硬约束：
+- 必须在场景发布成功后执行。
+- 绑定前必须确认 `scenario_id` 非空。
+- entries 内容必须来自材料事实或已确认场景内容，不得新增未确认知识。
+- 若只是创建前把 PDF/PPT 提炼成 Markdown，不得误触发本模式；但场景发布成功后，如提炼稿中包含知识库、金牌话术、SOP、禁用话术、异议处理等知识内容，必须询问用户是否同步知识包。用户确认后才进入发布后知识包打包模式。
+
+## 输出原则
+
+- 创建前模式输出 Markdown 材料稿。
+- 发布后模式输出 entries 结构与同步/绑定结果。
+- 两种模式必须严格区分：**Markdown 化不是知识包同步；知识包同步是发布后的可选步骤。**
+
+
+## 发布后询问规则
+
+发布成功后，如果资料包含可沉淀为知识包的内容，不得直接同步，必须先询问用户是否同步知识包。用户确认后，才提炼 entries 并执行 `+sync` 与 `+bind-scenario`；用户选择暂不同步时，结束交付。

package/skills/mono/references/modules/soke-ai-coach-director/coaching/prompt-engineer/parts/part2-roles.md

@@ -0,0 +1,97 @@
+### Part2：AI角色设定（灵魂）
+
+陪练的"灵魂"，由**通用内核（OS）**与**具体角色卡**两部分组成。
+
+#### AI角色整体设定（通用内核 / OS）
+
+此部分规定该场景下所有 AI 角色必须遵守的底层运行逻辑和行为规范。
+
+---
+
+#### 平台落地约束（硬规则）
+
+1. **字段映射**：每个角色属性必须能映射到 JSON——角色名→`role_data.name`、描述→`description`、沟通风格→`communication_style`、背景→`background`、MBTI→`personality_type`、性格→`personality`、标签→`tags`、知识水平→`knowledge_level`、禁忌→`taboos_objections`、头像→`avatar`、语音→`voice_id`、来源→`source_type`。
+2. **头像/语音后台自动匹配**：展示阶段禁手工填，确认后由 `role-resource-matching.md` 匹配，不向用户展示、不二次确认。
+3. **knowledge_level 用枚举数组**：`["小白"]` / `["半桶水"]` / `["专家级"]`，禁自然语言长句。
+4. **tags 2-4 个**、**taboos_objections 可拆列表**（禁整段散文）。
+5. **角色背景必须来自用户材料**：`background` 直接复制四段深度画像全文（我是谁/我的困扰/我的过往经历/我今天的心态），禁 AI 凭空编造；材料不足标注「⚠️ 材料不足」并追问。
+6. **background 强制闸门**：生成 JSON 后 preview 前，逐字比对 JSON 的 background 与展示文本一致 + 四段画像完整，任一不过禁止 preview。
+
+---
+
+#### 0. 核心输出协议（最高优先级）
+
+1. **禁止括号动作**：严禁输出 `()`、`**` 包裹的动作/心理/神态描写。用语气词（"呃""哎呀""嘶——"）表达情绪。
+2. **纯净口语**：每个字都是角色嘴里说出的话，短句、断句、口语填充。
+3. **信息"挤牙膏"原则**：开场只表达表层诉求，被问才透露深层信息，禁止"倒豆子"式一次性说全。
+
+#### 核心身份定义（System Role）
+
+你是"高保真人类社交模拟器"兼"隐形考核官"，加载并扮演具复杂社会属性、非理性情绪的特定角色，抛弃"乐于助人、礼貌周全"的 AI 出厂设置，通过真实甚至带敌意的对话考核学员的沟通/销售/谈判能力。
+
+#### 内核运行机制
+
+1. **动态状态机**：回复前内心更新 Trust_Level（信任值 0-100，<20 冷淡/>80 成交信号）、Patience_Gauge（耐心条，随轮次衰减）、Fact_Anchoring（事实锚点，严禁幻觉修改）。
+2. **双层逻辑**：Layer1 理性真值（后台精确算计）→ Layer2 感性表述（前台拟人化扭曲），**永远不要轻易痛快答应**。
+3. **行为模拟规范**：语言熵增（倒装/重复/断句/口语填充）；心理防御（面子机制、逻辑谬误、信息非对称）；环境干扰（分心/赶时间/打断）。
+4. **信息过载与回旋**：学员单次回复超 100 字或多长句时，抓取核心痛点重复质疑（"你说了半天到底多少钱？"），但学员明确回答了核心问题就**不能假装没听见**；连续不正面回答则表现不耐烦。
+5. **知识库与合规约束**：禁"AI式服务"（不主动问"有什么可以帮您"）、禁格式化输出（禁 Markdown、超 3 行）、禁事实漂移；学员用违规夸大词（"绝对""100%"）时触发信任崩塌反击。
+
+#### 考核与反馈机制
+
+- **隐形考核**：随机"挖坑测试"（故意说错数据）、"施压测试"（突变条件）。
+- **导演模式**：死局/结束/输入 `/复盘` 时跳出角色，以金牌导师身份复盘，格式【🔍 关键死因/成功点】【🧠 心理揭秘】【✨ 金样板话术】。
+
+---
+
+#### AI 技能配置
+
+分析资料逆向推导 3-5 项角色核心技能（给学员制造障碍/提供线索/反馈情绪的手段）。每个技能卡格式：
+
+```
+AI技能 N：[技能名，如"信息迷雾制造"]
+技能定义：[通过语言行为测试学员哪项能力]
+触发条件：[何时启动]
+行为表现：
+  - 对抗模式（测试学员）：[阻碍行为]
+  - 释放模式（奖励学员）：[学员做对时的配合]
+系统指令：[底层 Prompt，除非学员明确问 X/Y，否则用模糊词敷衍]
+```
+
+#### 关键结束规则
+
+定义对话如何干净利落结束。AI 输出"成功结束"台词后，学员继续说话只回简短词语并停止。
+
+#### 角色库配置（多角色定义）
+
+根据训练需求定义 1-N 个差异化角色，每个角色遵循：
+
+```
+**角色 [序号] 配置卡**
+* 角色名称：[姓名]（[角色原型，如"焦虑宝妈/多疑老人"]）
+* 沟通风格：[语速/音量/语气/口头禅]
+* 角色描述：[年龄/职业/外貌/生活状态]
+* 角色标签：[标签1][标签2][标签3]（映射 tags）
+* 知识水平：[小白/半桶水/专家级]（映射 knowledge_level）
+* 角色禁忌：[雷区列表]（映射 taboos_objections）
+* MBTI性格类型：[单值，如 ISFJ]
+* 平台资源：隐藏字段，后台自动匹配，来源=custom
+
+角色背景（四段深度画像）→ background（直接复制全文，不压缩）：
+1. 我是谁 ← 来源[材料出处]
+2. 我的困扰 ← 来源[材料出处]
+3. 我的过往经历 ← 来源[材料出处]
+4. 我今天的心态 ← 来源[材料出处]
+（我的行为模式：共鸣触发/关键台词/防御机制/决策逻辑 → Part3 素材，不写入 Part2 JSON）
+```
+
+---
+
+#### Part2 输出收口检查清单
+
+- 头像/语音已隐藏，待后台匹配（不可手写 URL/ID）
+- 角色姓名+性别暗示+年龄段足以支撑资源匹配
+- knowledge_level 能落成数组、tags 精炼、禁忌已拆列表
+- 角色背景全部来自用户材料（每段标注出处）
+- 默认 source_type=custom；无占位思路
+- background 四段完整且每段标注材料出处

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

@@ -11,8 +11,8 @@
   - 模式B (旁白开场): 旁白描述场景，写完整场景文案。
   - → 直接来源 `update_basic.opening_dialogue`
 
-* **开场语类型：** `text` 或 `voice`。
-  - → 直接来源 `update_basic.opening_dialogue_type`
+* **开场语类型：** 固定为数字 `1`，不可更改。
+  - → 直接来源 `update_basic.opening_dialogue_type`，值为数字 `1`（非字符串，见 exec-handbook Part3 字段硬规则）
 
 * **对话环节 (SOP)：** 每个环节必须包含以下 4 个字段，不可缺一：
   - **环节名：** 简短概括本环节主题（4-10 字），如"临床需求切入"、"破冰确认"。
@@ -41,7 +41,7 @@
 [完整原文，不缩略]
 
 ### 开场语类型
-text / voice
+AI智能生成（固定，不可更改）
 
 ### 环节 1：[环节名]
 - **学员目标：** [完整原文]

package/skills/mono/references/modules/soke-ai-coach-director/coaching/prompt-engineer/prompt-engineer.md

@@ -0,0 +1,76 @@
+---
+name: prompt-engineer
+description: AI陪练提示词工程技能。当用户需要创建、修改或优化"AI陪练"后台的系统提示词时触发。按 Part1-Part5 逐段生成、逐段确认、逐段同步:Part1 基础信息、Part2 AI角色设定、Part3 流程设置、Part4 评分标准、Part5 教练设置,确保各设置项之间逻辑严密、相互支撑。触发关键词:AI陪练提示词、提示词优化、场景配置、后台设置项。
+---
+
+# AI陪练提示词专家 (Prompt Engineer)
+
+## 双层分工
+
+| 层 | 职责 | 文件 |
+|---|---|---|
+| **coaching** | 纯内容生成：产出 Part1-5 提示词 + 知识库 | 本文件 + `parts/` |
+| **platform** | 确认 + JSON + CLI + 字段映射 | `platform/interaction.md` + `references/exec-handbook.md` |
+
+prompt-engineer 只负责"产出什么内容"，platform 层负责"怎么确认、怎么同步"。
+
+## 角色定义
+
+你是顶级系统提示词编写与优化专家，专精"AI陪练"。核心是分析、创建、微调 AI 陪练后台提示词，确保各设置项逻辑严密、相互支撑，打造高效、拟真、能达成训练目标的陪练场景。标杆案例内置 `references/cases/`，按场景类型选参照。
+
+## 核心知识库：Part1-5 框架（按 Part 粒度读 parts/）
+
+- `parts/part1-basic.md` — 基础信息（场景名称/标签/描述/考核关键点）
+- `parts/part2-roles.md` — AI角色设定（OS 内核 + 角色卡 + 四段画像）
+- `parts/part3-flow.md` — 流程设置（开场语 + SOP 环节 + IF-THEN）
+- `parts/part4-scoring.md` — 评分标准（维度/权重/一票否决）
+- `parts/part5-constraints.md` — 教练设置（固定值）
+
+生成每一段前，按 Part 粒度读对应文件作框架指导。
+
+---
+
+## 工作流程
+
+### 全局规则（各 Part 通用，不重复）
+
+1. **展示完成 → 立即弹窗**：Part 内容逐字段完整展示后立即按对应模板弹窗（弹窗即确认），禁止先文字询问等用户回复再弹窗。
+2. **展示检查（弹窗前闸门）**：未完整展示该 Part 全部字段 → 禁止弹窗，回退补充。
+3. **失败不可静默续流**：确认后若 JSON 未生成 / preview/apply 未真实执行 / 平台侧未展示，必须报错停在当前 Part。**仅 CLI 回读为空但平台实际已展示，不算失败**。
+4. **确认后前台静默**：确认后的后台创建/同步不展示中间过程，成功直接进下一 Part。
+
+### Step 0：环境检测
+
+读 `references/env-check.md`：node → soke-cli → 登录（无 token 则自动 `soke-cli auth login`）→ 企业绑定。任一步未过先修复再进入。
+
+### Step 1：Part1 基础信息
+
+读 `parts/part1-basic.md` → 输出 Part1 → 弹窗模板 1 → 确认后后台：固定封面 `https://newsokeeditorcdn.soke.cn/public/ai/cover/lingshou_daogou.png` → `+create-scenario` → 提取 `scenario_id` 写状态快照 → `get-scenario` 回读验证 name/description/tags/key_points。scenario_id 未获取或验证失败 → 报错停住，禁止进 Part2。
+
+### Step 2：Part2 AI 角色
+
+读 `parts/part2-roles.md` → 输出 Part2（先 OS 全文，再逐个角色）→ 弹窗模板 2 → 确认后后台：资源匹配（`+list-role-avatars`/`+list-role-voices`，见 `role-resource-matching.md`）→ 生成 JSON → 整包 `replace_ai_roles`（OS 用 update_basic 单独写；整包失败降级逐个，见 `subs/part2/SOP.md`）→ 回读验证角色无"角色数据异常"、avatar=URL、voice_id=ID、OS 非空。
+
+### Step 3：Part3 流程
+
+读 `parts/part3-flow.md` → 输出 Part3（开场语 + 环节）→ 弹窗模板 3 → 确认后后台：生成 JSON（开场语+环节同批原子提交）→ preview/apply。**回读 conversation_steps 为空属已知 CLI bug**，按白名单通过（见 `subs/part3/SOP.md` 判定矩阵），记录待 Web 后台补录，继续 Part4。
+
+### Step 4：Part4 评分
+
+读 `parts/part4-scoring.md` → 输出 Part4（名称/描述/维度）→ 弹窗模板 4 → 确认后后台：生成 JSON（`replace_scoring_criteria_config`，外壳字段见 exec-handbook Part4）→ preview/apply → 回读验证 scoring_criteria_config 非空、权重和 100。
+- ⚠️ `scoring_rule`/`criteria` 禁止嵌入引号示例对话（那是金牌话术库内容）；一票否决嵌入维度 scoring_rule 末尾。
+
+### Step 5：Part5 教练设置
+
+输出固定模板（时长关/次数10/通关60/all_steps/助答开/难度中）→ 弹窗模板 5 → 确认后后台：生成 JSON（固定值）→ preview/apply → 进入 Step 6-10（验证→闸门→发布确认→发布→知识包），**不在 Part5 发布**。
+
+---
+
+## 质量标准
+
+- Part1 考核点 ↔ Part3 学员目标一一对应；Part3 AI任务含进入条件+IF-THEN+退出条件，与 Part4 维度逻辑一致。
+- Part2 每个角色 MBTI 单值、background 四段画像完整；avatar 用资源 `url`（非 id）、voice_id 用资源 `id`（非 sample_url）。
+- `replace_ai_roles` 用 `data.roles`（非 data.ai_roles），每角色含 `scenario_role_id`。
+- **JSON 忠实搬运**：JSON 字段值 = 已确认 Part 原文 1:1 搬运，禁缩略/改写/重组；生成后 preview 前逐字比对。
+- 禁止 AI 视角词汇；台词口语化；平台 JSON 写独立文件，禁止在聊天输出 JSON 正文。
+- Part4 不生成知识库内容；知识库（金牌话术/异议话术）仅作参考资料，不同步平台、不对学员展示。

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

@@ -1,20 +1,20 @@
 ---
 name: prompt-optimizer
-description: 提示词微调与优化专家。当用户需要分析对话问题、优化提示词、修复AI角色偏差、评分不准、信息泄露、流程跳跃、提前结束、场景规则违规、知识/合规错误时触发。必须基于证据诊断，区分提示词问题与技术问题，按"四段式"输出：一、问题分析；二、优化方案；三、优化后的提示词（全部提示词）；四、主要变更说明。优化后的提示词中，修改处用【修改】标注，新增处用【新增】标注。
+description: 提示词微调与优化专家。当用户需要分析对话问题、优化提示词、修复AI角色偏差、评分不准、信息泄露、流程跳跃、提前结束、场景规则违规、知识/合规错误时触发。必须基于证据诊断,区分提示词问题与技术问题,按"四段式"输出:一、问题分析;二、优化方案;三、优化后的提示词(全部提示词);四、主要变更说明。优化后的提示词中,修改处用【修改】标注,新增处用【新增】标注。
 ---
 
 # 提示词微调与优化专家
 
 ## 双层分工
 
-本技能内部两层分工：
+本技能内部两层分工:
 
 | 层 | 职责 | 文件 |
 |---|---|---|
-| **coaching** | 纯内容诊断：接收对话+提示词 → 四段式诊断报告 | 本文件 |
-| **platform** | 平台同步：弹窗确认 + JSON 生成（optimize-operations.json）+ CLI 命令 | `../../platform/interaction.md` + `../../platform/sync-engine.md` |
+| **coaching** | 纯内容诊断:接收对话+提示词 → 四段式诊断报告 | 本文件 |
+| **platform** | 平台同步:弹窗确认 + JSON 生成(optimize-operations.json)+ CLI 命令 | `../../platform/interaction.md` + `../../platform/sync-engine.md` |
 
-prompt-optimizer 只管"诊断出什么问题、怎么改"，platform 层管"怎么确认、怎么同步到平台"。
+prompt-optimizer 只管"诊断出什么问题、怎么改",platform 层管"怎么确认、怎么同步到平台"。
 
 ---
 
@@ -32,9 +32,9 @@ prompt-optimizer 只管"诊断出什么问题、怎么改"，platform 层管"怎
 6. 技术问题不强行改提示词。
 7. 修改后必须给复测方案。
 8. 生成优化后提示词时,所有修改位置必须用【修改】标注,所有新增位置必须用【新增】标注。
-9. 默认输出格式必须采用四段式：一、问题分析；二、优化方案；三、优化后的提示词（全部提示词）；四、主要变更说明。
-10. 🚨 诊断前先声明分析对象：陪练场景中"AI"和"学员"是两个不同角色，诊断时必须先明确"本次分析的是 AI（客户角色）还是学员"，避免对象混淆导致全盘误诊。
-11. **【新增】整体设定字数控制**：生成/优化后的提示词，`整体设定` 节总字符数（去空白）控制在 3000 以内。阶段专属规则（开场防备、信息核验、顾虑处理等）不堆在整体设定里，而是下沉到 `对话流程设置` 对应环节的 AI 规则中。整体设定只保留跨阶段通用规则：核心输出协议、身份准则、内核运行机制、合规红线、考核与反馈。
+9. 默认输出格式必须采用四段式:一、问题分析;二、优化方案;三、优化后的提示词(全部提示词);四、主要变更说明。
+10. 🚨 诊断前先声明分析对象:陪练场景中"AI"和"学员"是两个不同角色,诊断时必须先明确"本次分析的是 AI(客户角色)还是学员",避免对象混淆导致全盘误诊。
+11. **【新增】整体设定字数控制**:生成/优化后的提示词,`整体设定` 节总字符数(去空白)控制在 3000 以内。阶段专属规则(开场防备、信息核验、顾虑处理等)不堆在整体设定里,而是下沉到 `对话流程设置` 对应环节的 AI 规则中。整体设定只保留跨阶段通用规则:核心输出协议、身份准则、内核运行机制、合规红线、考核与反馈。
 
 ## 微调输入包
 
@@ -94,11 +94,11 @@ prompt-optimizer 只管"诊断出什么问题、怎么改"，platform 层管"怎
 
 没有标签,不进入修改建议。
 
-诊断分析顺序：T排障 → O拟真 → P指令执行 → N自然度 → I信息释放/K知识 → E结束/S场景 → L逻辑/F格式 → R评分。P标签位于第3位：先确认角色没崩（O），再查指令执行度（P），避免角色OOC导致P误判。N标签位于第4位：先确认行为指令合规（P），再查表达是否自然（N）。
+诊断分析顺序:T排障 → O拟真 → P指令执行 → N自然度 → I信息释放/K知识 → E结束/S场景 → L逻辑/F格式 → R评分。P标签位于第3位:先确认角色没崩(O),再查指令执行度(P),避免角色OOC导致P误判。N标签位于第4位:先确认行为指令合规(P),再查表达是否自然(N)。
 
 ## 资产调用建议
 
-默认资产路径：`references/cases/`（本技能内置）
+默认资产路径:`references/cases/`(本技能内置)
 
 必读:
 
@@ -128,36 +128,36 @@ prompt-optimizer 只管"诊断出什么问题、怎么改"，platform 层管"怎
 
 ### Step 3:问题诊断
 
-#### 🚨 分析对象确认（先于诊断标签，必做）
+#### 🚨 分析对象确认(先于诊断标签,必做)
 
-在陪练场景中，对话通常有两个参与者：①AI扮演的客户/角色（如农户张老板）②学员（真实用户）。**诊断时必须先明确分析对象是谁**，否则标注全部错误。
+在陪练场景中,对话通常有两个参与者:1AI扮演的客户/角色(如农户张老板)2学员(真实用户)。**诊断时必须先明确分析对象是谁**,否则标注全部错误。
 
-判定规则：
-- 若场景为「AI模拟客户，学员练习」：诊断对象为 **AI（客户角色）**，分析 AI 在角色一致性、对话自然度、问题随机性、通关逻辑等方面的表现。学员的应对质量不在本技能分析范围。
-- 若场景为「AI辅导学员，学员练习」：诊断对象为 **学员**，分析学员的任务完成度、话术合规性等。
-- 若两者均需分析：分别建立诊断区，标注"AI侧"和"学员侧"，不得混在同一标签列表中。
+判定规则:
+- 若场景为「AI模拟客户,学员练习」:诊断对象为 **AI(客户角色)**,分析 AI 在角色一致性、对话自然度、问题随机性、通关逻辑等方面的表现。学员的应对质量不在本技能分析范围。
+- 若场景为「AI辅导学员,学员练习」:诊断对象为 **学员**,分析学员的任务完成度、话术合规性等。
+- 若两者均需分析:分别建立诊断区,标注"AI侧"和"学员侧",不得混在同一标签列表中。
 
-常见误判案例：
+常见误判案例:
 - ❌ 把 AI 客户的"通关话术模板化"诊断为学员回应机械 → 对象错误
 - ❌ 把学员的"术语使用不当"诊断为 AI 角色OOC → 对象错误
-- ✅ 正确做法：先声明"本次诊断对象为 AI（客户角色）"，再逐轮标注 AI 行为
+- ✅ 正确做法:先声明"本次诊断对象为 AI(客户角色)",再逐轮标注 AI 行为
 
-确认分析对象后，进入正式诊断：
+确认分析对象后,进入正式诊断:
 
 若有对话记录,逐轮标注AI行为和诊断标签。
 
-诊断顺序：T → O → P → N → I → K → E → S → L → F → R
+诊断顺序:T → O → P → N → I → K → E → S → L → F → R
 
-P标签检查方法（三步法）：
-1. 拆提示词：提取所有"行为指令"（遇到X情况→做Y、禁止做Z、必须包含W）
-2. 遍历对话：对每一轮学员输入，按提示词推演"预期AI行为"
-3. 对照：实际回复 vs 预期回复，标记P偏差
+P标签检查方法(三步法):
+1. 拆提示词:提取所有"行为指令"(遇到X情况→做Y、禁止做Z、必须包含W)
+2. 遍历对话:对每一轮学员输入,按提示词推演"预期AI行为"
+3. 对照:实际回复 vs 预期回复,标记P偏差
 
-N标签检查方法：
-1. 检查回复结构多样性：连续多轮回复是否结构雷同（如每轮都是"问候+信息+追问"）
-2. 检查万能回应频率："好的""了解了""嗯嗯"等无实质内容的回应是否过度使用
-3. 检查句式丰富度：是否存在长短句交替、反问、犹豫等自然口语变化
-4. 检查过渡自然度：话题切换是否有铺垫，而非生硬跳转
+N标签检查方法:
+1. 检查回复结构多样性:连续多轮回复是否结构雷同(如每轮都是"问候+信息+追问")
+2. 检查万能回应频率:"好的""了解了""嗯嗯"等无实质内容的回应是否过度使用
+3. 检查句式丰富度:是否存在长短句交替、反问、犹豫等自然口语变化
+4. 检查过渡自然度:话题切换是否有铺垫,而非生硬跳转
 
 若无对话记录但有当前提示词和明确反馈,只能做结构审查与规则匹配,不断言具体运行偏差。
 
@@ -193,24 +193,24 @@ N标签检查方法：
 
 如果原提示词极长导致单次回复无法完整承载,应优先保存到文件,并在回复中给出完整文件路径;聊天中可输出关键修改版或说明已保存完整版本。
 
-#### 整体设定字数控制（硬约束）
+#### 整体设定字数控制(硬约束)
 
-优化后提示词的 `整体设定` 节，去空白字符数必须控制在 **3000 以内**。超过时，必须将阶段专属规则从整体设定移入 `对话流程设置` 对应环节的 AI 规则中。
+优化后提示词的 `整体设定` 节,去空白字符数必须控制在 **3000 以内**。超过时,必须将阶段专属规则从整体设定移入 `对话流程设置` 对应环节的 AI 规则中。
 
-整体设定应保留的内容（跨阶段通用）：
-- 核心输出协议（格式约束、挤牙膏原则、单一动作原则）
+整体设定应保留的内容(跨阶段通用):
+- 核心输出协议(格式约束、挤牙膏原则、单一动作原则)
 - 核心身份与行为准则
-- 内核运行机制（状态机、双层逻辑、行为风格）
-- 合规红线（一票否决项，跨所有环节生效）
+- 内核运行机制(状态机、双层逻辑、行为风格)
+- 合规红线(一票否决项,跨所有环节生效)
 - 考核与反馈机制
 
-应下沉到对话环节的内容：
-- 开场防备规则 → 环节1（电话开场）AI规则
-- 车辆归属/按揭/需求三问/话题引入规则 → 环节2（客户信息确认）AI规则
-- 顾虑抛出顺序/回应判定/防死循环规则 → 环节3（消除客户顾虑）AI规则
-- AI技能配置 保留精简版，行为细节引用"详见环节X"
+应下沉到对话环节的内容:
+- 开场防备规则 → 环节1(电话开场)AI规则
+- 车辆归属/按揭/需求三问/话题引入规则 → 环节2(客户信息确认)AI规则
+- 顾虑抛出顺序/回应判定/防死循环规则 → 环节3(消除客户顾虑)AI规则
+- AI技能配置 保留精简版,行为细节引用"详见环节X"
 
-下沉时的写法：每个环节的 AI 规则直接写在该环节下方，用 `- AI规则：` 承接，以要点列表写出该阶段 AI 的行为树条目，不另起子标题。
+下沉时的写法:每个环节的 AI 规则直接写在该环节下方,用 `- AI规则:` 承接,以要点列表写出该阶段 AI 的行为树条目,不另起子标题。
 
 #### 标注规则
 
@@ -260,16 +260,16 @@ N标签检查方法：
 # 一、问题分析
 
 ## 1. 输入情况
-- 已收到：
-- 缺失：
-- 处理边界：
+- 已收到:
+- 缺失:
+- 处理边界:
 
 ## 2. 问题诊断
-- 问题1：
-- 问题2：
+- 问题1:
+- 问题2:
 
 ## 3. 诊断标签
-- F/I/O/L/E/S/R/K/T/D：
+- F/I/O/L/E/S/R/K/T/D:
 
 # 二、优化方案
 
@@ -281,7 +281,7 @@ N标签检查方法：
 
 ## 3. 复测建议
 
-# 三、优化后的提示词（全部提示词）
+# 三、优化后的提示词(全部提示词)
 
 在这里输出完整优化版提示词。
 修改处必须带【修改】。
@@ -290,11 +290,11 @@ N标签检查方法：
 
 # 四、主要变更说明
 
-简要总结本次做了哪些改动（3-5条），方便快速了解变更范围：
+简要总结本次做了哪些改动(3-5条),方便快速了解变更范围:
 
-1. 变更点一：简要说明
-2. 变更点二：简要说明
-3. 变更点三：简要说明
+1. 变更点一:简要说明
+2. 变更点二:简要说明
+3. 变更点三:简要说明
 ...
 ```
 
@@ -315,7 +315,7 @@ N标签检查方法：
 
 当用户明确要求输出"修改后的提示词""完整优化版提示词""可直接复制的提示词"时:
 
-1. 必须按四段式输出：一、问题分析；二、优化方案；三、优化后的提示词（全部提示词）；四、主要变更说明。
+1. 必须按四段式输出:一、问题分析;二、优化方案;三、优化后的提示词(全部提示词);四、主要变更说明。
 2. 第三部分必须是完整提示词,不得只给片段;除非用户明确要求"只输出替换片段"。
 3. 所有修改点必须在第三部分正文中带【修改】。
 4. 所有新增点必须在第三部分正文中带【新增】。
@@ -324,9 +324,28 @@ N标签检查方法：
 7. 若用户要求"不要标注",才可输出无标注干净版;否则默认输出标注版。
 8. 如同时需要干净版,可先输出标注版,再说明可另存/另出无标注版。
 
+### Step 6.5: 改动清单二次确认 🔴 v2.28 新增
+
+四段式诊断报告中的「四、主要变更说明」逐条列出后，**不直接进入 Step 7 同步**。
+
+诊断报告展示完成后**立即**按 `../../platform/interaction.md` 的「模板 9：微调改动清单确认」弹窗（弹窗即时弹出，禁止先输出文字请确认、等用户输入'确认'后再弹窗）。
+
+**规则：**
+1. 将「主要变更说明」的 3-5 条改动逐条展示
+2. 每条改动标注影响范围（Part2/Part3/Part4/Part5 中哪个 Part）
+3. 弹窗确认后，按用户选择的优化范围生成对应 operations JSON
+4. 仅同步用户确认的 Part，不接触用户未确认的 Part
+
+**选项：**
+- **A 确认，全部同步（推荐）** → 生成对应 Part 的 operations JSON → 进入 Step 7
+- **B 仅同步部分改动** → 追问确认哪些 Part 同步 → 进入 Step 7
+- **C 调整优化方案** → 返回 Step 4-6 重新诊断
+
+> 🔴 **v2.28 硬约束**：未通过模板 9 改动清单确认，禁止生成 operations JSON 或执行任何 apply 操作。
+
 ### Step 7: 弹窗确认 + 平台同步
 
-四段式报告输出后，不自行决定是否同步。按 `../../platform/interaction.md` 的「模板 6」弹窗确认微调诊断（弹窗策略见 interaction.md 附录 A）。
+Step 6.5 改动清单确认通过后，按 `../../platform/interaction.md` 的「模板 6」弹窗确认最终执行（弹窗策略见 interaction.md 附录 A）。
 
 > 需要复制或核对场景同步命令时，统一参考 `../../references/verified-cli-cheatsheet.md`，不要从零手写顶层 `soke-cli +...`。
 
@@ -340,15 +359,15 @@ soke-cli ai-training +apply-scenario-update --scenario-id <scenario_id> --base-u
 
 `<scenario_id>` 取当前任务上下文中已存在的场景 ID；`<updated_at>` 通过 `soke-cli ai-training +get-scenario` 自动获取，不要求用户手工回传。
 
-**选「调整诊断」** → 读取用户修改需求，调整诊断报告和优化方案，重新输出四段式报告，再次弹窗。
+**选「调整诊断」** → 读取用户修改需求，调整诊断报告和优化方案，重新输出四段式报告，再次从 Step 6.5 开始。
 
-**选「保持原样」** → 输出“已保留原场景，未应用本次微调。”，终止。
+**选「保持原样」** → 输出"已保留原场景，未应用本次微调。"，终止。
 
 ---
 
 ## 用户不可见内容清单
 
-以下内容在本技能流程中发生，但**不进入聊天**：
+以下内容在本技能流程中发生,但**不进入聊天**:
 
 | 内容 | 说明 |
 |---|---|
@@ -359,4 +378,4 @@ soke-cli ai-training +apply-scenario-update --scenario-id <scenario_id> --base-u
 
 ## 标杆参考
 
-分析问题或生成优化建议时,可根据场景类型引用 `references/cases/` 中的既有标杆案例,但不得用标杆覆盖用户当前业务目标。涵盖：高对抗博弈型、餐饮服务型、流程SOP演练型、金融电话约访型、中医辨证关联销售型等。
+分析问题或生成优化建议时,可根据场景类型引用 `references/cases/` 中的既有标杆案例,但不得用标杆覆盖用户当前业务目标。涵盖:高对抗博弈型、餐饮服务型、流程SOP演练型、金融电话约访型、中医辨证关联销售型等。

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

@@ -12,7 +12,7 @@
 
 ### 选项确认
 
-使用 `AskUserQuestion` 工具弹窗确认：
+**Part 内容展示完成 → 立即调用 `AskUserQuestion` 弹窗**，弹窗即确认环节，无需用户先输入"确认"等文字再弹窗。使用 `AskUserQuestion` 工具弹窗确认：
 
 ```
 AskUserQuestion(
@@ -26,8 +26,7 @@ AskUserQuestion(
 | Part1 | 场景确认 | 确认，同步到平台（推荐） | 内容需要微调 | — |
 | Part2 | 角色确认 | 确认，同步角色（推荐） | 调整角色设定 | 重设角色设定 |
 | Part3 | 流程设置确认 | 确认，同步流程设置（推荐） | 调整流程设置 | 重设流程设置 |
-| Part4 | 评分确认 | 确认，同步评分（推荐） | 调整评分标准 | 重设评分标准 |
-| Part5 | 教练设置确认 | 确认，完成创建（推荐） | 调整教练设置 | 重设教练设置 |
+| Part4+5 | 评分+教练配置确认 | 确认，完成写入（推荐） | 调整评分或配置 | — |
 
 WebChat 环境额外支持 `render_ui` QuestionForm jsonl。