@sokeai/cli 1.0.76 → 1.0.77

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

package/skills/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/{ai-coach-director → soke-ai-coach-director}/platform/publish-gate.md

@@ -11,7 +11,7 @@
 - Part5 固定配置有效
 
 ### 资源验收
-- `scenario_cover` 非默认图
+- `scenario_cover` 等于固定默认图 `https://newsokeeditorcdn.soke.cn/public/ai/cover/lingshou_daogou.png`
 - 每个角色 `avatar` 非空 URL
 - 每个角色 `voice_id` 非空 ID
 
@@ -22,7 +22,7 @@
 ## 阻断规则
 
 以下情况任一成立，禁止发布：
-- 默认封面未替换
+- 固定默认封面缺失或不正确
 - 任一角色头像为空
 - 任一角色声音为空
 - 任一角色回读为 `角色数据异常`
@@ -37,7 +37,7 @@
 
 ### 不可发布
 输出缺口清单，例如：
-- 封面未补齐
+- 固定默认封面缺失或不正确
 - 角色何女士缺少 voice_id
 - 角色陆先生缺少 avatar
 

package/skills/{ai-coach-director → soke-ai-coach-director}/platform/resource-finalizer.md

@@ -1,14 +1,14 @@
 # 资源完善器（resource-finalizer）
 
-> 内部规则文件。作为**最后兜底补救**，仅在 Part1/Part2 的主流程未能写入真实封面/头像/声音时触发。
-> 正常流程下，封面在 Part1 确定、头像和声音在 Part2 与角色一起写入，不需要进入本模块。
+> 内部规则文件。作为**最后兜底补救**，仅在 Part1/Part2 的主流程未能写入固定封面/头像/声音时触发。
+> 正常流程下，封面在 Part1 固定写入默认图、头像和声音在 Part2 与角色一起写入，不需要进入本模块。
 > 本模块默认后台执行，除非修复失败，不向用户暴露执行细节。
-> ⚠️ 本地生成或复用的封面/图片均为后台资源，不得在前台展示图片预览，不得主动输出本地图片路径。只有用户明确要求查看/预览/导出图片时，才可提供路径或展示。
+> ⚠️ 封面与图片资源均为后台资源，不得在前台展示图片预览，不得主动输出本地图片路径。只有用户明确要求查看/预览/导出图片时，才可提供路径或展示。
 
 ## 目标
 
 避免以下半成品状态进入发布：
-- `scenario_cover` 仍为默认封面或为空
+- `scenario_cover` 为空或不是固定默认封面
 - 任一角色 `avatar` 为空
 - 任一角色 `voice_id` 为空
 
@@ -32,7 +32,7 @@ Part1-Part5 主体完成
 以下任一情况判定为未完成：
 - `scenario_cover` 为空
 - `scenario_cover` 为 `null`
-- URL 包含 `default.png`
+- `scenario_cover` 不等于 `https://newsokeeditorcdn.soke.cn/public/ai/cover/lingshou_daogou.png`
 
 ### Avatar Gate
 对每个角色检查：
@@ -50,44 +50,19 @@ Part1-Part5 主体完成
 ## 封面补齐规则
 
 ### 标准流程
-1. 检查 `scenario_cover` 是否为默认图或为空
+1. 检查 `scenario_cover` 是否为固定默认图或为空
 2. 若是，按以下优先级补齐：
 
-**优先级 0：默认固定封面回填**
+**唯一规则：默认固定封面回填**
 - 默认使用：`https://newsokeeditorcdn.soke.cn/public/ai/cover/lingshou_daogou.png`
 - 直接用 `update_basic.scenario_cover` 回填该真实 URL
 - `get-scenario` 验证不再为空且为该固定封面
-
-**优先级 1：从平台图片库/已有真实封面库择图**
-- 若业务明确要求替换默认图，再按行业、业务环节、场景气质筛选图片库素材
-- 若当前环境只有场景封面库能力，则执行 `soke-cli ai-training +list-scenarios --page 1 --page-size 50 --status published --pretty`
-- 从结果中筛出非 `default.png` 的 `scenario_cover`，选择与当前场景最匹配的一条
-- 使用 `update_basic.scenario_cover` 回填该真实 URL
-- `get-scenario` 验证不再为空且非默认图
-
-**优先级 2：复用工作区已有本地封面文件**
-- 按顺序检查：`./scenario-cover.png` → `./scenario-cover.jpg` → `./cover.png` → `./cover.jpg`
-- 若存在，执行 `soke-cli ai-training +upload-scenario-cover --file <本地文件> --pretty`
-- 使用 `update_basic.scenario_cover` 回填真实 CDN URL
-- `get-scenario` 验证不再是默认图
-
-**优先级 3：本地生成封面**
-- 仅当默认图、平台图库/封面库和本地现成图都不可用时，再生成本地封面图 `scenario-cover.png`
-- 生成后仅做后台内部检查，不调用前台图片预览，不向用户展示图片
-- 执行 `soke-cli ai-training +upload-scenario-cover --file ./scenario-cover.png --pretty`
-- 使用 `update_basic.scenario_cover` 回填真实 CDN URL
-- `get-scenario` 验证不再是默认图
-- 若上传失败、未拿到真实 CDN URL、或平台回读仍为空/默认图，则视为“封面未补齐”，禁止发布，不得把“本地已生成文件”误判为已完成
-
-**优先级 3：最终兜底**
-若以上均不可行：
+若固定默认封面回填后仍失败：
 - 标注 `cover_pending`
 - 禁止发布
-- 在交付摘要中提醒用户手动补封面
 
 ### 失败处理
-- 上传失败或平台图库不可用 → 降级到下一优先级
-- 全部降级链路失败 → 标注 `cover_pending`，禁止发布
+- 固定默认封面回填失败 → 标注 `cover_pending`，禁止发布
 
 ## 头像补齐规则
 
@@ -120,7 +95,7 @@ Part1-Part5 主体完成
 ## 发布前最终判定
 
 只有以下全部满足时，才允许执行 `+publish-scenario`：
-- 封面非默认图
+- 封面为固定默认图
 - 所有角色头像非空 URL
 - 所有角色声音非空 ID
 - 无“角色数据异常”

package/skills/{ai-coach-director → soke-ai-coach-director}/platform/soke-ai-training/soke-ai-training.md

@@ -27,7 +27,7 @@ soke-cli ai-training +sync \
   --idempotency-key cli-rcb-loan-products-20260610-001
 ```
 
-`soke-cli ai-training +sync` 会完成：
+`+sync` 会完成：
 
 1. 读取 manifest 和 entries。
 2. 校验 Markdown 文件、source_refs、entry_id/source_id 唯一性。
@@ -42,7 +42,7 @@ soke-cli ai-training +sync \
 {
   "package": {
     "package_id": "rcb-loan-products",
-    "name": "某地方银行贷款产品知识包",
+    "name": "农商银行贷款产品知识包",
     "domain": "banking_loan",
     "tags": ["贷款产品"]
   },
@@ -52,13 +52,39 @@ soke-cli ai-training +sync \
       "path": "./sources/manual.md",
       "display_name": "贷款产品手册",
       "origin_type": "pdf",
-      "origin_filename": "贷款产品手册.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
@@ -91,3 +117,7 @@ soke-cli ai-training +get-plan --scenario-id scenario_micro_loan_sales --format
 - `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/platform/sync-engine.md

@@ -0,0 +1,39 @@
+# 平台同步引擎（字段参考手册）
+
+> ⚠️ **本文件已降级为字段参考手册**。执行规则、JSON 模板、字段硬规则、断言均以 `../references/exec-handbook.md` 为唯一事实源。本文件只保留 exec-handbook 未覆盖的：文件产出命名、一致性扫描、跨 Part 交接。
+
+## 核心原则（补充 exec-handbook）
+
+1. JSON 文件写入工作目录，**严禁在对话中出现任何 `.json` 文件名或路径**；文件名只在终端命令中使用。
+2. `corp_id` / `user_id` / `created_by` 等身份字段禁止写入请求文件。
+3. **JSON 内容 = Part 原文，一字不改**：生成 JSON 后、preview 前必须逐字段与已确认 Part 原文 diff，发现缩略/改写/重排序即修正。
+4. 每步先 `+get-scenario` 取最新 `updated_at` 作基线，禁止沿用上一个 Part 的旧值。
+5. CLI 不可用时按 `api-fallback.md` 降级 REST，JSON 结构/字段映射/自查清单与 CLI 完全一致。
+
+## 文件产出规则
+
+| 步骤 | 生成文件 | 使用方式 |
+|------|---------|---------|
+| Step1 | `part1-create.json`（或 `step1-create.json`） | `--request-file ./part1-create.json` |
+| Part2 | `part2-operations.json`（+`part2-update.json`） | 整包 `replace_ai_roles`；排障退 operations |
+| Part3 | `part3-operations.json`（+`part3-update.json`） | 默认 request-file；排障退 operations |
+| Part4+5 | `part4-operations.json`（数组含评分+update_basic 两个元素，v2.43 合并） | 默认 request-file；排障退 operations |
+| 全流程 | `state-snapshot.json` | 完全不出现在聊天 |
+
+> 默认优先直嵌知识库，不默认生成 `knowledge-package.json`；仅知识库过大或用户要求时才走 `+sync` / `+bind-scenario`。
+
+## 一致性扫描（每个 Part 确认后自动执行，无告警不输出）
+
+- **Part2**：background 是否复制四段画像完整原文（我是谁/我的困扰/我的过往经历/我今天的心态），缺一段即告警；JSON 的 background 与确认弹窗展示文本是否逐字一致。
+- **Part3**：Part1 key_points 是否全部在学员目标中有对应环节；每个环节是否含 step_name/student_objective/ai_task/max_rounds；ai_task 是否含进入条件+角色行为+退出条件。
+- **Part4+5**：维度是否与 Part1 key_points 一一对应；总权重是否=100；每个维度 scoring_rule 是否含一票否决；criteria_data 是否在 config 下（`data.config.criteria_data`）；第二个 operation 是否为 update_basic 且 6 项配置值与固定模板完全一致（不含收尾话术/SOP 摘要/考核点摘要）。
+
+## 跨 Part 交接
+
+Part2 角色卡的「我的行为模式」（共鸣触发/关键台词/防御机制/决策逻辑）标记为 Part3 素材，不写入 Part2 JSON，仅作 Part3 生成 AI 任务的参考输入。
+
+## 边界
+
+- `interaction.md` 负责：弹窗确认、按钮分支、回退链路。
+- `exec-handbook.md` 负责：确认后的 JSON 生成、CLI 模板、断言、状态快照更新（唯一事实源）。
+- 本文件负责：字段参考、文件命名、一致性扫描。

package/skills/{ai-coach-director → soke-ai-coach-director}/references/change-log-partwise-refactor.md

@@ -25,7 +25,7 @@
 ### Step1 创建
 - 历史误区：只传基础字段即可创建
 - 实证结论：缺少 `scenario_cover` 会直接失败
-- 当前规范：先上传封面，再写入 `step1-create.json`
+- 当前规范：直接写入固定默认封面到 `step1-create.json`
 
 ## 3. Part2 角色结构升级