@sokeai/cli 1.0.66 → 1.0.67

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

@@ -0,0 +1,312 @@
+--
+
+### 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 拆分的通用确认模板与微调模板。优先弹窗确认：WebChat 主会话用 render_ui 的 QuestionForm，workbuddy 子 agent 用 AskUserQuestion，纯文本平台降级结构化文本。
+---
+
+# 弹窗交互规则
+
+## 三层架构中的位置
+
+```
+用户视角三层：
+  提示词内容（coaching/ 层产出）
+→ 结构化文本确认（interaction.md 层，本文件）
+→ CLI 同步（sync-engine.md 层）
+```
+
+本文件控制确认环节：通用确认契约（问题和选项）、确认输出规范、用户响应后的分支路由。
+
+## 核心规则
+
+1. **Part1 确认后强制同步到平台**：模板 1 不提供"取消"或"跳过同步"选项；用户确认即意味着场景必须创建到平台
+2. Part2-Part5 确认后自动 preview + apply CLI，立即进入下一个 Part，不等待用户二次确认
+3. 调整/重设/微调分支由用户选择驱动，`prompt-engineer` / `prompt-optimizer` 按返回值分支处理
+4. **优先使用弹窗确认**：弹窗策略按运行环境三分层——① WebChat 主会话：使用 `render_ui` 的 QuestionForm jsonl（参考附录 A）；② workbuddy 子 agent：使用 `AskUserQuestion` 工具弹窗（参考附录 A）；③ 纯文本平台（群聊、IM 无按钮）：降级为结构化文本确认。选项文案和分支路由三平台完全一致
+5. **选项文案和分支路由不因渲染方式而变化**：渲染机制不同但选项名称和路由完全一致，用户始终只需点击按钮或回复编号做出选择
+
+---
+
+## 确认输出规范（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-operations.json` → 自动 preview + apply → 立即继续 Part3 |
+| 2 | 调整角色设定 | 局部修改后重新用本模板确认 |
+| 3 | 重设角色设定 | 回到内容层重新生成 Part2，再次用本模板确认 |
+
+---
+
+### 模板 3：Part3 流程设置确认
+
+**触发时机**：Part2 确认并同步后自动进入。`prompt-engineer` 单独生成 Part3 流程设置。
+
+**标题**：流程设置确认
+
+**问题**：流程设置是否满意？
+
+**选项**：
+
+| # | 选项文案 | 分支动作 |
+|---|---------|---------|
+| 1 | 确认，同步流程设置（推荐） | 生成 `part3-operations.json` → 自动 preview + apply → 立即继续 Part4 |
+| 2 | 调整流程设置 | 局部修改后重新用本模板确认 |
+| 3 | 重设流程设置 | 回到内容层重新生成 Part3，再次用本模板确认 |
+
+---
+
+### 模板 4：Part4 评分标准确认
+
+**触发时机**：Part3 确认并同步后，单独生成 Part4 评分标准。
+
+**标题**：评分确认
+
+**问题**：评分标准是否满意？
+
+**选项**：
+
+| # | 选项文案 | 分支动作 |
+|---|---------|---------|
+| 1 | 确认，同步评分（推荐） | 生成 `part4-operations.json` → 自动 preview + apply → 继续 Part5 |
+| 2 | 调整评分标准 | 局部修改后重新用本模板确认 |
+| 3 | 重设评分标准 | 回到内容层重新生成 Part4，再次用本模板确认 |
+
+---
+
+### 模板 5：Part5 教练设置确认
+
+**触发时机**：Part4 确认并同步后，单独生成 Part5 教练设置。
+
+**标题**：教练设置确认
+
+**问题**：教练设置是否满意？
+
+**选项**：
+
+| # | 选项文案 | 分支动作 |
+|---|---------|---------|
+| 1 | 确认，完成创建（推荐） | 生成 `part5-operations.json` → 自动 preview + apply → 输出完成摘要 |
+| 2 | 调整教练设置 | 局部修改后重新用本模板确认 |
+| 3 | 重设教练设置 | 回到内容层重新生成 Part5，再次用本模板确认 |
+
+---
+
+### 模板 6：微调诊断确认
+
+**触发时机**：`prompt-optimizer` 输出四段式诊断报告后。
+
+**标题**：诊断确认
+
+**问题**：诊断结果和修改方案是否采纳？
+
+**选项**：
+
+| # | 选项文案 | 分支动作 |
+|---|---------|---------|
+| 1 | 确认修改（推荐） | 生成 `optimize-operations.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 命令拼接
+- 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":["确认修改（推荐）","保持原样","调整诊断"]}]}]}}
+```

package/skills/ai-coach-director/platform/soke-ai-training/soke-ai-training.md

@@ -0,0 +1,93 @@
+---
+name: soke-ai-training
+summary: AI教练知识包同步、source管理、场景绑定和知识计划查询
+version: 1.0.0
+description: "用于本地Agent通过soke-cli调用开放平台AI教练知识包接口，完成Markdown source上传、结构化entries同步、source管理、场景知识包版本绑定和知识计划编译查询。"
+metadata:
+  requires:
+    bins: ["soke-cli"]
+  cliHelp: "soke-cli ai-training --help"
+---
+
+# AI教练知识包
+
+**CRITICAL — 开始前 MUST 先读取 [`../soke-shared/SKILL.md`](../soke-shared/SKILL.md)，其中包含认证、配置和权限处理。**
+
+## 使用前提
+
+1. 运行 `soke-cli auth login` 完成用户授权。
+2. 确认 `soke-cli config show` 中有 `APIBaseURL`、`AppKey`、`AppSecret`、`CorpID` 和用户 token。
+3. 客户原始 PDF、Word、Excel、网页等资料必须先由本地 Agent/Skills 提炼为 Markdown sources 和结构化 entries JSON。
+
+## 推荐同步
+
+```bash
+soke-cli ai-training +sync \
+  --manifest ./knowledge-package.json \
+  --idempotency-key cli-rcb-loan-products-20260610-001
+```
+
+`soke-cli ai-training +sync` 会完成：
+
+1. 读取 manifest 和 entries。
+2. 校验 Markdown 文件、source_refs、entry_id/source_id 唯一性。
+3. 调用 `/skills/ai-training/knowledge-packages/upload-tokens`。
+4. 直传 Markdown 到服务端返回的 `upload_url`。
+5. 调用 `/skills/ai-training/knowledge-packages/sync`。
+6. 写入 `.mentorai-sync-state.json`。
+
+## Manifest 示例
+
+```json
+{
+  "package": {
+    "package_id": "rcb-loan-products",
+    "name": "某地方银行贷款产品知识包",
+    "domain": "banking_loan",
+    "tags": ["贷款产品"]
+  },
+  "sources": [
+    {
+      "source_id": "src_manual",
+      "path": "./sources/manual.md",
+      "display_name": "贷款产品手册",
+      "origin_type": "pdf",
+      "origin_filename": "贷款产品手册.pdf"
+    }
+  ],
+  "entries_path": "./knowledge-package.entries.json"
+}
+```
+
+## 查询和管理
+
+```bash
+soke-cli ai-training +list-packages --format json
+soke-cli ai-training +list-versions --package-id rcb-loan-products
+soke-cli ai-training +list-sources --package-id rcb-loan-products
+soke-cli ai-training +rename-source --package-id rcb-loan-products --source-id src_manual --display-name "贷款产品手册2026Q2"
+soke-cli ai-training +delete-source --package-id rcb-loan-products --source-id src_manual
+```
+
+## 场景绑定
+
+```bash
+soke-cli ai-training +bind-scenario \
+  --scenario-id scenario_micro_loan_sales \
+  --version-ids 8ed4c1c4-5b3c-4d44-ae8e-d5b064bf1e12 \
+  --compile-plan
+
+soke-cli ai-training +compile-plan \
+  --scenario-id scenario_micro_loan_sales \
+  --version-ids 8ed4c1c4-5b3c-4d44-ae8e-d5b064bf1e12 \
+  --force
+
+soke-cli ai-training +get-plan --scenario-id scenario_micro_loan_sales --format json
+```
+
+## 注意
+
+- 不要在 manifest 或 entries 中伪造 `corp_id`、`user_id` 或 `object_key`。
+- `object_key` 必须使用 upload-token 返回值。
+- 不要把客户原始资料、token、app_secret 或 OSS 签名写入仓库。
+- `advisor_golden_script` 不应进入 AI 客户角色可见知识。