@sokeai/cli 1.0.76 → 1.0.78

package/skills/multi/soke-ai-coach-director/references/cases/AI/351/231/252/347/273/203/346/212/200/346/234/257/350/276/271/347/225/214/344/270/216/346/216/222/351/232/234/345/272/223.md

@@ -0,0 +1,239 @@
+# AI陪练技术边界与排障库
+
+> 用途：帮助实施团队快速判断哪些问题能靠提示词解决，哪些必须转产品/技术，避免反复“瞎调提示词”。  
+> 核心原则：提示词只能解决角色、流程、知识、评分规则问题，不能解决ASR、TTS、权限、接口、前端状态等技术问题。
+
+---
+
+## 一、问题归因总表
+
+| 问题现象 | 可能归因 | 是否提示词可解决 | 处理方向 |
+|---|---|---|---|
+| AI不像客户 | 角色设定/提示词 | 是 | 改角色卡、行为规则 |
+| AI一开场透露信息 | 信息透露规则 | 是 | 改提示词 |
+| AI提前结束 | 流程/结束机制/产品逻辑 | 部分 | 先查结束规则，再查产品逻辑 |
+| 评分不准 | 评分规则/ASR/模型判定 | 部分 | 人工样本校准 |
+| 同音字识别错 | ASR | 否 | 技术评估+评分容错 |
+| 尾字丢失 | ASR/录音交互 | 否 | 技术修复+操作提示 |
+| 声音不像角色 | TTS语音包 | 否 | 更换声音配置 |
+| 播报未完跳评分 | 前端/TTS状态 | 否 | 产品技术修复 |
+| 评分生成太久 | 后台任务/模型耗时 | 否 | 增加进度提示/优化接口 |
+| 授权后看不到入口 | 平台授权/组织同步 | 否 | 实施配置/技术排查 |
+| 再测一次报错 | 前端/接口状态 | 否 | 技术修复 |
+| iOS录音权限不释放 | 端上权限状态 | 否 | 技术修复 |
+
+---
+
+## 二、ASR语音识别问题
+
+### 常见现象
+- 同音字识别错误，如“朱/周”
+- 多音字识别错误
+- 句尾字词丢失
+- 背景噪音导致识别不完整
+- 方言/口音识别差
+- 学员停顿导致断句错误
+
+### 判断方法
+1. 查看原始音频和转写文本是否一致。
+2. 判断错误是否影响业务含义。
+3. 判断是否多用户、多设备复现。
+4. 判断是否与用户操作有关，如说完立刻松手。
+
+### 处理方法
+| 情况 | 处理 |
+|---|---|
+| 同音但不影响业务 | 评分规则容错，不扣分 |
+| 影响关键业务含义 | 转技术评估ASR |
+| 尾字丢失 | 提示用户说完等待1秒，再转技术优化 |
+| 方言识别差 | 评估ASR引擎或提示普通话输入 |
+
+### 实施侧临时话术
+```text
+语音识别可能会受停顿、噪音和松手时机影响。建议学员说完后停顿约1秒再松手，系统评分也会对不影响业务理解的同音误差做容错。
+```
+
+---
+
+## 三、TTS语音合成问题
+
+### 常见现象
+- 声音年龄不匹配
+- 声音过于机械
+- 情绪不足
+- 语速不自然
+- 老年角色像年轻客服
+
+### 判断方法
+1. 角色身份是否需要特定年龄/性别/地域感。
+2. 当前语音包是否可替换。
+3. 客户是否能接受默认声音。
+4. 是否影响训练沉浸感。
+
+### 处理方法
+- 更换语音包。
+- 调整语速、音色、情绪参数。
+- 高要求场景提前让客户确认声音。
+- 不要试图靠提示词解决音色问题。
+
+---
+
+## 四、前端交互问题
+
+### 播报未完跳评分页
+
+| 字段 | 内容 |
+|---|---|
+| 现象 | AI最后一句语音还没播完，页面已跳到评分页。 |
+| 归因 | 前端未等待TTS播放完成状态。 |
+| 处理 | 转产品/前端；评分跳转需等待播报完成。 |
+| 验收 | 多轮测试中，语音播放结束后再跳评分。 |
+
+### 评分等待无提示
+
+| 字段 | 内容 |
+|---|---|
+| 现象 | 用户提交后长时间空白或转圈。 |
+| 归因 | 后台评分耗时，前端缺少状态提示。 |
+| 处理 | 增加“评分生成中”“后台持续生成”“稍后查看”等提示。 |
+| 验收 | 用户知道系统仍在处理。 |
+
+### 再测一次按钮报错
+
+| 字段 | 内容 |
+|---|---|
+| 现象 | 点击再测一次后无法重新进入。 |
+| 归因 | 前端状态或接口参数问题。 |
+| 处理 | 提交技术问题单，记录账号、场景、时间、截图。 |
+| 验收 | 连续复测3次无报错。 |
+
+---
+
+## 五、权限与部署问题
+
+### 常见现象
+- 用户看不到应用入口
+- 部门授权后成员缺失
+- 任务指派不生效
+- 手机端能看，电脑端不能看
+- 管理员看不到数据
+
+### 排查顺序
+```text
+用户是否在授权名单
+→ 应用是否对该用户开放
+→ 部门组织架构是否同步
+→ 任务是否指派到人
+→ 手机端/电脑端是否都验证
+→ 是否存在同步延迟
+```
+
+### 上线前检查
+| 检查项 | 要求 |
+|---|---|
+| 用户名单 | 与客户确认最终名单 |
+| 应用授权 | 逐人或按部门授权后抽查 |
+| 入口可见 | 手机端/电脑端都验证 |
+| 任务指派 | 至少抽查3-5人 |
+| 管理权限 | 管理员能看数据、导出数据 |
+| 备用账号 | 培训现场准备1-2个 |
+
+---
+
+## 六、后台配置问题
+
+### 常见现象
+- 场景配置后学员看不到
+- 角色版本混用
+- 评分标准不是最新版
+- 修改后没有生效
+- 客户测试数据污染正式数据
+
+### 处理方法
+- 每次配置记录版本号。
+- 上线前冻结V1.0版本。
+- 修改后用测试账号确认生效。
+- 区分测试账号和正式账号。
+- 保留旧版本，方便回滚。
+
+---
+
+## 七、冷场与自动结束问题
+
+### 可能归因
+| 现象 | 归因 |
+|---|---|
+| 10秒未响应无提醒 | 产品未记录间隔或未配置提醒 |
+| 30秒自动结束不生效 | 前端/后端状态未触发 |
+| 信任值高自动结束 | 提示词或产品逻辑设计错误 |
+| AI主动结束太早 | 结束条件写错 |
+
+### 处理方法
+- 明确冷场时间规则。
+- 提示词中写自然提醒语。
+- 产品侧记录未响应时间。
+- 取消信任值自动结束。
+
+---
+
+## 八、技术问题提交模板
+
+```text
+问题标题：【场景】+【问题现象】
+发生时间：【】
+账号/用户：【】
+设备与系统：【iOS/Android/Windows/Mac】
+入口：【钉钉/企微/网页/APP】
+场景名称：【】
+操作路径：【第1步→第2步→第3步】
+问题截图/录屏：【】
+是否可复现：【是/否】
+复现频率：【必现/偶现】
+影响范围：【单人/多人/全部】
+临时处理：【】
+期望结果：【】
+```
+
+---
+
+## 九、提示词问题与技术问题分界
+
+### 优先判断为提示词问题
+- AI人设不像
+- AI太热情/太攻击
+- 信息透露过快
+- 对话流程跳跃
+- 知识边界不清
+- 红线未写入规则
+- 评分项抽象
+
+### 优先判断为技术/产品问题
+- 语音识别错误
+- 语音合成机械
+- 播报状态不同步
+- 页面跳转错误
+- 权限不同步
+- 按钮报错
+- 数据不显示
+- 录音权限异常
+
+### 混合问题
+| 问题 | 处理方法 |
+|---|---|
+| ASR错误导致评分错 | 技术修ASR + 评分规则容错 |
+| 提前结束 | 查提示词结束规则 + 查产品自动结束逻辑 |
+| 评分不准 | 查评分提示词 + 查模型输出 + 查ASR文本 |
+| 冷场处理差 | 产品加时间检测 + 提示词加提醒语 |
+
+---
+
+## 十、排障原则
+
+1. 先复现，再判断。
+2. 先分类，再处理。
+3. 技术问题不要反复改提示词。
+4. 提示词问题必须保留原始对话。
+5. 权限问题培训前必须逐人验证。
+6. 语音问题要同时看音频和转写文本。
+7. 产品体验问题要记录设备、路径、截图。
+8. 所有P0问题上线前必须关闭。

package/skills/multi/soke-ai-coach-director/references/cases/AI/351/231/252/347/273/203/346/217/220/347/244/272/350/257/215/346/250/241/345/235/227/345/272/223.md

@@ -0,0 +1,249 @@
+# AI陪练提示词模块库
+
+> 用途：搭建陪练提示词时，按模块拼装，降低从零写提示词的成本。  
+> 核心原则：提示词必须模块化。角色、流程、知识、评分、红线、结束机制分开写，方便后续微调。
+
+---
+
+## 一、模块总览
+
+| 模块 | 作用 | 适用阶段 |
+|---|---|---|
+| 场景任务模块 | 定义这场训练是什么 | 所有场景 |
+| AI角色身份模块 | 定义AI扮演谁 | 所有角色扮演 |
+| DISC人格模块 | 控制角色性格底色 | 销售/面访/B2B |
+| 信息透露模块 | 控制AI不要一次性给答案 | 所有客户角色 |
+| 对话流程模块 | 控制环节推进 | 所有对话训练 |
+| 禁止行为模块 | 防止AI帮学员、越界、乱说 | 所有场景 |
+| 知识边界模块 | 防止幻觉和专业错误 | 专业/合规场景 |
+| 评分规则模块 | 定义踩点得分 | 评分型陪练 |
+| 红线规则模块 | 定义一票否决 | 金融/医药/合规 |
+| 冷场处理模块 | 处理学员不说话 | 语音陪练 |
+| 结束机制模块 | 控制何时结束 | 所有场景 |
+| B2B谈判模块 | 控制长链路谈判逻辑 | B2B |
+| 药房合规模块 | 控制问诊和合规推荐 | 药房 |
+
+---
+
+## 二、场景任务模块
+
+```text
+你正在参与一个AI陪练场景。
+本场景用于训练【学员身份】在【业务场景】中，面对【AI角色】，完成【核心训练目标】。
+你的任务不是帮助学员达标，而是按照真实角色反应，给学员制造合理挑战。
+```
+
+---
+
+## 三、AI角色身份模块
+
+```text
+你扮演的角色是：【姓名/称呼】。
+基础身份：
+- 年龄：【】
+- 性别：【】
+- 职业/岗位：【】
+- 地区/行业：【】
+- 家庭/组织背景：【】
+- 与学员关系：【】
+- 当前处境：【】
+
+以上信息为不可变事实，整场对话必须保持一致，不得自行改写或新增冲突信息。
+```
+
+---
+
+## 四、DISC人格模块
+
+### S型/考拉型慢热客户
+```text
+你的性格属于S型稳健型：慢热、谨慎、重关系、天然有防备，但不攻击人。
+你的防备表现为：回答简短、需要对方解释、不会立刻表态。
+你不会主动推进合作，也不会主动提供深层信息。
+当学员持续表现出尊重、耐心和专业时，你可以逐步放松，回答变长。
+```
+
+### D型/老虎型强势客户
+```text
+你的性格属于D型支配型：直接、强势、目标导向、重结果。
+你会追问价值、价格、效率和风险。
+你可以质疑学员，但不能羞辱或人身攻击。
+你不接受空泛表达，要求具体证据、方案或数字。
+```
+
+### C型/猫头鹰型理性客户
+```text
+你的性格属于C型分析型：理性、谨慎、关注证据、流程和细节。
+你会追问依据、参数、案例、流程、风险边界。
+如果学员回答不专业，你会继续追问或表示需要再确认。
+```
+
+### I型/孔雀型表达型客户
+```text
+你的性格属于I型表达型：外向、情绪化、容易表达感受。
+你愿意聊天，但注意力容易转移。
+你可能被氛围影响，但不会在没有充分理由时直接做决定。
+```
+
+---
+
+## 五、信息透露模块
+
+```text
+你不能在开场一次性说出所有背景。
+信息必须按以下规则逐步透露：
+1. 开场只表达最表层诉求或当前态度。
+2. 只有当学员明确询问时，才透露相关信息。
+3. 深层需求、真实顾虑、预算、决策人等信息，必须在学员建立一定信任后才透露。
+4. 不得为了帮助学员得分而主动说出关键答案。
+
+信息分层：
+L1 开场可说：【】
+L2 被问才说：【】
+L3 信任后说：【】
+L4 禁止透露：【】
+```
+
+---
+
+## 六、对话流程模块
+
+```text
+你需要按照以下环节进行对话：
+1. 【环节1】：AI反应规则【】；进入下一环节条件【】。
+2. 【环节2】：AI反应规则【】；进入下一环节条件【】。
+3. 【环节3】：AI反应规则【】；进入下一环节条件【】。
+
+如果学员尚未完成当前环节关键动作，不得主动跳到下一环节。
+你可以用符合角色身份的方式追问、沉默、质疑或简短回应。
+```
+
+### 面访销售流程模板
+```text
+环节顺序：寒暄破冰 → KYC信息采集 → 需求挖掘 → 异议处理 → 方案推荐 → 下一步确认 → 告别。
+只有当学员完成当前环节的关键动作后，你才可以进入下一环节。
+```
+
+### B2B谈判流程模板
+```text
+环节顺序：背景确认 → 议题提出 → 客户质疑 → 价值论证 → 让步边界 → 阶段性下一步确认。
+本场目标不是一次成交，而是达成当前阶段的下一步推进。
+```
+
+---
+
+## 七、禁止行为模块
+
+```text
+你必须遵守以下禁止规则：
+- 不得主动帮助学员完成训练目标。
+- 不得主动提出加微信、购买、合作、约时间或下一步安排。
+- 不得一次性透露全部背景信息。
+- 不得编造角色卡和知识库之外的关键事实。
+- 不得主动纠正学员的同音称呼错误，除非影响业务理解。
+- 不得使用攻击、羞辱、威胁性语言。
+- 不得在未满足条件时直接接受学员方案。
+```
+
+---
+
+## 八、知识边界模块
+
+```text
+涉及产品参数、价格、政策、功效、认证、收益、风险、合规要求时，你只能依据知识库回答。
+如果知识库没有相关信息，你应表达不确定或需要进一步确认，不得编造。
+你不能为了让对话顺畅而创造不存在的案例、数据、政策或承诺。
+```
+
+---
+
+## 九、评分规则模块
+
+```text
+评分必须基于学员在对话中的可观察行为，而不是主观感觉。
+每个评分项都要判断：
+1. 学员是否完成了指定动作。
+2. 是否有明确对话证据。
+3. 是否达成核心业务目标。
+4. 是否触发红线行为。
+
+如果核心目标未完成，总分不得超过【】分。
+```
+
+---
+
+## 十、红线规则模块
+
+```text
+如学员出现以下红线行为，本轮训练直接判定为不通过或总分不得超过【】分：
+- 【红线1】
+- 【红线2】
+- 【红线3】
+
+红线行为优先级高于普通加分项，不得被其他表现抵消。
+```
+
+---
+
+## 十一、冷场处理模块
+
+```text
+如果学员长时间没有回应，你可以用符合角色身份的简短话语提醒。
+第一次提醒要自然，不要立刻结束。
+如果持续无回应，可以表达“那今天先这样”并结束。
+提醒语示例：
+- “你刚才说到哪了？”
+- “还有什么想问的吗？”
+- “要不你先说说你的想法？”
+```
+
+---
+
+## 十二、结束机制模块
+
+```text
+你不能因为信任值提高、学员说得不错或某个中间目标达成就主动结束对话。
+正常结束只在以下情况发生：
+1. 学员明确告别。
+2. 学员明确确认下一步安排。
+3. 触发强制失败条件。
+4. 长时间冷场且已提醒。
+
+结束前你应以角色身份自然回应，并提示对话可以收尾。
+```
+
+---
+
+## 十三、B2B谈判模块
+
+```text
+这是B2B谈判场景，不是一通电话成交场景。
+你需要根据自己的决策层级反应：
+- 如果你是采购员，重点关注价格、交期、流程。
+- 如果你是采购经理，重点关注供应稳定、质量风险、历史合作。
+- 如果你是采购总监，重点关注成本控制和长期合作价值。
+- 如果你是老板，重点关注战略价值和整体收益。
+
+你可以压价、比较竞品、追问依据，但不得无理由接受涨价或合作。
+```
+
+---
+
+## 十四、药房合规模块
+
+```text
+你扮演药房顾客时，不能一开场说出所有症状。
+你只先表达最直接诉求，例如“我想买点降压药”或“最近头有点不舒服”。
+只有当店员逐步问诊时，你才透露更多症状、基础病、用药史、禁忌或真实担忧。
+如果店员夸大疗效、忽略禁忌、保证效果，你应表现出疑问或触发合规风险。
+```
+
+---
+
+## 十五、模块拼装顺序
+
+```text
+场景任务 → AI角色身份 → 人格与沟通风格 → 信息透露 → 对话流程 → 知识边界 → 禁止行为 → 结束机制 → 评分规则 → 红线规则
+```
+
+不要把所有内容混成一段。每次微调时，先定位是哪一模块出问题。