@sokeai/cli 1.0.76 → 1.0.77

package/skills/ai-coach-director/platform/interaction.md

@@ -1,315 +0,0 @@
---
-
-### B.x workbuddy 路径：AskUserQuestion
-
-workbuddy 子 agent 环境中不可用 `render_ui`，改用 `AskUserQuestion` 工具弹窗。参数结构与正文确认契约对应关系：
-
-| 正文字段 | AskUserQuestion 参数 | 说明 |
-|---------|---------------------|------|
-| 标题 | `question` | 确认标题 |
-| 问题文本 | `prompt` 或合入 `question` | 向用户展示的问题描述 |
-| 选项列表 | `options` | 字符串数组，第一个为推荐正向操作（带「推荐」标记） |
-
-**通用调用形式：**
-```
-AskUserQuestion(
-  question="<模板标题>",
-  options=["<选项1>（推荐）", "<选项2>", ...]
-)
-```
-
-返回值为用户选择的选项文案字符串，分支路由逻辑与正文模板完全一致。
-
-**注意：**
-- 选项顺序必须与正文模板保持一致（推荐操作在第一位）
-- 选项文案不因渲染机制变化，始终使用业务语言
-- 模糊匹配时优先正向操作（选项 1）
--
-name: interaction
-description: AI 陪练弹窗交互规则。定义按 Part1-Part5 拆分的通用确认模板与微调模板。跨平台适配：WorkBuddy 用 AskUserQuestion/render_ui，悟空/QClaw/Zework 用结构化文本编号（统一路由到 platform/adapters/）。
----
-
-# 弹窗交互规则
-
-## 三层架构中的位置
-
-```
-用户视角三层：
-  提示词内容（coaching/ 层产出）
-→ 结构化文本确认（interaction.md 层，本文件）
-→ CLI 同步（sync-engine.md 层）
-```
-
-本文件控制确认环节：通用确认契约（问题和选项）、确认输出规范、用户响应后的分支路由。
-
-## 核心规则
-
-1. **Part1 确认后强制同步到平台**：模板 1 不提供"取消"或"跳过同步"选项；用户确认即意味着场景必须创建到平台
-2. Part2-Part5 确认后自动 preview + apply CLI，立即进入下一个 Part，不等待用户二次确认
-3. Part1 封面生成/上传/修正属于后台自动处理步骤；Part2 头像/语音匹配、逐个保守写角色、回读校验也属于后台自动处理步骤。除非失败，不向用户展示过程细节
-4. Part2-Part5 默认优先走 `--request-file ./partX-update.json` 的完整请求模式；`--operations-file ./partX-operations.json` 仅作为排障/降级模式
-5. 若 Part3 按标准语义操作 apply 后回读仍为空，必须明确提示当前 CLI/平台版本限制，并引导改走 Web 管理后台补录流程步骤
-6. 调整/重设/微调分支由用户选择驱动，`prompt-engineer` / `prompt-optimizer` 按返回值分支处理
-7. **优先使用弹窗确认**：弹窗策略按运行环境自适应——① WorkBuddy：使用 `AskUserQuestion` 工具弹窗（参考附录 B）；② WebChat 主会话：使用 `render_ui` 的 QuestionForm jsonl（参考附录 A）；③ 悟空/QClaw/Zework：降级为结构化文本编号确认（参考 `adapters/` 对应平台适配器）；④ 通用降级：纯文本编号。选项文案和分支路由所有平台完全一致
-8. **选项文案和分支路由不因渲染方式而变化**：渲染机制不同但选项名称和路由完全一致——WorkBuddy 弹窗按钮、悟空钉钉编号回复、QClaw 微信编号回复、Zework 纯文本编号，用户始终只需回复编号或完整选项文案做出选择
-
----
-
-## 确认输出规范（WebChat render_ui / workbuddy AskUserQuestion / 纯文本降级）
-
-在需要用户做选择时，用以下格式输出：
-
-```
-## {标题}
-
-{问题描述}
-
-1. {选项1} — {简短说明}
-2. {选项2} — {简短说明}
-3. {选项3} — {简短说明}
-
-请回复编号或选项文字。
-```
-
-**规则**：
-- 用户可通过回复编号（"1"、"2"、"3"）或选项文字来做出选择
-- `prompt-engineer` / `prompt-optimizer` 解析用户回复后，按本文件定义的分支路由执行
-- 如果用户回复模糊（如只说"确认"但只匹配部分选项），优先匹配正向操作（选项 1）
-
----
-
-## 通用确认契约（模板 1-6）
-
-每个模板定义三要素：
-- **标题**：确认弹窗的标题
-- **问题文本**：向用户展示的问题
-- **选项列表**：用户可选的分支，第一个为推荐正向操作
-- **分支路由**：每个选项对应的后续动作
-
----
-
-### 模板 1：Part1 基础信息确认（强制同步）
-
-**触发时机**：`prompt-engineer` 生成 Part1 后、生成 `step1-create.json` 前。
-
-**标题**：场景确认
-
-**问题**：Part1 基础信息是否正确？确认后将立即同步到平台。
-
-**选项**：
-
-| # | 选项文案 | 分支动作 |
-|---|---------|---------|
-| 1 | 确认，同步到平台（推荐） | 生成 `step1-create.json` → 执行 `soke-cli ai-training +create-scenario` → 提取 `scenario_id` → 写入状态快照 → 立即继续 Part2 |
-| 2 | 内容需要微调 | 回到内容层局部修改 Part1，重新用本模板确认 |
-
-> ⚠️ **不再提供「取消，重新来」**。Part1 确认即强制创建场景，无逃生路径。
-
----
-
-### 模板 2：Part2 AI角色设定确认
-
-**触发时机**：Part1 确认并完成创建后自动进入。`prompt-engineer` 单独生成 Part2 AI 角色卡与角色整体设定。
-
-**标题**：角色确认
-
-**问题**：AI角色设定是否满意？
-
-**选项**：
-
-| # | 选项文案 | 分支动作 |
-|---|---------|---------|
-| 1 | 确认，同步角色（推荐） | 完整展示 Part2 后，后台自动拆分 Part2 为多个角色级同步单元（角色1/角色2/角色3/整体OS），逐个保守写入并回读校验 → 全部成功后继续 Part3 |
-| 2 | 调整角色设定 | 局部修改后重新用本模板确认 |
-| 3 | 重设角色设定 | 回到内容层重新生成 Part2，再次用本模板确认 |
-
----
-
-### 模板 3：Part3 流程设置确认
-
-**触发时机**：Part2 确认并同步后自动进入。`prompt-engineer` 单独生成 Part3 流程设置。
-
-**标题**：流程设置确认
-
-**问题**：流程设置是否满意？
-
-**选项**：
-
-| # | 选项文案 | 分支动作 |
-|---|---------|---------|
-| 1 | 确认，同步流程设置（推荐） | 生成 `part3-operations.json` + `part3-update.json` → 默认用 `--request-file ./part3-update.json` 自动 preview + apply → 立即继续 Part4；若回读仍为空则提示改走 Web 管理后台补录 |
-| 2 | 调整流程设置 | 局部修改后重新用本模板确认 |
-| 3 | 重设流程设置 | 回到内容层重新生成 Part3，再次用本模板确认 |
-
----
-
-### 模板 4：Part4 评分标准确认
-
-**触发时机**：Part3 确认并同步后，单独生成 Part4 评分标准。
-
-**标题**：评分确认
-
-**问题**：评分标准是否满意？
-
-**选项**：
-
-| # | 选项文案 | 分支动作 |
-|---|---------|---------|
-| 1 | 确认，同步评分（推荐） | 生成 `part4-operations.json` + `part4-update.json` → 默认用 `--request-file ./part4-update.json` 自动 preview + apply → 继续 Part5 |
-| 2 | 调整评分标准 | 局部修改后重新用本模板确认 |
-| 3 | 重设评分标准 | 回到内容层重新生成 Part4，再次用本模板确认 |
-
----
-
-### 模板 5：Part5 教练设置确认
-
-**触发时机**：Part4 确认并同步后，单独生成 Part5 教练设置。
-
-**标题**：教练设置确认
-
-**问题**：教练设置是否满意？
-
-**选项**：
-
-| # | 选项文案 | 分支动作 |
-|---|---------|---------|
-| 1 | 确认，完成创建（推荐） | 生成 `part5-operations.json` + `part5-update.json` → 默认用 `--request-file ./part5-update.json` 自动 preview + apply → 进入资源完善与发布闸门 → 通过后才输出完成摘要 |
-| 2 | 调整教练设置 | 局部修改后重新用本模板确认 |
-| 3 | 重设教练设置 | 回到内容层重新生成 Part5，再次用本模板确认 |
-
----
-
-### 模板 6：微调诊断确认
-
-**触发时机**：`prompt-optimizer` 输出四段式诊断报告后。
-
-**标题**：诊断确认
-
-**问题**：诊断结果和修改方案是否采纳？
-
-**选项**：
-
-| # | 选项文案 | 分支动作 |
-|---|---------|---------|
-| 1 | 确认修改（推荐） | 生成 `optimize-operations.json` + `optimize-update.json` → 默认用 `--request-file ./optimize-update.json` 执行 CLI 同步 |
-| 2 | 保持原样 | 退出微调流程，记录决策到状态快照 |
-| 3 | 调整诊断 | 局部修改标签归属后重新用本模板确认 |
-
----
-
-## 通用规则
-
-### 选项文案规范
-
-- 正向操作始终带「（推荐）」标记
-- 选项文案为业务语言，不出现技术术语
-- 所有平台的选项文案统一，不因渲染方式而变化
-
-### 用户回复解析
-
-- 用户输入"1"或"确认，同步到平台（推荐）"→ 走选项 1 分支
-- 用户输入"2"或"内容需要微调"→ 走选项 2 分支
-- 只允许精确匹配编号或完整选项文案
-- 模糊匹配时优先正向操作（选项 1），并在执行前简短确认
-
-### 状态快照
-
-每个 Part 确认后，必须记录状态快照以支持断点续传：
-
-```json
-{
-  "scenario_id": "xxx",
-  "current_part": "part3",
-  "confirmed_data": {
-    "part1": { "scenario_id": "xxx", "name": "..." },
-    "part2": { "roles": [...] },
-    "part3": { "steps": [...] },
-    "part4": { "dimensions": [...] },
-    "part5": { "constraints": {}, "knowledge": [] }
-  },
-  "pending_data": {},
-  "applied": {
-    "part1": true,
-    "part2": true,
-    "part3": false,
-    "part4": false,
-    "part5": false
-  },
-  "mode": "partwise"
-}
-```
-
-快照仅用于引擎内部追踪，不对用户展示。
-
-### 回退链路
-
-```
-模板 1 内容需要微调 → 回到内容层局部修改 Part1，重新确认
-模板 2 重设角色设定 → 回到内容层重新生成 Part2
-模板 3 重设流程设置 → 回到内容层重新生成 Part3
-模板 4 重设评分标准 → 回到内容层重新生成 Part4
-模板 5 重设教练设置 → 回到内容层重新生成 Part5
-模板 6 保持原样 → 退出微调流程并记录决策；调整诊断 → 回到诊断修订
-```
-
-### 与 sync-engine.md 的边界
-
-- interaction.md：负责确认契约（问题和选项）、确认输出规范、用户响应后的分支路由
-- sync-engine.md：负责「确认后」的 JSON 生成、字段映射、CLI 命令拼接（默认 `partX-update.json`，排障时退回 `partX-operations.json`）
-- interaction 确认后 → 调用 sync-engine 对应模板 → 执行 CLI → 返回结果
-
----
-
-## 附录 A：弹窗组件实现（优先路径）
-
-确认弹窗按运行环境分两条路径，选项文案和分支路由完全一致：
-
-- **WebChat 主会话**：使用 `render_ui` 的 QuestionForm jsonl（本节 A.1-A.6）
-- **workbuddy 子 agent**：使用 `AskUserQuestion` 工具，参数结构见本节 B.1-B.6
-- **纯文本平台**：降级为正文的结构化文本确认
-
-### A.x WebChat 路径：render_ui QuestionForm jsonl
-
-以下 jsonl 与正文的通用确认契约完全等价（选项文案和分支一致），仅渲染机制不同。
-
-### A.1 模板 1 参考 jsonl
-
-```jsonl
-{"version":"v0.9","createSurface":{"surfaceId":"-","catalogId":"a2ui.basic:v0.9"}}
-{"version":"v0.9","updateComponents":{"surfaceId":"-","components":[{"id":"root","component":"QuestionForm","header":{"title":"场景确认"},"list":[{"question":"Part1 基础信息是否正确？确认后将立即同步到平台。","type":"single","options":["确认，同步到平台（推荐）","内容需要微调"]}]}]}}
-```
-
-### A.2 模板 2 参考 jsonl
-
-```jsonl
-{"version":"v0.9","createSurface":{"surfaceId":"-","catalogId":"a2ui.basic:v0.9"}}
-{"version":"v0.9","updateComponents":{"surfaceId":"-","components":[{"id":"root","component":"QuestionForm","header":{"title":"角色确认"},"list":[{"question":"AI角色设定是否满意？","type":"single","options":["确认，同步角色（推荐）","调整角色设定","重设角色设定"]}]}]}}
-```
-
-### A.3 模板 3 参考 jsonl
-
-```jsonl
-{"version":"v0.9","createSurface":{"surfaceId":"-","catalogId":"a2ui.basic:v0.9"}}
-{"version":"v0.9","updateComponents":{"surfaceId":"-","components":[{"id":"root","component":"QuestionForm","header":{"title":"流程确认"},"list":[{"question":"流程设置是否满意？","type":"single","options":["确认，同步流程设置（推荐）","调整流程设置","重设流程设置"]}]}]}}
-```
-
-### A.4 模板 4 参考 jsonl
-
-```jsonl
-{"version":"v0.9","createSurface":{"surfaceId":"-","catalogId":"a2ui.basic:v0.9"}}
-{"version":"v0.9","updateComponents":{"surfaceId":"-","components":[{"id":"root","component":"QuestionForm","header":{"title":"评分确认"},"list":[{"question":"评分标准是否满意？","type":"single","options":["确认，同步评分（推荐）","调整评分标准","重设评分标准"]}]}]}}
-```
-
-### A.5 模板 5 参考 jsonl
-
-```jsonl
-{"version":"v0.9","createSurface":{"surfaceId":"-","catalogId":"a2ui.basic:v0.9"}}
-{"version":"v0.9","updateComponents":{"surfaceId":"-","components":[{"id":"root","component":"QuestionForm","header":{"title":"教练设置确认"},"list":[{"question":"教练设置是否满意？","type":"single","options":["确认，完成创建（推荐）","调整教练设置","重设教练设置"]}]}]}}
-```
-
-### A.6 模板 6 参考 jsonl
-
-```jsonl
-{"version":"v0.9","createSurface":{"surfaceId":"-","catalogId":"a2ui.basic:v0.9"}}
-{"version":"v0.9","updateComponents":{"surfaceId":"-","components":[{"id":"root","component":"QuestionForm","header":{"title":"诊断确认"},"list":[{"question":"诊断结果和修改方案是否采纳？","type":"single","options":["确认修改（推荐）","保持原样","调整诊断"]}]}]}}
-```