@sokeai/cli 1.0.66 → 1.0.68

package/skills/ai-coach-director/coaching/prompt-engineer/parts/part3-flow.md

@@ -0,0 +1,72 @@
+### Part3：流程设置 (骨架)
+
+陪练的"骨架"，规定对话的推进方式、节奏和SOP。
+
+> ⚠️ **Part3 的每个字段都是 `part3-operations.json` 的直接来源，必须完整输出，不缩略不改写。**
+
+#### 必填项
+
+* **开场引导语：** 完整原文，不可缩略。AI说出的第一句话或旁白描写的完整场景。
+  - 模式A (AI开场): AI说出第一句话，写完整台词。
+  - 模式B (旁白开场): 旁白描述场景，写完整场景文案。
+  - → 直接来源 `update_basic.opening_dialogue`
+
+* **开场语类型：** `text` 或 `voice`。
+  - → 直接来源 `update_basic.opening_dialogue_type`
+
+* **对话环节 (SOP)：** 每个环节必须包含以下 4 个字段，不可缺一：
+  - **环节名：** 简短概括本环节主题（4-10 字），如"临床需求切入"、"破冰确认"。
+    - → 直接来源 `add_conversation_step.data.step_name`（**不是** `name`）
+  - **学员目标：** 完整原文，描述学员在该环节要达成的具体目标，必须可观察可评分。
+    - → 直接来源 `add_conversation_step.data.student_objective`
+  - **AI任务：** 完整原文，描述 AI 在该环节的行为指令，必须包含 IF-THEN 逻辑、环节进入条件和环节退出条件。平台没有独立的进入/退出条件字段，这三部分必须整合在同一段 AI任务 中。
+    - → 直接来源 `add_conversation_step.data.ai_task`
+  - **最大对话轮次：** 整数，控制该环节长度。
+    - → 直接来源 `add_conversation_step.data.max_rounds`
+
+#### 生成要求
+
+1. 每个环节的「学员目标」必须和 Part1 考核关键点一一对应。
+2. 每个环节的「AI任务」必须包含明确的触发条件和分支逻辑（IF-THEN）。
+3. 环节数建议 3-7 个，不宜过多或过少。
+4. 环节之间逻辑递进，前一个环节的完成度自然触发下一个环节。
+5. **所有文案字段（开场语、学员目标、AI任务）必须完整输出，不缩略改写**，否则 `part3-operations.json` 生成时会发生内容不一致。
+
+#### 推荐输出格式
+
+```markdown
+## Part3：流程设置
+
+### 开场引导语
+[完整原文，不缩略]
+
+### 开场语类型
+text / voice
+
+### 环节 1：[环节名]
+- **学员目标：** [完整原文]
+- **AI任务：**
+  - **环节进入条件：** [该环节何时触发]
+  - **AI行为指令：** [完整原文，含 IF-THEN 逻辑，每个角色的台词和触发条件]
+  - **环节退出条件：** [完成哪些条件后进入下一环节]
+- **最大对话轮次：** [整数]
+
+### 环节 2：[环节名]
+...
+```
+
+#### 与后续 Part 的依赖关系
+
+- Part3 修改后，Part4 评分标准必须联动复核。
+- Part3 修改后，Part5 教练设置中的「收尾话术」「SOP 摘要」需要同步更新。
+- Part3 的环节数变动后，Part4 的评分维度可能需要重新对齐。
+
+#### 常见错误
+
+- 缺少环节名，直接写学员目标/ AI任务 → JSON 生成时 `step_name` 为空导致平台拒绝
+- 学员目标写成空泛口号而非可观察行为
+- AI任务缺少 IF-THEN 触发逻辑
+- AI任务中遗漏环节进入条件和环节退出条件 → 平台无独立字段存放，必须整合到AI任务中
+- 环节进入/退出条件与AI角色行为分拆为独立段落 → 应整合在同一段AI任务内，按"进入条件 → 角色行为 → 退出条件"顺序
+- 文案缩略或改写 → JSON 内容与用户确认的 Part3 不一致
+- 最大对话轮次未写或写成非整数

package/skills/ai-coach-director/coaching/prompt-engineer/parts/part4-scoring.md

@@ -0,0 +1,87 @@
+### Part4：评分标准 (标尺)
+
+陪练的"标尺"，量化训练的成效。
+
+> ⚠️ **Part4 的每个字段都是 `part4-operations.json` 的直接来源，必须完整输出，不修改权重、不重命名维度、不增减维度数量。**
+>
+> **生成顺序**：必须按「评分标准名称 → 评分标准描述 → 评分维度列表」的顺序输出。
+>
+> **一票否决规则已嵌入维度**：不再输出独立的一票否决章节。每个评分维度的 `scoring_rule` 字段末尾直接写明该维度的一票否决条件。
+
+#### 必填项
+
+* **评分标准名称：** 对整套评分体系的命名，如"电话约访能力评分标准"、"面访沟通能力评分标准"。要求简洁、概括性强（8-20 字）。
+  - → 直接来源 `data.config.criteria_data.name`
+
+* **评分标准描述：** 对整套评分体系的整体说明，交代评分目的、适用场景、评分方式。完整原文，不可缩略。
+  - → 直接来源 `data.config.criteria_data.description`
+
+* **评分维度：** 至少 2 个，建议 3-6 个。每个维度必须包含：
+  - **维度名称：** 简短标识（4-10 字），如"适应症准确性"、"价值传递"。
+    - → 直接来源 `data.config.criteria_data.dimensions[].name`
+  - **维度 code：** 英文字段名，如 `indication_accuracy`、`value_delivery`。
+    - → 直接来源 `data.config.criteria_data.dimensions[].code`
+  - **维度描述：** 完整原文，解释该维度评估什么、为什么重要。
+    - → 直接来源 `data.config.criteria_data.dimensions[].description`
+  - **权重：** 整数（0-100），所有维度权重之和应为 100。
+    - → 直接来源 `data.config.criteria_data.dimensions[].weight`
+  - **评分规则：** 完整原文，描述具体给分/扣分标准，建议分 3-5 档。
+    - → 直接来源 `data.config.criteria_data.dimensions[].scoring_rule`
+  - **评分点列表：** 可枚举的检查项，每个评分点一条。
+    - → 直接来源 `data.config.criteria_data.dimensions[].criteria[]`
+
+* **一票否决规则：** 每个评分维度的 `scoring_rule` 中应包含该维度的一票否决条件。不再使用全局一票否决字段。
+  - 格式示例：`"以下行为触犯即该维度0分且总分不合格：1. ... 2. ..."`
+  - 一票否决条件必须在维度评分规则中明确写出，不可遗漏
+
+#### 生成要求
+
+1. 评分标准名称必须能概括整个评分体系，不空泛。
+2. 评分标准描述必须回答：这套评分体系评什么、为什么这样评、适用于什么场景。
+3. 每个评分维度必须与 Part1 考核关键点一一对应。
+4. 每个维度的评分规则必须可执行、可观察，不能用空泛形容词。
+5. 评分规则支持**过程考核**（是否使用了标准话术）和**结果考核**（是否达成结局）。
+6. 每个维度的评分规则中必须包含该维度的一票否决条件，明确、无歧义，AI 能直接判断是否触发。
+7. **所有文案字段（评分标准名称、描述、维度名称、维度描述、评分规则）必须完整输出，不缩略改写**，否则 `part4-operations.json` 生成时会发生内容不一致。
+
+#### 推荐输出格式
+
+```markdown
+## Part4：评分标准
+
+### 评分标准名称
+[8-20 字，概括整套评分体系]
+
+### 评分标准描述
+[完整原文，交代评分目的、适用场景、评分方式，不缩略]
+
+### 评分维度
+
+#### 维度 1：[维度名称]（[code]）— 权重 [weight]%
+- **描述：** [完整原文，解释评估什么]
+- **评分规则：** [完整原文，3-5 档给分/扣分标准，末尾包含该维度的一票否决条件]
+- **评分点：**
+  1. [评分点 1]
+  2. [评分点 2]
+  ...
+
+#### 维度 2：[维度名称]（[code]）— 权重 [weight]%
+...
+```
+
+#### 与后续 Part 的依赖关系
+
+- Part4 修改后，Part5 教练设置中的通关分数、通关难度如有联动需求需同步更新。
+- Part4 维度变动后，Part3 的环节学员目标可能需要重新对齐。
+- Part4 权重求和 ≠ 100 时，Part5 同步阶段会被平台拒绝。
+
+#### 常见错误
+
+- 跳过评分标准名称和描述，直接从维度列表开始 → 严禁，必须先生成名称+描述再列维度
+- 只写维度名称和权重，不写描述/评分规则 → JSON 生成时缺失字段
+- code 用了中文 → 平台可能校验不通过
+- 权重之和不为 100
+- 评分规则写"优秀/良好/一般"但没定义区分标准
+- 一票否决条件写成模糊建议而非硬规则
+- 一票否决独立成章而未嵌入各维度 `scoring_rule` → 必须嵌入
+- 文案缩略或改写 → JSON 内容与用户确认的 Part4 不一致

package/skills/ai-coach-director/coaching/prompt-engineer/parts/part5-constraints.md

@@ -0,0 +1,48 @@
+### Part5：教练设置
+
+陪练的"外部约束"，规定练习时长、次数、通关门槛等配置。
+
+> ⚠️ **Part5 练习配置已写死为固定值，所有场景统一使用，不允许按场景调整。**
+
+#### 固定配置（写死，不可改）
+
+| 配置项 | 固定值 | JSON 字段 | 说明 |
+|--------|--------|-----------|------|
+| 练习时间 | **默认关闭** | `min_practice_duration`: 0, `max_practice_duration`: 0 | 练习时间默认关闭，不限制时长 |
+| 最大练习次数 | **10** | `max_practice_attempts`: 10 | 写死，不可改 |
+| 通关分数 | **60** | `passing_score`: 60 | 写死，不可改 |
+| 完成规则 | **all_steps** | `completion_rule`: "all_steps" | 全环节完成，写死 |
+| AI 助答 | **开启** | `ai_assistance_enabled`: true | 写死，不可改 |
+| 通关难度 | **中** | `pass_difficulty`: 2 | 写死，1=低 2=中 3=高 |
+
+#### 生成要求
+
+1. **Part5 不再动态生成配置值**：所有配置项按上表写死，不根据场景类型调整。Part5 的"生成"实为固定模板输出。
+2. Part5 不输出收尾话术、SOP 流程摘要、考核关键点摘要——这些内容已在 Part1 创建场景（`step1-create.json`）或 Part3 中同步。Part5 仅负责练习配置。
+3. `part5-operations.json` 生成时直接使用上表固定值，不做任何修改。
+
+#### 固定输出格式（写死模板）
+
+```markdown
+## Part5：教练设置
+
+### 练习配置（所有场景统一）
+- 练习时间：默认关闭
+- 最大练习次数：10
+- 通关分数：60
+- 完成规则：all_steps（全环节完成）
+- AI 助答：开启
+- 通关难度：中
+```
+
+#### 与后续同步的关系
+
+- Part5 是创建型同步的最后一个 Part，应用成功后输出完成摘要。
+- Part5 仅同步练习配置（时长/次数/分数/难度/助答/完成规则），不包含收尾话术、SOP 摘要或考核关键点——这些已在前序 Part 中同步。
+- 若知识库内容需绑定，另行触发 `soke-cli ai-training +sync` / `+bind-scenario` 知识包路径。
+
+#### 常见错误
+
+- 试图按场景调整 Part5 配置值 → 禁止，所有值已写死
+- JSON 中使用了非固定值 → 必须与上表完全一致
+- Part5 中输出了收尾话术/SOP摘要/考核关键点摘要 → 这些字段已在前序 Part 同步，不应重复出现在 Part5

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

@@ -0,0 +1,217 @@
+---
+name: prompt-engineer
+description: AI陪练提示词工程技能。当用户需要创建、修改或优化"AI陪练"后台的系统提示词时触发。按 Part1-Part5 逐段生成、逐段确认、逐段同步:Part1 基础信息、Part2 AI角色设定、Part3 流程设置、Part4 评分标准、Part5 教练设置,确保各设置项之间逻辑严密、相互支撑。触发关键词:AI陪练提示词、提示词优化、场景配置、后台设置项。
+---
+
+# AI陪练提示词专家 (Prompt Engineer)
+
+## 双层分工
+
+本技能内部两层分工:
+
+| 层 | 职责 | 文件 |
+|---|---|---|
+| **coaching** | 纯内容生成:接收需求 → 输出 Part1-5 提示词 + 知识库 | 本文件 |
+| **platform** | 平台同步:弹窗确认(优先 render_ui/按钮弹窗) + JSON 生成 + CLI 命令 + 字段映射 | `../../platform/interaction.md` + `../../platform/sync-engine.md` |
+
+prompt-engineer 只管"产出什么内容",platform 层管"怎么确认、怎么同步"。两层在本文件中显式引用。
+
+---
+
+## 角色定义
+
+你是一名世界顶级的系统提示词编写与优化专家,专精于"AI陪练"领域。核心任务是协助分析、创建和微调用于"AI陪练"后台的提示词,确保各个设置项之间逻辑严密、相互支撑,最终打造出高效、拟真、且能达成训练目标的陪练场景。
+
+> **标杆参考**:已交付的标杆案例已内置于 `references/cases/` 目录,生成时根据场景类型选择对应标杆。涵盖:高对抗博弈型(门店销售)、餐饮服务型、流程SOP演练型、零售SOP+知识考核型、B2B物流销售型、金融电话约访型、景区应急处置型、物业客服报修型、医疗器械B2B型、中医辨证关联销售型、上门招募型等。
+
+> **平台差异参考**:凡涉及 MentorAI 平台字段、operation type、preview/apply 验收规则,先看 `../../references/platform-api-pitfalls.md`,再生成 Part2-Part5 的平台映射内容。
+
+> **命令模板参考**:凡需要复制或核对场景 CLI 命令,统一参考 `../../references/verified-cli-cheatsheet.md`,不要从零手写顶层 `soke-cli +...`。
+
+## 核心知识库:AI陪练后台设置项详解
+
+必须完全理解并牢记以下五个部分构成的后台设置框架,进行任何调整时都需开展全局一致性思考,确保修改部分与其他部分(特别是考核点、AI任务和评分标准)保持高度同步。
+
+---
+
+> **Part1-Part5 框架定义已拆分至 `parts/` 目录,按需读取:**
+> - `parts/part1-basic.md` - 基础信息(北极星):场景名称 + 标签 + 描述 + 考核关键点 + 依赖规则
+> - `parts/part2-roles.md` - AI角色设定(灵魂):核心输出协议 + 动态状态机 + 双层逻辑 + AI技能卡 + 角色库
+> - `parts/part3-flow.md` - 流程设置(骨架):开场引导 + SOP环节 + IF-THEN 触发逻辑
+> - `parts/part4-scoring.md` - 评分标准(标尺):维度定义 + 权重规则 + 一票否决 + A-E等级
+> - `parts/part5-constraints.md` - 陪练设置(系统约束):时间/轮次/完成规则 + 知识库
+>
+> prompt-engineer 在生成每一段内容时,必须按 Part 粒度读取对应 part 文件作为框架指导。
+
+## 工作流程
+
+### Step 0:环境前置检测
+
+创建任务开始时，先读取 `../../references/env-check.md`，按顺序完成：
+
+1. Node.js 检查
+2. `soke-cli` 安装检查
+3. **登录状态检查与自动登录**：执行 `soke-cli config show`
+   - ✅ 含 `user_token` → 通过
+   - ❌ 无 `user_token` → **立即执行 `soke-cli auth login`**，自动打开浏览器完成 OAuth 授权。若浏览器未打开，复制终端链接手动完成。登录后重新检测
+4. 企业绑定检查
+
+**步骤 3 自动登录关键规则**：`soke-cli auth login` 会自动调用系统默认浏览器打开授客AI开放平台授权页面，用户在浏览器中完成授权即可。授权成功后 Token 自动保存至 `~/.soke-cli/config.json`。**未登录时禁止跳过，必须执行登录后再继续。**
+
+任一步未通过，先修复环境，再进入创建流程。
+
+### Step 1:输出 Part1 → 弹窗确认 → 生成封面图 → 上传 → 创建场景
+
+1. 基于用户需求和业务资料，读取 `parts/part1-basic.md`，仅输出 Part1 内容。
+2. **⛔ 展示检查（必做，弹窗前闸门）**：确认 Part1 全部内容已在对话中逐字段完整展示——场景名称 + 全部标签 + 场景描述全文（训练对象/业务情境/训练目标/边界条件全部段落）+ 考核关键点全部条目 + 场景语言。**未完整展示 → 禁止弹窗，回退补充。**
+3. 按 `../../platform/interaction.md` 的「模板 1」弹窗确认 Part1（弹窗策略见 interaction.md 附录 A）。
+4. 选「确认，同步到平台（推荐）」→ 根据 `../../platform/sync-engine.md` 生成 `step1-create.json`。
+5. **生成场景封面图**：根据 Part1 的场景名称、标签、行业等信息，调用大模型图片生成能力，生成一张 4:3 比例的场景封面图，保存为 `./scenario-cover.png`。
+   - 封面风格按行业类型匹配：展会/培训 → 明亮商务、医药 → 学术医疗、销售/谈判 → 高压剧集感、餐饮/服务 → 温馨生活、金融 → 专业稳重
+   - 封面应体现场景核心要素（行业、角色、互动感），避免抽象无意义的装饰图
+6. **上传封面**：执行 `soke-cli ai-training +upload-scenario-cover --file ./scenario-cover.png --pretty`，从返回结果提取 CDN URL，写入 `step1-create.json.scenario_cover`。
+7. 自动执行：`soke-cli ai-training +create-scenario --request-file ./step1-create.json --pretty`。
+   如需复制完整命令模板，统一参考 `../../references/verified-cli-cheatsheet.md`。
+8. 从返回结果提取 `scenario_id`，写入 `state-snapshot.json`。
+9. **创建后验证**：执行 `soke-cli ai-training +get-scenario --scenario-id <id> --pretty`，确认 `key_points`、`description`、`name`、`tags` 均已正确写入平台。
+   - 若 `key_points` 为空或缺失，检查 `step1-create.json` 中 `key_points` 是否为字符串格式（非数组）
+   - 验证通过后再继续 Part2
+10. 自动提取 `scenario_id`，立即继续 Part2。
+11. 选「内容需要微调」→ 调整 Part1，重新输出，再次用模板 1 弹窗。
+
+> ⚠️ **Part1 确认后强制同步**：模板 1 不再提供「取消，重新来」选项。一旦确认 Part1，场景必须创建到平台。
+
+### Step 2:输出 Part2 → 弹窗确认 → 自动预览并应用
+
+1. 读取 `state-snapshot.json` 中已确认的 Part1 和 `scenario_id`,生成 Part2。
+2. 默认直接生成 Part2;仅当资料特别杂、需要抽取 2-3 类典型客户、或用户明确要求按需画像时,才调用 `role-profiler`,结果缓存到 `state-snapshot.json` 的 `cached.role_profile`。
+3. 生成 Part2 角色卡内容（名称、描述、性格、背景、MBTI、沟通风格、禁忌等）。
+4. 头像和语音在 Part2 阶段不必准备：Part2 apply 后 `sync-engine.md` 按 `references/role-resource-matching.md` 自动拉取系统资源匹配并回填。
+5. 禁止把 `knowledge_level` 写成单个字符串；禁止只产出裸 `role_data` 而不考虑完整 custom role 外壳。
+6. **⛔ 展示检查（必做，弹窗前闸门）**：确认 Part2 全部内容已在对话中逐字段完整展示——OS 整体设定全文（A1-A7 + 价格防御模板 + 考核反馈 + AI技能配置全部章节完整原文）+ 每个角色卡（名称/描述/沟通风格/背景四段全文/MBTI/性格/标签/禁忌/知识水平 逐字段）。**未完整展示 → 禁止弹窗，回退补充。**
+7. 按 `../../platform/interaction.md` 的「模板 2」弹窗确认 Part2（弹窗策略见 interaction.md 附录 A）。
+8. 内部运行 Part2 一致性扫描（含 background 四维完整性检查：每个角色的 background 是否包含了四段深度画像的全部完整原文——我是谁/我的困扰/我的过往经历/我今天的心态）。无告警不输出;有告警则在确认前简要提示。
+9. 选「确认」→ 生成 `part2-operations.json`。
+10. **⚠️ JSON 写入后、preview 前强制闸门**：逐字比对每个角色 `role_data.background` 与 Part2 确认弹窗中展示的「角色背景」文本是否完全一致（标点、措辞、空格均不可有差异）。同时执行 B4.1 四维完整性检查。**任一项不通过 → 驳回，修正后重新走闸门，禁止直接 preview。**
+11. 自动执行 Part2 预览与应用 CLI,使用最新 `updated_at/base_updated_at`。
+   如需复制完整命令模板,统一参考 `../../references/verified-cli-cheatsheet.md`。
+12. 应用成功后更新 `state-snapshot.json`。
+13. 自动获取最新 `updated_at/base_updated_at`,立即继续 Part3。
+14. 选「调整角色设定」→ 调整 Part2,重新输出,再次弹窗。
+15. 选「重设角色设定」→ 回到内容层重新生成。
+
+### Step 3:输出 Part3 → 弹窗确认 → 自动预览并应用
+
+1. 读取 `state-snapshot.json` 中已确认的 Part1-Part2 和最新 `updated_at`,生成 Part3。
+2. **⛔ 展示检查（必做，弹窗前闸门）**：确认 Part3 全部内容已在对话中逐字段完整展示——开场引导语完整原文 + 每个环节（环节名/学员目标完整原文/AI任务完整原文含环节进入条件+IF-THEN逻辑+环节退出条件/最大轮次，题库和话术库不可省略）。**未完整展示 → 禁止弹窗，回退补充。**
+3. 内部运行 Part3 一致性扫描。无告警不输出;有告警则在确认前简要提示。
+4. 按 `../../platform/interaction.md` 的「模板 3」弹窗确认 Part3（弹窗策略见 interaction.md 附录 A）。
+5. 选「确认」→ 生成 `part3-operations.json`。
+6. 自动执行 Part3 预览与应用 CLI。
+   如需复制完整命令模板,统一参考 `../../references/verified-cli-cheatsheet.md`。
+7. 应用成功后更新状态,立即进入 Part4。
+8. 选「调整流程设置」→ 调整 Part3,重新输出,再次弹窗。
+9. 选「重设流程设置」→ 回到内容层重新生成。
+
+### Step 4:输出 Part4 → 弹窗确认 → 自动预览并应用 → 验收评分已同步
+
+1. 读取 `state-snapshot.json` 中已确认的 Part1-Part3 和最新 `updated_at`,生成 Part4。
+2. **⛔ 展示检查（必做，弹窗前闸门）**：确认 Part4 全部内容已在对话中逐字段完整展示——评分标准名称 + 评分标准描述完整原文 + 每个维度（名称/描述/权重/scoring_rule 完整含分档标准和一票否决全文/criteria 完整列表/维度 code）。**未完整展示 → 禁止弹窗，回退补充。**
+3. 内部运行 Part4 一致性扫描（评分维度与 Part1 key_points 一一对应、权重之和 = 100、每个维度 scoring_rule 含一票否决条件）。
+4. 按 `../../platform/interaction.md` 的「模板 4」弹窗确认 Part4（弹窗策略见 interaction.md 附录 A）。
+5. 选「确认」→ 生成 `part4-operations.json`。
+   - 使用 `replace_scoring_criteria_config` operation type
+   - 必须包含 `scenario_criteria_id`、`customization_level`、`is_custom_criteria`、`customized_fields` 四个外壳字段
+   - 必须用 `data.config.criteria_data` 包裹（参考 `../../references/platform-api-pitfalls.md` 第 2 条和 `../../platform/sync-engine.md` Part4 字段映射表）
+   - `criteria_data` 必须直接在 `config` 下（`data.config.criteria_data`），中间不可缺失层级
+   - `criteria_data` 内部必须包含 `source_type`、`total_weight`、`tags`
+   - 每个维度必须包含 `id`（格式 `dim_{code}`）和 `sort_order`（从 1 递增）
+   - 不再使用全局 `one_vote_veto` 字段；一票否决条件已嵌入各维度 `scoring_rule` 末尾
+6. 自动执行 Part4 预览 CLI：`soke-cli ai-training +preview-scenario-update --operations-file ./part4-operations.json ...`
+7. 预览通过后立即执行 Part4 应用 CLI：`soke-cli ai-training +apply-scenario-update --operations-file ./part4-operations.json ...`
+   如需复制完整命令模板,统一参考 `../../references/verified-cli-cheatsheet.md`。
+8. **apply 后强制验收**：立即执行 `soke-cli ai-training +get-scenario --scenario-id <id> --pretty`，验证返回结果中 `scoring_criteria_config` 非空且含 `criteria_data.dimensions`。
+9. 验收通过后更新 `state-snapshot.json` 的 `confirmed_data.part4` 和 `applied.part4`。
+10. 立即进入 Part5。
+11. 选「调整评分标准」→ 调整 Part4,重新输出,再次弹窗。
+12. 选「重设评分标准」→ 回到内容层重新生成。
+
+> ⚠️ **Part4 评分标准必须同步到平台**：Part4 不可仅做内容输出而不同步。评分标准未通过平台验收（`get-scenario --pretty` 中 `scoring_criteria_config` 为空或缺少 `criteria_data.dimensions`）时，不得进入 Part5。
+> ⚠️ **Part4 不生成知识库内容**：提示词文档中可保留金牌话术作为参考资料，但不纳入 Part4 operations JSON、不缓存到 state-snapshot、不同步到平台。`golden_dialogue_description` 仅包含 Part3 SOP 流程摘要。
+> ⚠️ **Part4 scoring_rule 禁止嵌入示例话术**：评分规则的各档描述中禁止出现引号包裹的示例对话（如"太好了谢谢姐！""最近怎么样"等），这些属于金牌话术库内容。scoring_rule 仅描述行为标准和得分条件，不写具体台词示例。criteria 评分点同样适用此规则。
+
+### Step 5:输出 Part5 → 弹窗确认 → 自动完成同步
+
+1. 读取 `state-snapshot.json` 中已确认的 Part1-Part4 和最新 `updated_at`。
+2. 输出 Part5 固定模板（练习配置已写死：时长关闭、最大次数 10、通关分数 60、完成规则 all_steps、AI助答开启、难度中）。
+3. **⛔ 展示检查（必做，弹窗前闸门）**：确认 Part5 练习配置固定模板已在对话中完整展示（练习时间默认关闭/最大练习次数/通关分数/完成规则/AI助答/通关难度全部数值和说明）。**未完整展示 → 禁止弹窗，回退补充。**
+4. 按 `../../platform/interaction.md` 的「模板 5」弹窗确认 Part5（弹窗策略见 interaction.md 附录 A）。
+5. 选「确认」→ 生成 `part5-operations.json`。
+   - Part5 operations 使用固定值：`min_practice_duration`=0, `max_practice_duration`=0, `max_practice_attempts`=10, `passing_score`=60, `pass_difficulty`=2, `completion_rule`="all_steps", `ai_assistance_enabled`=true
+   - JSON 生成后逐项核对每个字段值与固定模板一致
+   - 确认不包含收尾话术、SOP 摘要、考核关键点摘要（这些已在 Part1 创建场景或 Part3 中同步）
+6. 自动执行 Part5 预览与应用 CLI。
+   如需复制完整命令模板,统一参考 `../../references/verified-cli-cheatsheet.md`。
+7. 输出完成摘要(场景 ID、已同步模块、是否有后续待办)。
+8. 选「不确认，跳过同步」→ 仅做内容输出，不生成 JSON。
+
+> ⚠️ **Part5 练习配置已写死**：所有场景统一使用固定模板，不提供"调整"或"重设"选项。Part5 仅负责练习时长/次数/通关/助答等配置项，收尾话术、SOP 流程摘要、考核关键点摘要已在 Part1（`step1-create.json.key_points`）和 Part3（`opening_dialogue`、`closing_dialogue`）中同步到平台。
+
+### 参考标杆(全流程通用)
+
+根据场景类型,参考 `references/cases/` 中对应类型的已交付案例作为结构与风格参照。涵盖:高对抗博弈型、餐饮服务型、流程SOP演练型、零售SOP+知识考核型、B2B物流销售型、金融电话约访型、景区应急处置型、物业客服报修型、医疗器械B2B型、中医辨证关联销售型、上门招募型等。
+
+### 按需调用上游技能(两种模式通用)
+
+- `role-profiler` → 仅在资料噪音高、需要多人群归纳或用户明确要求按需画像分析时调用;结果缓存到 `state-snapshot.json`。
+
+---
+
+## 质量标准
+
+- Part1的考核关键点与Part3的学员目标必须一一对应
+- Part3的AI任务必须包含环节进入条件+角色行为指令（含IF-THEN逻辑）+环节退出条件三段，且与Part4的评分维度必须逻辑一致
+- Part2的AI技能必须能支撑Part3各环节的触发逻辑
+- 每个 Part 的修改都必须标记其下游受影响 Part,并在确认前提示是否需要联动复核
+- 所有角色卡必须严格遵循上述格式,不可缺项
+- Part2 输出不需预设头像和语音：此阶段头像和语音字段留空或标"待匹配"。Part2 apply 后 `sync-engine.md` 自动执行资源匹配流程（`references/role-resource-matching.md`）回填 `avatar` / `voice_id`
+- **⚠️ `avatar` 必须用头像资源的 `url`，不是 `id`**：`+list-role-avatars` 返回的每一项同时含 `id` 和 `url`。写入 `ai_roles[].role_data.avatar` 时必须使用 `url`（如 `https://newsokeeditorcdn.soke.cn/public/ai/roles_avatars/lnf2.png`），严禁使用 `id`（如 `816d9390-...`）。平台不识别纯 ID 字符串作为头像。
+- **⚠️ `voice_id` 必须用声音资源的 `id`**：`+list-role-voices` 返回的 `id` 字段（如 `zh_female_shuangkuaisisi_emo_v2_mars_bigtts`），不是 `sample_url`。
+- **⚠️ `replace_ai_roles` 使用 `data.roles` 结构**（非 `data.ai_roles`），且必须为每个角色提供 `scenario_role_id` 便于后续 `patch_ai_role` 定位。
+- 如角色资料不足以生成上述平台字段,必须显式标注待补,而不是用 URL、空壳字段或猜测值硬写入
+- 禁止出现任何AI视角词汇("作为语言模型"、"我可以帮你")
+- 所有台词必须极度口语化,禁止书面语
+- 生成的提示词应与对应标杆类型的已交付提示词在结构完整性上保持一致。繁体语境场景需特别注意:产品知识内嵌、分龄触发逻辑、禁忌体系
+- 平台同步 JSON 必须写入独立文件,禁止在聊天中输出 JSON 正文(`sync-engine.md`)
+- **JSON 忠实搬运原则**：生成 `step1-create.json` / `part2/3/4/5-operations.json` 时，每个字段的值必须是已确认 Part 内容的 1:1 搬运，严禁在此阶段重新缩略、改写、扩写或重组文案。用户确认的 Part1 描述全文就是 `description` 的值，确认的 Part3 开场语全文就是 `opening_dialogue` 的值，以此类推
+  - **强制逐字对比检查**：JSON 生成后、preview 前，必须对照 `../../platform/sync-engine.md` 中「逐 Part 内容搬运检查清单」逐段验证——JSON 中的文案长度、措辞、编号、标点必须与原文完全一致。发现任何差异必须修正，不得以「大意相同」为由放过
+  - **重点关注易丢失内容**：Part2 整体设定 OS（A1-A7 全部要入 `ai_roles_overall_description`）
+  - **违规即驳回**：若 preview/apply 后发现 JSON 内容与用户确认的 Part 原文不一致，视为严重合规问题，直接回滚并重新生成对应 JSON
+
+---
+
+## 输出框架保护规则(2026-06-05新增, 2026-07-14修订)
+
+用户明确要求:搭建提示词/陪练内容时,`prompt-engineer` 的输出框架不要变。
+
+执行要求:
+
+1. 保持既有 Part1-Part5 输出框架、章节顺序和平台适配格式。
+2. 不重排整体结构。
+3. 不新增大量一级模块。
+4. Part4 评分标准仅输出评分维度、权重、评分规则、评分点，一票否决嵌入各维度 `scoring_rule` 中。不生成知识库内容。
+5. 知识库（金牌话术、异议处理话术等）仅在提示词文档中作为参考资料保留，不同步到平台、不对学员展示。
+
+---
+
+## 用户不可见内容清单
+
+以下内容在 prompt-engineer 流程中发生,但**不进入聊天**:
+
+| 内容 | 说明 |
+|---|---|
+| JSON 文件生成提示(如 "📄 同步文件已生成") | 文件名仅在 CLI 命令中自然出现 |
+| `state-snapshot.json` 写入 | 引擎内部接续机制 |
+| role-profiler 调用 / 缓存命中 | 引擎内部机制 |
+| 一致性扫描结果(无告警时) | 有告警才输出 ⚠️ |
+| 字段映射过程 | 全在 `sync-engine.md` 规则中 |