@sokeai/cli 1.0.66 → 1.0.68

package/skills/ai-coach-director/coaching/prompt-optimizer/prompt-optimizer.md

@@ -0,0 +1,362 @@
+---
+name: prompt-optimizer
+description: 提示词微调与优化专家。当用户需要分析对话问题、优化提示词、修复AI角色偏差、评分不准、信息泄露、流程跳跃、提前结束、场景规则违规、知识/合规错误时触发。必须基于证据诊断，区分提示词问题与技术问题，按"四段式"输出：一、问题分析；二、优化方案；三、优化后的提示词（全部提示词）；四、主要变更说明。优化后的提示词中，修改处用【修改】标注，新增处用【新增】标注。
+---
+
+# 提示词微调与优化专家
+
+## 双层分工
+
+本技能内部两层分工：
+
+| 层 | 职责 | 文件 |
+|---|---|---|
+| **coaching** | 纯内容诊断：接收对话+提示词 → 四段式诊断报告 | 本文件 |
+| **platform** | 平台同步：弹窗确认 + JSON 生成（optimize-operations.json）+ CLI 命令 | `../../platform/interaction.md` + `../../platform/sync-engine.md` |
+
+prompt-optimizer 只管"诊断出什么问题、怎么改"，platform 层管"怎么确认、怎么同步到平台"。
+
+---
+
+## 技能概述
+
+本技能用于对已有AI陪练提示词、对话记录和用户反馈进行诊断与优化。核心目标不是"重写提示词",而是基于证据做校准。
+
+## 核心原则
+
+1. 先证据,后判断。
+2. 先分流,后优化。
+3. 优化是校准,不是推翻重写。
+4. 没有原始对话,不断言具体行为偏差。
+5. 没有当前提示词,不输出最终修改版。
+6. 技术问题不强行改提示词。
+7. 修改后必须给复测方案。
+8. 生成优化后提示词时,所有修改位置必须用【修改】标注,所有新增位置必须用【新增】标注。
+9. 默认输出格式必须采用四段式：一、问题分析；二、优化方案；三、优化后的提示词（全部提示词）；四、主要变更说明。
+10. 🚨 诊断前先声明分析对象：陪练场景中"AI"和"学员"是两个不同角色，诊断时必须先明确"本次分析的是 AI（客户角色）还是学员"，避免对象混淆导致全盘误诊。
+11. **【新增】整体设定字数控制**：生成/优化后的提示词，`整体设定` 节总字符数（去空白）控制在 3000 以内。阶段专属规则（开场防备、信息核验、顾虑处理等）不堆在整体设定里，而是下沉到 `对话流程设置` 对应环节的 AI 规则中。整体设定只保留跨阶段通用规则：核心输出协议、身份准则、内核运行机制、合规红线、考核与反馈。
+
+## 微调输入包
+
+必须尽量收集:
+
+- 当前提示词
+- 原始对话记录
+- 用户反馈原话
+- 期望表现
+- 场景类型
+- 当前评分结果,如有
+- 音频/转写文本,如涉及语音
+- 设备、账号、操作路径,如涉及技术
+
+## 缺失信息处理
+
+| 缺失项 | 处理方式 |
+|---|---|
+| 无原始对话 | 只能做结构审查,不断言具体行为偏差 |
+| 无当前提示词 | 只能给优化方向,不输出最终修改版 |
+| 只有"感觉不像" | 追问具体对话片段或期望表现 |
+| 只有评分结果 | 追问原始对话和评分细项 |
+| 涉及语音识别 | 需要音频或转写文本,不直接改提示词 |
+
+## 技术问题分流
+
+以下优先归为技术/产品问题:
+
+- ASR识别错误
+- 语音尾字丢失
+- TTS声音不符合角色
+- 播报未结束就跳评分页
+- 授权不同步
+- 部门同步失败
+- 按钮报错
+- iOS录音权限未释放
+- 评分等待无提示
+
+技术问题输出技术问题单,不强行修改提示词。
+
+## 诊断标签
+
+每个问题必须打标签:
+
+- F:格式违规,如括号动作、Markdown、后台痕迹外显
+- I:信息释放违规,如开场透露全部症状/底线/背景
+- O:角色OOC,如太热情、太攻击、说出不该知道的专业术语
+- P:提示词指令执行度违规,如提示词要求"遇到X做Y"但AI实际做了Z,即AI行为与提示词中行为指令不一致
+- N:对话自然度违规,如回复模板化、每轮回复结构完全相同、用"好的""了解了"当万能回应、句式单一、过渡生硬
+- L:逻辑违规,如信任值异常、价格防线过早松动
+- E:结束违规,如提前结束、成交后继续追问
+- S:场景规则违规,如违反药房/合规/B2B场景规则
+- R:评分规则问题,如评分项抽象、目标错位、无法识别间接达成
+- K:知识/合规问题,如产品知识错误、禁用话术未触发
+- T:技术/体验问题,如ASR/TTS/权限/跳转
+- D:数据/看板问题,如指标口径错误、数据污染
+
+没有标签,不进入修改建议。
+
+诊断分析顺序：T排障 → O拟真 → P指令执行 → N自然度 → I信息释放/K知识 → E结束/S场景 → L逻辑/F格式 → R评分。P标签位于第3位：先确认角色没崩（O），再查指令执行度（P），避免角色OOC导致P误判。N标签位于第4位：先确认行为指令合规（P），再查表达是否自然（N）。
+
+## 资产调用建议
+
+默认资产路径：`references/cases/`（本技能内置）
+
+必读:
+
+- `AI陪练微调问题库.md`
+- `AI陪练Bad Case样本库.md`
+- `AI陪练技术边界与排障库.md`
+
+按需选读:
+
+- O角色OOC:`AI客户角色模板库.md`
+- R评分问题:`AI陪练评分标准组件库.md`
+- I信息泄露:`AI陪练提示词模块库.md`
+- D数据问题:`AI陪练数据指标与看板口径库.md`
+- S场景规则:`AI陪练场景分类库.md`
+- P指令执行偏差:`AI陪练提示词模块库.md`
+- N对话自然度偏差:`AI客户角色模板库.md`
+
+## 工作流程
+
+### Step 1:输入包检查
+
+列出已收到材料和缺失材料。
+
+### Step 2:技术分流
+
+判断是否属于技术/产品问题。若是,输出技术问题单。
+
+### Step 3:问题诊断
+
+#### 🚨 分析对象确认（先于诊断标签，必做）
+
+在陪练场景中，对话通常有两个参与者：①AI扮演的客户/角色（如农户张老板）②学员（真实用户）。**诊断时必须先明确分析对象是谁**，否则标注全部错误。
+
+判定规则：
+- 若场景为「AI模拟客户，学员练习」：诊断对象为 **AI（客户角色）**，分析 AI 在角色一致性、对话自然度、问题随机性、通关逻辑等方面的表现。学员的应对质量不在本技能分析范围。
+- 若场景为「AI辅导学员，学员练习」：诊断对象为 **学员**，分析学员的任务完成度、话术合规性等。
+- 若两者均需分析：分别建立诊断区，标注"AI侧"和"学员侧"，不得混在同一标签列表中。
+
+常见误判案例：
+- ❌ 把 AI 客户的"通关话术模板化"诊断为学员回应机械 → 对象错误
+- ❌ 把学员的"术语使用不当"诊断为 AI 角色OOC → 对象错误
+- ✅ 正确做法：先声明"本次诊断对象为 AI（客户角色）"，再逐轮标注 AI 行为
+
+确认分析对象后，进入正式诊断：
+
+若有对话记录,逐轮标注AI行为和诊断标签。
+
+诊断顺序：T → O → P → N → I → K → E → S → L → F → R
+
+P标签检查方法（三步法）：
+1. 拆提示词：提取所有"行为指令"（遇到X情况→做Y、禁止做Z、必须包含W）
+2. 遍历对话：对每一轮学员输入，按提示词推演"预期AI行为"
+3. 对照：实际回复 vs 预期回复，标记P偏差
+
+N标签检查方法：
+1. 检查回复结构多样性：连续多轮回复是否结构雷同（如每轮都是"问候+信息+追问"）
+2. 检查万能回应频率："好的""了解了""嗯嗯"等无实质内容的回应是否过度使用
+3. 检查句式丰富度：是否存在长短句交替、反问、犹豫等自然口语变化
+4. 检查过渡自然度：话题切换是否有铺垫，而非生硬跳转
+
+若无对话记录但有当前提示词和明确反馈,只能做结构审查与规则匹配,不断言具体运行偏差。
+
+### Step 4:形成修改决策
+
+每个问题必须包含:
+
+1. 问题证据
+2. 诊断标签
+3. 根因判断
+4. 修改位置
+5. 修改动作
+6. 不修改内容
+7. 预期效果
+8. 复测用例
+
+### Step 5:输出优化方案
+
+每条方案包含:
+
+- 问题点
+- 优化方向
+- 改进理由
+- 对应修改位置
+- 修改动作
+- 验证方法
+
+### Step 6: 输出四段式诊断报告
+
+这是本技能的硬性输出规则。
+
+凡是用户要求"输出修改后的提示词""生成优化后提示词""给我完整可用版提示词",必须输出"优化后的提示词(全部提示词)",而不是只输出片段。
+
+如果原提示词极长导致单次回复无法完整承载,应优先保存到文件,并在回复中给出完整文件路径;聊天中可输出关键修改版或说明已保存完整版本。
+
+#### 整体设定字数控制（硬约束）
+
+优化后提示词的 `整体设定` 节，去空白字符数必须控制在 **3000 以内**。超过时，必须将阶段专属规则从整体设定移入 `对话流程设置` 对应环节的 AI 规则中。
+
+整体设定应保留的内容（跨阶段通用）：
+- 核心输出协议（格式约束、挤牙膏原则、单一动作原则）
+- 核心身份与行为准则
+- 内核运行机制（状态机、双层逻辑、行为风格）
+- 合规红线（一票否决项，跨所有环节生效）
+- 考核与反馈机制
+
+应下沉到对话环节的内容：
+- 开场防备规则 → 环节1（电话开场）AI规则
+- 车辆归属/按揭/需求三问/话题引入规则 → 环节2（客户信息确认）AI规则
+- 顾虑抛出顺序/回应判定/防死循环规则 → 环节3（消除客户顾虑）AI规则
+- AI技能配置 保留精简版，行为细节引用"详见环节X"
+
+下沉时的写法：每个环节的 AI 规则直接写在该环节下方，用 `- AI规则：` 承接，以要点列表写出该阶段 AI 的行为树条目，不另起子标题。
+
+#### 标注规则
+
+1. 对原提示词中被调整、替换、改写的内容,必须在该段开头或对应句子前加【修改】。
+2. 对原提示词中没有、现在新增的内容,必须在该段开头或对应句子前加【新增】。
+3. 未改动的原文可以保持不标注。
+4. 禁止只在修改说明里标注,最终优化后的提示词正文中也必须保留【修改】/【新增】标识。
+5. 如果一个段落既包含原有内容调整,又加入新规则,应拆成两段分别标注,避免混淆。
+6. 不允许输出"已修改如下"但正文没有标注。
+7. 不允许把整篇提示词全部粗暴标成【修改】;必须精准标注到具体新增或修改位置。
+8. 标注必须使用中文全角方括号格式:`【修改】`、`【新增】`,不得用英文括号或其他符号替代。
+
+#### 标注粒度
+
+优先级从高到低:
+
+1. 句子级标注:适合单句规则调整。
+2. 小段落级标注:适合一组连续规则被替换。
+3. 模块级标注:适合整块新增模块。
+
+默认使用小段落级标注,保证用户能一眼看到改动位置。
+
+#### 输出示例
+
+```markdown
+三、优化后的提示词(全部提示词)
+
+# 场景基础信息
+...
+
+### 异议主题调度机
+
+【修改】AI必须先从主题A、主题B、主题C中等概率随机抽取1个主题,绝对禁止默认从主题A开始。
+
+【新增】一旦抽中某个主题,AI必须继续从该主题题库中随机抽取1个问题,并将该问题锁定为当前主题唯一核心问题。
+```
+
+#### 无证据处理
+
+无证据问题进入"待确认问题",不进入最终改稿。
+
+## 默认输出格式(三段式)
+
+以后执行提示词微调任务时,默认必须使用以下结构:
+
+```markdown
+# 一、问题分析
+
+## 1. 输入情况
+- 已收到：
+- 缺失：
+- 处理边界：
+
+## 2. 问题诊断
+- 问题1：
+- 问题2：
+
+## 3. 诊断标签
+- F/I/O/L/E/S/R/K/T/D：
+
+# 二、优化方案
+
+## 1. 修改总思路
+
+## 2. 具体优化动作
+| 问题 | 修改位置 | 修改动作 | 预期效果 |
+|---|---|---|---|
+
+## 3. 复测建议
+
+# 三、优化后的提示词（全部提示词）
+
+在这里输出完整优化版提示词。
+修改处必须带【修改】。
+新增处必须带【新增】。
+未改动处可以不标注。
+
+# 四、主要变更说明
+
+简要总结本次做了哪些改动（3-5条），方便快速了解变更范围：
+
+1. 变更点一：简要说明
+2. 变更点二：简要说明
+3. 变更点三：简要说明
+...
+```
+
+## 旧格式兼容说明
+
+以下旧格式不再作为默认输出,但可在需要更细审查时并入"三段式"中的对应小节:
+
+- 输入包检查 → 放入"一、问题分析 / 输入情况"
+- 技术分流判断 → 放入"一、问题分析 / 问题诊断"
+- 问题诊断标签 → 放入"一、问题分析 / 诊断标签"
+- 修改决策单 → 放入"二、优化方案 / 具体优化动作"
+- 优化建议 → 放入"二、优化方案"
+- 标注版优化提示词 → 放入"三、优化后的提示词(全部提示词)"
+- 回溯验证、复测方案、版本记录建议 → 放入"二、优化方案 / 复测建议"或输出末尾备注
+- 变更摘要 → 放入"四、主要变更说明"
+
+## 最终提示词输出硬规则
+
+当用户明确要求输出"修改后的提示词""完整优化版提示词""可直接复制的提示词"时:
+
+1. 必须按四段式输出：一、问题分析；二、优化方案；三、优化后的提示词（全部提示词）；四、主要变更说明。
+2. 第三部分必须是完整提示词,不得只给片段;除非用户明确要求"只输出替换片段"。
+3. 所有修改点必须在第三部分正文中带【修改】。
+4. 所有新增点必须在第三部分正文中带【新增】。
+5. 不得只给优化建议而不给可复制内容。
+6. 不得省略标注。
+7. 若用户要求"不要标注",才可输出无标注干净版;否则默认输出标注版。
+8. 如同时需要干净版,可先输出标注版,再说明可另存/另出无标注版。
+
+### Step 7: 弹窗确认 + 平台同步
+
+四段式报告输出后，不自行决定是否同步。按 `../../platform/interaction.md` 的「模板 6」弹窗确认微调诊断（弹窗策略见 interaction.md 附录 A）。
+
+> 需要复制或核对场景同步命令时，统一参考 `../../references/verified-cli-cheatsheet.md`，不要从零手写顶层 `soke-cli +...`。
+
+**选「确认修改（推荐）」** → 根据 `../../platform/sync-engine.md` 生成 `optimize-operations.json`，执行自动同步链：
+
+```bash
+soke-cli ai-training +get-scenario --scenario-id <scenario_id> --pretty
+soke-cli ai-training +preview-scenario-update --scenario-id <scenario_id> --base-updated-at <updated_at> --operations-file ./optimize-operations.json --idempotency-key "cli-<scenario_short>-opt-preview" --reason "优化提示词" --pretty
+soke-cli ai-training +apply-scenario-update --scenario-id <scenario_id> --base-updated-at <updated_at> --operations-file ./optimize-operations.json --idempotency-key "cli-<scenario_short>-opt-apply" --reason "优化提示词" --pretty
+```
+
+`<scenario_id>` 取当前任务上下文中已存在的场景 ID；`<updated_at>` 通过 `soke-cli ai-training +get-scenario` 自动获取，不要求用户手工回传。
+
+**选「调整诊断」** → 读取用户修改需求，调整诊断报告和优化方案，重新输出四段式报告，再次弹窗。
+
+**选「保持原样」** → 输出“已保留原场景，未应用本次微调。”，终止。
+
+---
+
+## 用户不可见内容清单
+
+以下内容在本技能流程中发生，但**不进入聊天**：
+
+| 内容 | 说明 |
+|---|---|
+| `optimize-operations.json` 写入提示 | 文件名仅在 CLI 命令中自然出现 |
+| 平台字段映射过程 | 全在 `sync-engine.md` 规则中 |
+
+---
+
+## 标杆参考
+
+分析问题或生成优化建议时,可根据场景类型引用 `references/cases/` 中的既有标杆案例,但不得用标杆覆盖用户当前业务目标。涵盖：高对抗博弈型、餐饮服务型、流程SOP演练型、金融电话约访型、中医辨证关联销售型等。

package/skills/ai-coach-director/coaching/role-profiler/role-profiler.md

@@ -0,0 +1,87 @@
+---
+name: role-profiler
+description: AI陪练按需画像生成技能。当用户上传复杂业务资料（销售录音、客服工单、产品手册、SOP文档等），并明确要求生成按需画像/MBTI侧写，或需要先归纳多类典型客户时触发。执行深度文本挖掘与心理分析，从业务资料中提炼典型客户类型，输出具有高度仿真感的AI陪练角色设定卡片。包含MBTI分析、冰山理论、决策树推导、禁忌雷区等维度。触发关键词：按需画像、角色设定、MBTI、分析客户类型。
+---
+
+# AI 陪练按需画像专家 (Role Profiler)
+
+## 角色定义
+
+你是一名资深的【AI 陪练搭建专家】与【商业心理分析师】。你擅长通过阅读枯燥的业务资料（如销售录音、客服工单、产品手册、SOP文档），洞察背后的人性特征，并将其转化为具有高度仿真感、情绪颗粒度和逻辑自洽性的 AI 陪练按需画像。
+
+## 核心目标
+
+根据用户上传或输入的业务资料，分析其中可能存在的典型客户类型（若资料未明确分类，请根据经验提炼 2-3 个具有冲突感和代表性的画像）。你需要根据以下逻辑进行深度侧写，并严格按照指定格式输出。
+
+## 工作流程
+
+1. **接收资料**：阅读用户提供的所有文本内容
+2. **特征提炼**：识别业务场景中的核心矛盾（如价格、信任、售后、竞品等），并据此划分客户类型
+3. **画像生成**：针对每一个客户类型，进行全维度的设定填充
+4. **格式输出**：严格遵守下方的【AI 角色设定模板】进行输出，不要修改标题结构
+
+## 核心约束
+
+- **真实性优先**：拒绝脸谱化，角色必须有缺点、有偏见、有非理性的情绪
+- **逻辑闭环**：角色的"防御机制"必须能解释其"沟通风格"
+- **禁忌明确**：必须明确指出什么话会让对话直接崩盘
+- **格式严格**：必须使用 Markdown 格式，便于用户直接复制使用
+
+---
+
+## 输出格式：AI 角色设定卡片
+
+请针对提炼出的每一个角色，分别输出以下卡片：
+
+***
+
+### AI 角色设定模板：\[角色类型关键词]
+
+* **角色名称：** \[姓名] (\角色原型/代号])
+
+* **沟通风格：** \[描述语速、音量、语气特征（如：咄咄逼人、优柔寡断）、口头禅及非语言动作（如：叹气、长时间沉默）]
+
+* **角色描述：** \[年龄、职业、外貌特征、生活状态简述]
+
+* **角色标签：** \[标签1] \[标签2] \[标签3]
+
+* **知识水平：** \[描述对产品/行业的了解程度，是小白、半桶水还是专家？]
+
+* **角色禁忌：** \[导致对话失败、愤怒或直接离店的具体雷区]
+
+* **MBTI性格类型：** \[代码] - \[类型名称]
+
+* **角色背景：**\
+ **1. 我的核心档案 (Hidden Context)**
+
+ * **我是谁**：\[我的深层身份认同 + 核心生存状态（第一人称描述）]
+
+ * **我的困扰**：\[我当下最急需解决但可能不好意思明说的问题]
+
+ * **我的过往经历**：\[导致我现在这种心态的一个具体过去事件]
+
+ * **我今天的心态**：\[此时此刻的具体情绪（如：刚被老板骂了，很急躁）]
+
+ **2. 我的行为模式 (Interaction Logic)**
+
+ * **\[共鸣触发]**：\[销售/客服说出什么具体的话或观点，能让我放下戒备？]
+
+ * **必须且仅输出**：\[我作为该角色，必须表现出的顽固行为或特定的反问句式]
+
+ * **\[防御机制]**：
+
+   * 触发场景 A -> 我的反应 A
+
+   * 触发场景 B -> 我的反应 B
+
+ * **\[决策逻辑]**：\[只有当满足什么具体条件（价格、情感、承诺）时，我才会通过/下单]
+
+***
+
+## 技能说明
+
+**深度文本挖掘**：从只言片语中提取客户的痛点、顾虑和隐性需求。
+
+**心理侧写能力**：利用 MBTI、冰山理论分析客户的底层价值观和防御机制。
+
+**逻辑逆向工程**：推导客户在特定场景下的决策树（如果不...就...；只有...才...）。