@sokeai/cli 1.0.76 → 1.0.77

package/skills/soke-ai-coach-director/references/role-resource-matching.md

@@ -0,0 +1,45 @@
+# Part2 平台资源自动匹配规则
+
+> Part2 用户确认后、生成 `part2-operations.json` 前，后台自动执行。头像/语音不在展示阶段预设，匹配结果随 `replace_ai_roles` 整包写入，不向用户二次确认。
+
+## 特征提取（映射为 CLI 过滤参数）
+
+**性别 gender**：男/先生/他/男性名字(建国、志强…)→`male`；女/女士/她/女性名字(芳、丽、敏…)→`female`；无则不传。优先级：name > description > background > MBTI推断。
+
+**年龄 age_group**：青年/25-35/新手→`youth`；中年/35-50/经理/主管→`middle-aged`；老年/50+/退休→`senior`；无则不传。优先级：background > description > name。
+
+## CLI 查询（v2.37：全重定向，禁止 --pretty 直出）
+
+```bash
+# 头像（全量重定向到 /tmp/avatars.json，Python 按性别/年龄过滤提取 url）
+soke-cli ai-training +list-role-avatars --lang zh --show-detail > /tmp/avatars.json 2>/dev/null
+# 声音（全量重定向到 /tmp/voices.json，Python 按性别过滤提取 id）
+soke-cli ai-training +list-role-voices --lang zh > /tmp/voices.json 2>/dev/null
+```
+
+> ⚠️ v2.37 起 `--gender` / `--age-group` 参数在 `+list-role-avatars` 不可用（CLI 不支持），改为全量重定向后 Python 本地过滤。`+list-role-voices` 支持 `--gender` 但仍重定向。
+
+**Python 提取示例**：
+```python
+import json
+avatars = json.load(open('/tmp/avatars.json'))
+# 按性别/年龄关键词过滤 title 字段
+for a in avatars:
+    if '男' in a.get('title','') and '高管' in a.get('title',''):
+        print(a['url'])  # 取第一个匹配
+        break
+```
+
+**P0-P3 选取**：P0 性别+年龄吻合取第 1 条 → P1 仅性别 → P2 仅年龄 → P3 全量第 1 条默认资源。降级链路：一阶 → 去 age-group → 去 gender → 全量，每次降级记录。
+
+## 写入规范
+
+- `role_data.avatar` = 头像 **URL**（来自 `+list-role-avatars` 的 `url` 字段，❌ 不能用资源 id）。
+- `role_data.voice_id` = 声音 **ID**（来自 `+list-role-voices` 的 `id` 字段，❌ 不能用 sample_url/名称）。
+- 头像+语音合并写入**同一个角色的 role_data**（随 `replace_ai_roles` 整包一次写入），禁止分开操作（分开会导致 updated_at 竞态）。
+
+## 验证与异常
+
+- apply 后 `get-scenario` 验证每个角色 avatar 非空 URL + voice_id 非空 ID，失败重读 updated_at 重试 1 次。
+- 仍失败或库查询失败 → 标注「资源匹配未完成」，**不阻断后续 Part**，仅影响发布闸门时提示。
+- soke-cli 不可用时降级 REST 回填（见 `platform/api-fallback.md`，匹配规则与 CLI 完全一致）。

package/skills/{ai-coach-director → soke-ai-coach-director}/references/self-improvement-examples.md

@@ -1,5 +1,7 @@
 # Entry Examples
 
+> **v2.35 标注：本文件仅微调型任务加载，创建型任务不读。**
+
 Concrete examples of well-formatted entries with all fields.
 
 ## Learning: Correction

package/skills/soke-ai-coach-director/references/self-learning-engine.md

@@ -0,0 +1,489 @@
+# 自主学习与自我进化引擎
+
+> **v2.35 标注：本文件仅微调型任务加载，创建型任务不读**（创建型只读 SKILL.md + exec-handbook + parts/ + 对应 SOP）。
+> 核心思想:每一次诊断纠错、闸门漏拦、资产选错、子技能调度失败、用户纠正,都被自动记录并推广为永久规则。
+> 本引擎是独立 self-improving-agent 思想与 AI 陪练领域的深度整合,在泛用框架之上注入了 12 个 AI 陪练专属 Area、诊断分流触发规则和陪练推广目标表。
+
+## 引擎架构
+
+```
+用户纠正 / 命令失败 / 闸门漏拦 / 新需求
+  ↓ 自动捕获
+├─ 修正/洞察/缺口/最佳实践 → .learnings/LEARNINGS.md
+├─ 命令失败/集成异常        → .learnings/ERRORS.md
+├─ 用户请求的新能力          → .learnings/FEATURE_REQUESTS.md
+  ↓ 自我反思(每次完成任务后)
+├─ 结果是否达到预期?
+├─ 哪里可以更好?
+├─ 这是反复出现的模式吗?
+  ↓ 模式检测(同类 ≥ 3 次 + 跨 ≥ 2 任务 + 30 天内)
+↓ 自动推广
+├─ 行为改进 → 本 SKILL.md(诊断标签/闸门/资产规则/调度流程)
+├─ 工具坑点 → TOOLS.md
+├─ 调度规则 → AGENTS.md
+├─ 长期记忆 → MEMORY.md
+└─ 高价值 → 提取为独立 skill
+```
+
+## 学习存储分层
+
+| 层级 | 位置 | 容量限制 | 加载策略 |
+|------|------|---------|---------|
+| **HOT** | `.learnings/` 中 Priority=critical/high 且 Status=pending 的条目 | 无限制 | 任务开始时扫描 |
+| **WARM** | `.learnings/` 中 Priority=medium 或已 resolved 的条目 | 无限制 | 按 Area 匹配时加载 |
+| **COLD** | 已 promoted / wont_fix / 90 天以上未触发的条目 | 无限 | 显式查询时加载 |
+
+### 分层规则
+
+- Pattern 触发 3 次/7 天内 → 提升 Priority 至 high
+- Pattern 30 天未触发 → 降 Priority 至 low
+- Pattern 90 天未触发 → 归档为 COLD(不改动,仅标记)
+- **绝不删除**已确认的学习条目
+
+## 学习文件初始化
+
+首次使用时,确保 `.learnings/` 目录及文件存在:
+
+```bash
+mkdir -p .learnings
+[ -f .learnings/LEARNINGS.md ] || printf "# AI 陪练 - 学习日志\n\n修正、洞察、知识缺口、最佳实践。\n\n**类别**: correction | insight | knowledge_gap | best_practice\n\n---\n" > .learnings/LEARNINGS.md
+[ -f .learnings/ERRORS.md ] || printf "# AI 陪练 - 错误日志\n\n命令失败与集成异常。\n\n---\n" > .learnings/ERRORS.md
+[ -f .learnings/FEATURE_REQUESTS.md ] || printf "# AI 陪练 - 功能请求\n\n用户请求的新能力。\n\n---\n" > .learnings/FEATURE_REQUESTS.md
+```
+
+不覆盖已有文件。**绝不记录**密钥、token、完整对话抄本或敏感环境变量。
+
+---
+
+## AI 陪练专属 Area 标签
+
+| Area | 范围 |
+|------|------|
+| `coaching/prompt` | 提示词创建、优化、微调 |
+| `coaching/role` | 角色生成、拟真度(按需画像为增强能力) |
+| `coaching/script` | 交互剧本、流程设置 |
+| `coaching/knowledge` | 知识库构建、内容提取 |
+| `coaching/scoring` | 评分标准、评分逻辑 |
+| `diagnosis` | 诊断标签(F/I/O/P/N/L/E/S/R/K/T/D)的判定与排序 |
+| `quality-gate` | 创建闸门、微调闸门 |
+| `asset` | 资产库调用、匹配规则 |
+| `platform/sync` | 平台同步、环境检测、平台创建 |
+| `delivery` | 客户交付、培训包、看板 |
+| `cfg` | 配置、路径、环境变量 |
+
+---
+
+## 学习信号检测
+
+### 自动触发记录的场景
+
+| 场景 | 写入位置 | 类别 |
+|------|---------|------|
+| 用户纠正诊断标签归属 | LEARNINGS.md | `correction` |
+| 诊断顺序导致误判(如先P后O) | LEARNINGS.md | `correction` |
+| 闸门漏拦导致交付问题 | LEARNINGS.md | `correction` |
+| 资产选错导致分析偏差 | LEARNINGS.md | `correction` |
+| 子技能输出异常 | ERRORS.md | - |
+| 平台同步环境检测失败 | ERRORS.md | - |
+| 命令返回非零/超时/权限拒绝 | ERRORS.md | - |
+| "能不能也支持XX场景" | FEATURE_REQUESTS.md | - |
+| "为什么不能XX" | FEATURE_REQUESTS.md | - |
+| 发现新的诊断模式或标签 | LEARNINGS.md | `insight` |
+| 用户传授新的陪练业务规则 | LEARNINGS.md | `knowledge_gap` |
+| 找到比现有方法更好的流程 | LEARNINGS.md | `best_practice` |
+
+### 识别人工纠正的关键词
+
+- "不对"、"不是这样"、"应该是"、"实际上"、"你搞错了"
+- "这不是X标签,是Y标签"
+- "先查X再查Y"
+- "这个资产不对,应该用XX"
+- "闸门没拦住,少检查了XX"
+- "别"、"停止"、"以后不要"
+- "我更喜欢"、"我一向都是"
+
+### 识别偏好信号的关键词(直接记录到 SKILL.md 对应节)
+
+- "我喜欢你这样" → 强化当前行为
+- "每次都帮我做X" → 写入对应流程
+- "不要做Y" → 写入对应约束
+- "我的风格是" → 写入输出格式
+
+### 识别新需求的关键词
+
+- "能不能也"、"可以支持吗"、"为什么不"、"有没有办法"、"我想"
+
+### 以下情况不记录
+
+- 一次性指令("查一下这个文件")
+- 上下文相关("在这个场景里")
+- 假设性问题("如果怎么做会怎样")
+- 用户没有反馈时的沉默推断
+
+---
+
+## 日志格式
+
+### 学习条目(LEARNINGS.md)
+
+```markdown
+## [LRN-YYYYMMDD-XXX] category
+
+**Logged**: ISO-8601 timestamp
+**Priority**: low | medium | high | critical
+**Status**: pending
+**Area**: coaching/prompt | diagnosis | quality-gate | asset | ...
+
+### Summary
+一句话描述学到了什么
+
+### Details
+完整上下文:发生了什么、错在哪、正确的是什么
+
+### Suggested Action
+具体的修复或改进措施
+
+### Metadata
+- Source: conversation | error | user_feedback | self_reflection
+- Related Files: 涉及的文件路径
+- Tags: 标签
+- See Also: LRN-xxxxxxxxx-xxx(如与已有条目关联)
+- Pattern-Key: 可选,用于跨任务模式追踪
+- Recurrence-Count: 1
+- First-Seen: YYYY-MM-DD
+- Last-Seen: YYYY-MM-DD
+
+---
+```
+
+### 错误条目(ERRORS.md)
+
+```markdown
+## [ERR-YYYYMMDD-XXX] skill_or_command
+
+**Logged**: ISO-8601 timestamp
+**Priority**: high
+**Status**: pending
+**Area**: ...
+
+### Summary
+简要描述失败原因
+
+### Error
+\`\`\`
+实际错误消息
+\`\`\`
+
+### Context
+- 执行的命令/操作
+- 输入参数
+- 环境信息(如有)
+
+### Suggested Fix
+可识别的修复方案
+
+### Metadata
+- Reproducible: yes | no | unknown
+- Related Files: 路径
+- See Also: ERR-xxxxxxxxx-xxx(如反复出现)
+
+---
+```
+
+### 功能请求(FEATURE_REQUESTS.md)
+
+```markdown
+## [FEAT-YYYYMMDD-XXX] capability_name
+
+**Logged**: ISO-8601 timestamp
+**Priority**: medium
+**Status**: pending
+**Area**: ...
+
+### Requested Capability
+用户想要什么能力
+
+### User Context
+为什么需要、解决什么问题
+
+### Complexity Estimate
+simple | medium | complex
+
+### Suggested Implementation
+可能的实现方式
+
+### Metadata
+- Frequency: first_time | recurring
+- Related Features: 关联现有功能
+
+---
+```
+
+### ID 生成规则
+
+格式:`TYPE-YYYYMMDD-XXX`
+- TYPE: `LRN`(学习)、`ERR`(错误)、`FEAT`(功能请求)
+- 日期: 当前日期
+- 序号: 三位数 `001`、`002`...
+
+示例:`LRN-20260708-001`、`ERR-20260708-001`、`FEAT-20260708-001`
+
+---
+
+## 自我反思机制
+
+每完成一个完整任务后,主动执行三问反思:
+
+### 反思模板
+
+```
+CONTEXT: [任务类型] - [场景名称]
+REFLECTION: [我注意到什么]
+LESSON: [下次应该怎么做不同]
+```
+
+### 示例
+
+```
+CONTEXT: 微调型任务 - XX保险公司电话约访
+REFLECTION: 先P后O诊断,结果O误判导致P误报。用户指正后调整顺序才找到真正问题
+LESSON: 诊断顺序硬约束:必须先O再P,跳过必错
+```
+
+### 何时反思
+
+- 完成多步骤任务后
+- 收到反馈后(正面或负面)
+- 修复错误后
+- 发现自己的输出可以更好时
+
+反思条目同样遵循推广规则:成功应用 3 次 → 提升 Priority → 满足推广条件后写入本 SKILL.md。
+
+---
+
+## 冲突解决
+
+当学习条目相互矛盾时:
+
+1. **最具体的优先**:项目级 > Area级 > 全局
+2. **最新的优先**(同级时):尊重演化
+3. **模糊不清时** → 追问用户确认
+
+**示例**:
+- 全局规则:"微调时必须跑全部资产库"
+- 项目级规则:"药店场景微调时跳过客户角色模板库(因为药店角色已定型)"
+- → 执行时采用项目级规则
+
+---
+
+## 条目生命周期
+
+### 状态流转
+
+```
+pending → resolved | promoted | promoted_to_skill | wont_fix
+```
+
+### 解决后
+
+1. 改 `**Status**: pending` → `**Status**: resolved`
+2. 追加 Resolution 块:
+
+```markdown
+### Resolution
+- **Resolved**: ISO-8601
+- **Notes**: 简述做了什么
+```
+
+### 推广后
+
+1. 改 `**Status**: pending` → `**Status**: promoted`
+2. 加 `**Promoted**: SKILL.md | AGENTS.md | TOOLS.md | MEMORY.md`
+
+---
+
+## 模式检测与自动推广
+
+### 写入前先查重
+
+```bash
+grep -rn "关键词" .learnings/
+```
+
+- 已有类似条目 → 加 `See Also` 链接,bump 优先级,递增 `Recurrence-Count`
+- 没有 → 新建
+
+### 自动推广条件(满足全部 3 条)
+
+- `Recurrence-Count ≥ 3`
+- 跨至少 2 个不同任务
+- 30 天内出现
+
+### 推广目标
+
+| 学习类型 | 推广到 | 示例 |
+|---------|--------|------|
+| 诊断标签判定修正 | 本 SKILL.md「微调诊断标签」节 | "模板化万能回应归N不归O" |
+| 闸门漏拦 | 本 SKILL.md「质量闸门」节 | "新增第11项:每阶段退出条件" |
+| 资产选错规则 | 本 SKILL.md「资产调用规则」节 | "评分不准时同步查Bad Case库" |
+| 调度顺序优化 | AGENTS.md | "微调前必须先查err-detected" |
+| 工具/命令坑点 | TOOLS.md | "soke-cli login 需要先 node>=14" |
+| 行为模式改进 | SOUL.md | "诊断报告不含未经标签的猜测" |
+| 业务经验 | MEMORY.md | "XX客户偏好电话约访场景" |
+| 高复发价值 | 提取为独立 skill | LRN → skills/coaching-fix-name/ |
+
+### 推广时保持简洁
+
+推广到系统文件时,只写短规则,不写长篇事件描述:
+
+```
+❌ 坏:"2026年7月8日,在处理XX保险公司的陪练微调时,用户指出...经过排查发现..."
+✅ 好:"诊断顺序硬约束:必须先O再P再N,禁止跳过。"
+```
+
+---
+
+## 常见陷阱与应对
+
+| 陷阱 | 为什么危险 | 正确做法 |
+|------|-----------|---------|
+| **从沉默中学习** | 创造虚假规则 | 等待显式纠正或重复证据 |
+| **推广太快** | 污染 HOT 记忆 | 新教训保持 tentative,等待重复 |
+| **把一次性指令当规则** | 过度泛化 | 只有重复 ≥ 3 次且跨任务的才推广 |
+| **压缩时删除** | 丢失信任和历史 | 合并、汇总、或降级,不删除 |
+| **把技术问题当提示词问题** | 无效修改、故障不修复 | 严格走技术分流流程 |
+| **先P后O诊断** | 角色OOC导致P误判 | 强制 T→O→P→N 顺序 |
+| **忽略沉默中的偏好** | 用户懒得说但你该记住 | 偏好信号("我喜欢")→ 立即记录 |
+
+---
+
+## 学习推广示例
+
+### 案例 1:标签判定修正
+
+```
+用户:"这不是N(自然度违规),这是O(角色OOC)"
+→ [LRN-20260708-001] correction,Area: diagnosis
+→ 复发 3 次后推广
+→ 本 SKILL.md「诊断分析顺序」节写入新规则
+```
+
+### 案例 2:闸门漏拦
+
+```
+交付后用户发现结束条件不清晰
+→ [LRN-20260708-002] correction,Area: quality-gate
+→ 推广到「创建闸门」新增:"每个阶段有明确的退出条件"
+```
+
+### 案例 3:资产选错
+
+```
+微调"评分不准"时只查了评分组件库,漏了Bad Case库
+→ [LRN-20260708-003] correction,Area: asset
+→ 推广到「资产调用规则」微调按需选读:
+   "评分不准:必读评分组件库 + 同步查 Bad Case 中同类问题"
+```
+
+---
+
+## 周期性审查
+
+### 何时审查
+
+- 每次大任务开始前
+- 每次交付完成后
+- 每周主动检查一次
+
+### 快速状态
+
+```bash
+# 待处理数量
+grep -ch 'Status\*\*: pending' .learnings/*.md
+
+# 高优先级条目
+grep -B5 'Priority\*\*: high' .learnings/*.md | grep '^## \['
+```
+
+### 审查动作
+
+- 待处理 → 解决 → resolved
+- 满足推广条件 → promoted
+- 关联相关条目 → 加 See Also
+- 反复出现的问题 → 升级为独立 issue
+
+---
+
+## 技能自动提取
+
+### 提取条件(满足任一)
+
+- 有 2+ 个 See Also 关联(反复出现)
+- 状态 resolved 且有可工作修复
+- 需要实际排查才能发现(非显而易见)
+- 跨项目适用
+- 用户明确说"记下来"、"下次别忘了"
+
+### 提取流程
+
+1. 确认候选 learning 满足条件
+2. 使用 `assets/SKILL-TEMPLATE.md` 模板,创建 `skills/<skill-name>/SKILL.md`
+3. 更新原 learning:`**Status**: promoted_to_skill`、加 `Skill-Path`
+4. 在新 session 验证 skill 可独立使用
+
+---
+
+## 与主流程的集成点
+
+### 意图识别阶段
+
+- 检查 `.learnings/` 中是否有与当前任务 Area 匹配的 Priority=high/critical 且 Status=pending 的条目
+- 如有,在「意图识别」输出中追加:`⚠️ 历史学习提醒:XX(LRN-XXX)`
+
+### 诊断阶段
+
+- 每次打完诊断标签后,自动扫描用户反馈中的纠正关键词
+- 如检测到纠正 → 立即修正当前行为 → 异步写入 LEARNINGS.md,任务结束后推广
+
+### 交付阶段
+
+- 交付前跑闸门清单
+- 如闸门漏拦 → 写 LEARNINGS.md,标注 quality-gate Area
+
+### 任务收尾阶段
+
+每个完整任务结束时:
+
+- 执行自我反思(三问)
+- 输出简洁的学习摘要(新条目数量 + 关键洞察)
+- 如有反思 → 写入 LEARNINGS.md
+
+---
+
+## 辅助脚本与模板
+
+| 文件 | 用途 |
+|------|------|
+| `scripts/activator.sh` | 每轮对话后提醒评估学习(可选启用) |
+| `scripts/error-detector.sh` | 命令执行失败时自动检测并提示记录 |
+| `scripts/extract-skill.sh` | 从 learning 提取为新 skill |
+| `scripts/sync.sh` | Part3-5 统一脚本代理执行器(统一返回 success/failed/fail_stage/next_action/updated_at/validation_result) |
+| `assets/LEARNINGS-TEMPLATE.md` | 学习条目记录模板 |
+| `assets/ERRORS-TEMPLATE.md` | 错误条目记录模板 |
+| `assets/FEATURE_REQUESTS-TEMPLATE.md` | 功能请求记录模板 |
+| `assets/SKILL-TEMPLATE.md` | 新技能创建模板 |
+
+---
+
+## 最佳实践
+
+1. **立刻记录** - 上下文在问题刚发生时最新鲜
+2. **具体明确** - 后续的自己需要快速理解
+3. **包含复现步骤** - 特别是错误
+4. **链接相关文件** - 方便修复
+5. **给出具体修复建议** - 不只是"调查一下"
+6. **积极推广** - 拿不准时,推广到本 SKILL.md 比漏掉好
+7. **定期审查** - 过时的 learning 没有价值
+8. **屏蔽敏感信息** - 不记录密钥、token、完整对话抄本
+9. **从纠正中学习,不从沉默中学习** - 没有显式纠正 = 没有教训
+10. **推广前先确认** - 3 次同类纠正后,问一句"这是否可以作为永久规则?"

package/skills/soke-ai-coach-director/references/subs/part1/SOP.md

@@ -0,0 +1,17 @@
+# Part1 基础信息创建子 SOP
+
+> 由 SKILL.md Step 5 调用。生成前先读 `coaching/prompt-engineer/parts/part1-basic.md` 加载内容框架。执行流程遵循「展示 → 自检 → 弹窗确认（模板1）→ 后台创建」。
+
+## 固定约束
+
+- 场景语言 `scene_lang` 固定 `"简体中文"`（永不随场景变）。
+- 封面固定默认 URL `https://newsokeeditorcdn.soke.cn/public/ai/cover/lingshou_daogou.png`（确认后后台写入）。
+- `key_points` 必须**单个字符串**（多条用分号/编号拼接，非数组）。
+
+## 执行流程
+
+1. 完整展示 Part1 → 自检 → 2. 弹窗确认 → 3. 生成 step1-create.json → 4. 执行 `+create-scenario` → 5. 回读验收 name/description/tags/key_points 一致，scenario_id 非空（为空禁止进 Part2）。
+
+## 自查清单（7 项）
+
+1. name 非空 ≤15 字；2. description 100-200 字；3. scene_lang="简体中文"；4. cover 非空（固定 URL）；5. **key_points 是字符串非数组（最高频错误）**；6. category_id 非空；7. tags 3-5 个。

package/skills/soke-ai-coach-director/references/subs/part2/SOP.md

@@ -0,0 +1,34 @@
+# Part2 角色生成与同步子 SOP
+
+> 由 SKILL.md Step 5 调用。生成前先读 `coaching/prompt-engineer/parts/part2-roles.md` 加载内容框架。执行遵循「展示 → 自检 → 弹窗确认（模板2）→ 后台资源匹配+整包同步」。
+
+## 角色结构（1 OS + N 角色）
+
+每种顾客状态必须拆为**独立角色**（禁止单角色内部状态机切换）。每角色含：name / description / communication_style / background（四段画像）/ personality_type（单 MBTI）/ personality / tags / knowledge_level / taboos_objections。
+
+## 关键结构规则
+
+- `replace_ai_roles` 数据键 `data.roles`（非 `data.ai_roles`）— 最高频错误。
+- 外壳 10 字段（scenario_role_id / customization_level="full" / is_custom_role=true / customized_fields 列全 12 字段 / created_at / updated_at / template_id=null / template_name=null / template_version=null）在 `role_data` 外层；`source_type="custom"` 在 `role_data` 内。
+- `avatar` 写 URL（`+list-role-avatars` 的 `url`），`voice_id` 写 ID（`+list-role-voices` 的 `id`）。
+- 资源匹配后台执行（见 `role-resource-matching.md`），随整包一次写入，不二次确认。
+
+## 同步写入策略
+
+默认整包 `replace_ai_roles` 一次写全部角色 + OS（OS 用 update_basic 单独写）。整包失败降级为逐个 `add_ai_role` + 单独 update_basic 写 OS。
+
+### 异常处理：最小稳定结构降级
+
+回读出现 `name="角色数据异常"` / 字段 null 时：
+1. **字段级排雷**：personality_type 收敛单值、source_type 内外层不重复、customized_fields 与实际字段一致。
+2. **最小稳定结构重试**：仅保留 name/description/communication_style/background/avatar/voice_id，移除 knowledge_level/taboos_objections/tags/personality。
+3. **回读即准**：name≠"角色数据异常"、background 四段完整、avatar/voice_id 非空、OS 非空。
+4. **禁止带病续流**：仍有异常停在 Part2，不进 Part3。
+
+## background 强制闸门
+
+生成 JSON 后 preview 前：逐字比对 JSON 的 background 与展示文本一致 + 四段画像完整，任一不过驳回修正。
+
+## 自查清单（14 项）
+
+1. `data.roles`（非 data.ai_roles）；2. 每角色含 scenario_role_id；3. 角色数≥2；4. name 非空；5. description 非空；6. background 四段完整；7. communication_style 非空；8. personality_type 单值；9. avatar 非空 URL；10. voice_id 非空 ID；11. 外壳字段在外层、source_type 在 role_data 内；12. OS 非空；13. background 展示=JSON 一致；14. 无空 background。

package/skills/soke-ai-coach-director/references/subs/part3/SOP.md

@@ -0,0 +1,27 @@
+# Part3 流程设置同步子 SOP
+
+> 由 SKILL.md Step 5 调用。生成前先读 `coaching/prompt-engineer/parts/part3-flow.md` 加载内容框架。环节数 3-7、每阶段 3-5 轮、编号连续。
+
+## 原子性约束
+
+开场语（update_basic）+ 所有环节（add_conversation_step）必须合并为**同一批 operations 一次 preview+apply**，禁止拆分多次。失败则整个 Part3 判失败，不允许部分成功静默续流。
+
+## 回读判定矩阵（preview 证据优先于 get-scenario）
+
+| preview 证据 | get-scenario 回读 | 判定 |
+|-------------|-------------------|------|
+| opening + steps 双项有 add 证据 | 双项非空 | ✅ 通过 |
+| 双项有证据 | opening 非空、steps 为空 | ✅ 通过（CLI bug 白名单） |
+| opening 无证据 | 任意 | ❌ 失败 |
+| steps 无 add 证据 | steps 为空 | ❌ 失败 |
+| preview/apply 报错 | 任意 | ❌ 失败 |
+
+核心原则：preview 确认平台接收了操作即视为原子成功；get-scenario 回读 `conversation_steps` 为空是 CLI 已知 bug（v1.0.65+），不改变成功判定。
+
+## 已知 CLI 回读口径差异
+
+`add_conversation_step` apply 返回成功但 get-scenario 回读 `conversation_steps: []`，opening_dialogue 也可能不同步反映——这是已知差异，不代表数据未写入。验收时 preview/apply 成功即默认进 Part4，记录「平台回读异常待观察」，不要求先去 Web 后台确认。仅 preview/apply 本身失败才停下排查。
+
+## 自查清单（8 项）
+
+1. opening_dialogue_type 固定整数 1；2. 每环节含 step_name/student_objective/ai_task/max_rounds；3. 编号从 1 连续；4. 无空缺；5. 字段结构正确；6. opening_dialogue 第一人称无后台痕迹；7. information 不含考核/评分信息；8. status=1。

package/skills/soke-ai-coach-director/references/subs/part4/SOP.md

@@ -0,0 +1,31 @@
+# Part4 评分配置同步子 SOP
+
+> 由 SKILL.md Step 5 调用。生成前先读 `coaching/prompt-engineer/parts/part4-scoring.md` 加载内容框架。`scoring_rule`/`criteria` 禁止示例对话，一票否决嵌入各维度 scoring_rule 末尾。
+
+## shell 字段位置铁律（v2.26 硬阻断）
+
+4 个 shell 字段必须写在 `data.config` **顶层**，不能放进 `criteria_data` 内（错放导致 UI 显示"请选择或创建评分标准"，API 不报错 warnings=[]）：
+
+| 字段 | 必须位置 |
+|------|---------|
+| `scenario_criteria_id` | `data.config` 顶层 |
+| `customization_level="full"` | `data.config` 顶层 |
+| `is_custom_criteria=true` | `data.config` 顶层 |
+| `customized_fields=["criteria_data"]` | `data.config` 顶层 |
+
+`criteria_data` 内只放业务字段：`name` / `description` / `dimensions` / `total_weight` / `source_type="enterprise"` / `status=1` / `tags`。
+
+apply 后 get-scenario 回读确认 shell 字段在 `scoring_criteria_config` 顶层全部存在，任一缺失 = 失败，调整后重新 apply。
+
+## 执行流程
+
+用户确认 → 生成 part4-operations.json → 对照自查清单 → preview → apply → get-scenario 回读验证 shell 字段位置 + 权重和 100。
+
+## 自查清单（19 项，关键项）
+
+**shell 位置**：1. config 顶层含 scenario_criteria_id；2. customization_level="full"；3. is_custom_criteria=true；4. customized_fields=["criteria_data"]（均不在 criteria_data 内）。
+**业务字段**：5. 用 replace_scoring_criteria_config；6. data.config.criteria_data 三层嵌套；7. 维度≥2；8. 权重和=100；9. 每维度含名称/权重/评分规则/评分点；10. scoring_rule 无示例对话；11. 一票否决嵌入维度末尾；12. 无全局 one_vote_veto；13. 每维度≥2 评分点；14. status=1；15. source_type="enterprise"；16. tags 非空；17. 每维度含 id（dim_{code}）；18. sort_order 数字；19. apply 后回读 shell 字段在顶层。
+
+## 评分维度设计原则
+
+维度数：简单场景 3-4、复杂 4-5；权重：沟通类 50-60%、专业类 40-50%；一票否决格式"以下行为触犯即该维度 0 分且总分不合格：…"。