@sokeai/cli 1.0.77 → 1.0.78

package/skills/mono/SKILL.md

@@ -0,0 +1,223 @@
+---
+name: soke-cli
+description: "授客AI CLI 全业务 Mono Skill。通过 soke-cli 管理课程、考试、题库、素材、课件、指派、学习地图、学习档案、证书、图片库、培训需求、AI 教练和 AI 督导。当用户需要从自然语言执行或了解上述业务操作时使用。"
+metadata:
+  requires:
+    bins:
+      - soke-cli
+---
+
+# 授客AI CLI 全业务 Skill
+
+本目录是可独立复制和安装的 Mono 发布包。所有参考文档、工作流、案例和脚本均位于本目录内，不依赖原始代码仓库。
+
+## 前置条件
+
+开始任何业务操作前，先读取 [安装与认证](./references/installation.md) 和 [共享 CLI 规则](./references/shared/cli-basics.md)。
+
+## 意图路由
+
+按用户意图选择对应模块，并按需读取该模块的 `MODULE.md`：
+
+| 场景 | 模块 |
+|---|---|
+| 课程、课程发布、学习记录 | [soke-course](./references/modules/soke-course/MODULE.md) |
+| 考试、题库、试卷、成绩 | [soke-exam](./references/modules/soke-exam/MODULE.md) |
+| 题库答题练习 | [soke-exam-question-pool](./references/modules/soke-exam-question-pool/MODULE.md) |
+| 素材上传与管理 | [soke-material](./references/modules/soke-material/MODULE.md) |
+| 课件与课程章节 | [soke-lesson](./references/modules/soke-lesson/MODULE.md) |
+| 课程/考试/地图指派 | [soke-assign](./references/modules/soke-assign/MODULE.md) |
+| 学习地图 | [soke-learning-map](./references/modules/soke-learning-map/MODULE.md) |
+| 学员学习档案 | [soke-learning-profile](./references/modules/soke-learning-profile/MODULE.md) |
+| 证书、图片库、培训需求 | 对应模块目录 |
+| AI 教练、AI 督导 | 对应模块目录 |
+
+## 共享规则
+
+- 所有命令使用 `soke-cli`，不要绕过 CLI 直接调用 HTTP API。
+- 不编造 UUID、用户 ID、课程 ID 等标识符，必须先通过命令查询。
+- 写入、删除、发布等高风险操作遵循模块文档中的确认要求。
+- 详细资料按需读取，避免一次性加载整个参考目录。
+
+## 目录说明
+
+- `references/modules/`：各业务模块的完整参考资料
+- `references/shared/`：认证、权限、错误处理和 CLI 共用规则
+- `references/workflows/`：跨模块流程
+- `references/cases/`：AI 教练案例资料
+- `scripts/`：本 Skill 随附的辅助脚本
+
+## 严格禁止（NEVER DO）
+
+- 不要绕过 `soke-cli` 直接使用 `curl`、HTTP API 或浏览器操作业务接口。
+- 不要编造课程 ID、考试 ID、题库 ID、用户 ID、部门 ID 或其他 UUID；必须从 CLI 返回结果中提取。
+- 不要输出 `app_secret`、`access_token`、`refresh_token` 等敏感凭证。
+- 不要把示例值当成真实业务数据，不要自行补全用户未提供的信息。
+- 不要在未确认目标对象、影响范围和用户意图时执行删除、发布、指派或其他写操作。
+- 不要把 `soke-cli api` 当作绕过业务 Skill 约束的替代方案；只有模块文档明确要求时才使用。
+
+## 必须执行（MUST DO）
+
+- 开始任何业务操作前，先读取 [安装与认证](./references/installation.md) 和 [共享 CLI 规则](./references/shared/cli-basics.md)。
+- 先判断用户的核心动作，再选择业务模块；名词相似时不能仅凭关键词猜测。
+- 执行命令前使用对应命令的 `--help` 核对当前版本真实可用的参数，不要凭旧文档猜 flag。
+- 需要机器解析时优先使用 `--format json`；展示给用户时提炼关键字段，不回显大段原始 JSON。
+- 查询得到真实 ID 后才能执行后续依赖该 ID 的操作，并在多步流程中沿用同一对象。
+- 写操作完成后，根据模块文档要求报告结果；失败时保留具体错误，不静默改用未经验证的替代命令。
+
+## 前置检查
+
+```bash
+soke-cli --version
+soke-cli config show
+soke-cli auth login       # 首次使用或认证失效时执行
+soke-cli doctor           # 当前版本支持时执行健康检查
+```
+
+认证、Token、权限和通用错误处理以 [共享 CLI 规则](./references/shared/cli-basics.md) 为准。
+
+## 完整意图路由
+
+| 用户意图 | 模块参考 |
+|---|---|
+| 创建、发布、查询课程，配置课程设置 | [soke-course](./references/modules/soke-course/MODULE.md) |
+| 上传或查询视频、音频、文档素材 | [soke-material](./references/modules/soke-material/MODULE.md) |
+| 创建、查询、排序课程课件 | [soke-lesson](./references/modules/soke-lesson/MODULE.md) |
+| 将课程、考试或学习地图指派给用户/部门 | [soke-assign](./references/modules/soke-assign/MODULE.md) |
+| 创建、管理、发布、查询考试/题库/试卷 | [soke-exam](./references/modules/soke-exam/MODULE.md) |
+| 进行可练习题库的随机答题 | [soke-exam-question-pool](./references/modules/soke-exam-question-pool/MODULE.md) |
+| 创建、发布、查询学习地图 | [soke-learning-map](./references/modules/soke-learning-map/MODULE.md) |
+| 查询学员学习档案和学习统计 | [soke-learning-profile](./references/modules/soke-learning-profile/MODULE.md) |
+| 查询证书、证书分类和获得人员 | [soke-certificate](./references/modules/soke-certificate/MODULE.md) |
+| 上传、查询或删除图片库图片 | [soke-photo-gallery](./references/modules/soke-photo-gallery/MODULE.md) |
+| 创建统计导出任务、查询任务状态 | [soke-task](./references/modules/soke-task/MODULE.md) |
+| 查询、提交或投票培训需求 | [soke-training-demand](./references/modules/soke-training-demand/MODULE.md) |
+| AI 教练知识包、场景和知识计划 | [soke-ai-training](./references/modules/soke-ai-training/MODULE.md) |
+| AI 陪练创建、微调、平台同步和质量闸门 | [soke-ai-coach-director](./references/modules/soke-ai-coach-director/MODULE.md) |
+| AI 督导场景、评分标准、指派和发布 | [soke-supervisor](./references/modules/soke-supervisor/MODULE.md) |
+
+### 易混淆场景
+
+- 上传课程文件 → `soke-material`；把已上传素材放进课程章节 → `soke-lesson`。
+- 创建课程/考试/地图后的对象分配 → `soke-assign`，不要自行构造指派请求。
+- 查询考试成绩 → `soke-exam`；按题库随机答题 → `soke-exam-question-pool`。
+- 学习地图或课程统计导出 → `soke-task`，不要把导出任务当作普通列表查询。
+- AI 教练知识包同步 → `soke-ai-training`；陪练创建、微调、资源匹配和发布闸门 → `soke-ai-coach-director`。
+- AI 督导场景管理 → `soke-supervisor`，不要与普通课程指派混用。
+
+## 意图判断与执行流程
+
+1. **识别动作**：区分查询、创建、更新、发布、指派、删除、导出、同步或答题练习。
+2. **确认范围**：明确模块、目标对象、组织/用户范围和输出要求；存在歧义时先询问。
+3. **读取规则**：读取本入口、共享规则和对应模块 `MODULE.md`；复杂场景再读取专项参考资料。
+4. **发现命令**：先运行父级帮助，再运行叶子命令 `--help` 核对参数。
+5. **查询前置数据**：先获取分类、对象或用户的真实 ID，禁止猜测。
+6. **执行与衔接**：按模块定义顺序执行，每一步返回值作为下一步输入。
+7. **确认高风险操作**：发布、指派、删除和批量写入前展示摘要并等待明确确认。
+8. **汇报结果**：只报告相关结果、ID、状态和下一步，不泄露凭证或无关调试输出。
+
+## 命令发现与参数边界
+
+`soke-cli` 的命令帮助是当前二进制的最终事实源。文档示例用于理解流程，不能替代实际帮助输出。
+
+```bash
+soke-cli --help
+soke-cli course --help
+soke-cli exam --help
+soke-cli course +list-courses --help
+soke-cli exam +get-exam-user --help
+soke-cli course +list-courses --format json
+```
+
+- 有精确覆盖用户意图的 `+verb` shortcut 时，优先使用该 shortcut。
+- shortcut 不存在或不能覆盖完整流程时，按模块文档使用标准命令或 `api` 命令。
+- 文档与 `--help` 不一致时，以当前 `--help` 为准，并说明差异。
+- 不要为了验证参数而执行实际写操作；命令支持 `--dry-run` 时先使用预览模式。
+- 不要把列表响应、详情响应或 `--help` 输出误认为业务操作已经成功。
+
+## 输出与交互规范
+
+- 列表结果应说明分页、筛选条件和结果数量，不能把第一页当作全量结果。
+- 需要用户从固定选项中选择时，使用当前 Agent 可用的选择交互，不要求用户重新输入长编号列表。
+- 多步骤流程中，前一步未获得必要结果或用户选择时，不得擅自推进下一步。
+- AI 陪练主管流程必须遵循其前台/后台输出边界，不回显中间 JSON 或调试输出。
+
+## 高风险操作确认
+
+以下操作执行前必须展示操作摘要，并获得明确同意：
+
+| 操作类别 | 示例 | 必须说明 |
+|---|---|---|
+| 删除 | 删除课程、考试、证书、图片或任务 | 目标对象和不可逆影响 |
+| 发布/上线 | 发布课程、试卷、考试、学习地图、AI 场景 | 发布对象和可见范围 |
+| 指派 | 给部门或批量用户指派课程、考试、学习地图 | 资源、对象范围和必修/选修属性 |
+| 批量写入 | 批量创建或更新记录 | 数量、字段和失败处理方式 |
+| AI 平台同步 | 应用场景、绑定知识包、发布或关闭场景 | 将要修改的场景和配置摘要 |
+
+确认流程：
+
+```text
+Step 1 → 展示操作类型、目标对象、影响范围
+Step 2 → 等待用户明确确认
+Step 3 → 按模块文档执行命令；仅在命令要求时使用确认参数
+Step 4 → 返回执行结果和真实对象 ID
+```
+
+## 跨模块标准工作流
+
+### 课程创建与发布
+
+```text
+课程分类 → 创建课程 → 上传素材 → 创建课件 → 配置课程 → 发布课程 → 指派学员
+```
+
+必须按 `soke-course` 流程执行。课件创建参数必须来自 `soke-material` 的真实上传结果。
+
+### 考试创建与成绩查询
+
+```text
+题库分类 → 题库 → 试题 → 试卷 → 发布试卷 → 考试 → 指派 → 查询成绩
+```
+
+填空题、发布参数和题库/试卷 ID 依赖以 [soke-exam](./references/modules/soke-exam/MODULE.md) 为准。
+
+### 学习地图与统计导出
+
+```text
+地图分类 → 创建地图 → 查询课程 → 创建阶段 → 发布地图 → 指派 → 创建 task 导出 → 查询 task
+```
+
+统计导出统一读取 [soke-task](./references/modules/soke-task/MODULE.md)，不要重复实现异步轮询。
+
+## 错误处理
+
+1. 记录失败命令、模块、参数摘要和完整错误信息，敏感字段必须脱敏。
+2. 参数错误时运行同一叶子命令的 `--help`，修正后再试；不要换成猜测的命令。
+3. 认证错误时检查配置并执行 `soke-cli auth login`。
+4. 权限错误时告知缺失权限或需要管理员开通的范围，不要绕过权限。
+5. 写操作重试前确认是否可能已经成功，避免重复创建或重复指派。
+6. 仍无法解决时报告失败阶段、错误摘要和建议的人工处理动作。
+
+## 随附脚本
+
+发布包只保留有实际职责的 Python 辅助脚本：
+
+- AI 陪练质量闸门：[gate_check.py](./references/modules/soke-ai-coach-director/scripts/gate_check.py)
+- AI 陪练操作校验：[validate_operations.py](./references/modules/soke-ai-coach-director/scripts/validate_operations.py)
+- Mono 环境检查：[check_readiness.py](./scripts/check_readiness.py)
+
+使用脚本前先阅读对应模块说明，并使用 `python3` 执行。脚本输出中的凭证、完整响应和调试数据不得直接回显给用户。
+
+## 详细参考（按需读取）
+
+- [安装与认证](./references/installation.md)
+- [共享 CLI 规则](./references/shared/cli-basics.md)
+- [课程模块](./references/modules/soke-course/)
+- [考试模块](./references/modules/soke-exam/)
+- [AI 陪练主管](./references/modules/soke-ai-coach-director/)
+- [AI 教练知识包](./references/modules/soke-ai-training/)
+- [学习地图](./references/modules/soke-learning-map/)
+- [培训需求](./references/modules/soke-training-demand/)
+- [案例库](./references/cases/)
+
+除非用户明确要求全量内容，否则只读取与当前意图直接相关的模块和参考文件。

package/skills/{soke-course/soke-cli/345/256/211/350/243/205/346/214/207/345/215/227.md → mono/references/installation.md}

@@ -434,9 +434,6 @@ npx skills add liuchenlong1111/soke-cli -y -g
 
 ### 📖 阅读详细文档
 
-- [README.md](../README.md) - 项目概览
-- [CLAUDE.md](../CLAUDE.md) - 项目架构和开发规范
-- [skills/README.md](../skills/README.md) - AI Agent Skills 详细说明
 
 ---
 

package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/README.md

@@ -96,9 +96,7 @@ soke-ai-coach-director/
 │   └── subs/                    # 分段 SOP
 └── scripts/                     # 工具脚本
     ├── validate_operations.py
-    ├── extract-skill.sh
-    ├── error-detector.sh
-    └── activator.sh
+    └── gate_check.py
 ```
 
 ## 关键规则速查

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

@@ -0,0 +1,123 @@
+---
+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/MODULE.md`](../../../soke-shared/MODULE.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
+```
+
+`+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": "loan-manual.pdf"
+    }
+  ],
+  "entries_path": "./knowledge-package.entries.json"
+}
+```
+
+## entries 格式（2026-08-18 实测补全）
+
+`entries_path` 指向的 JSON 是数组，每项字段：
+
+- `entry_id`：条目唯一 ID（如 `e_upgrade_super`）
+- `entry_type`：**必填枚举**，只能是 `customer_topic` / `disclosure_step` / `advisor_golden_script` / `evaluation_rubric_evidence` / `business_fact`（传其他值会 422）
+- `source_id`：来源 source 的 ID
+- `title`：条目标题
+- `content`：条目正文
+- `source_refs`：**对象数组**（不是字符串数组），形如 `[{"source_id": "src_manual"}]`（传字符串数组会 422）
+- `tags`：标签数组
+
+```json
+[
+  {
+    "entry_id": "e_001",
+    "entry_type": "business_fact",
+    "source_id": "src_manual",
+    "title": "产品权益",
+    "content": "……",
+    "source_refs": [{"source_id": "src_manual"}],
+    "tags": ["产品"]
+  }
+]
+```
+
+## 查询和管理
+
+```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 客户角色可见知识。
+- ⚠️ `+sync` **不支持 `--pretty`** 参数（加了会报 unknown flag，用 `--format json` 替代）。
+- ⚠️ `origin_filename` 用**纯 ASCII**（如 `manual.pdf`），中文文件名会触发 500「生成知识包上传凭证失败」（2026-08-18 实测）。
+- ⚠️ **v2.37 知识包复用提炼稿**：知识包 Markdown source 直接复用材料提炼稿（`/tmp/xxx_refined.md`），**禁止从零重写**（内容已在上下文中，重写浪费 3-5 积分）。只需按 entries 格式拆条目。
+- ⚠️ **v2.37 CLI 全重定向**：`+sync` / `+bind-scenario` 输出一律 `> /tmp/xxx.json 2>/dev/null`，Python 从重定向文件提取 `version_id` / `package_id`，**禁止 `--format json` 直出到对话**。

package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/self-learning-engine.md

@@ -464,10 +464,6 @@ grep -B5 'Priority\*\*: high' .learnings/*.md | grep '^## \['
 
 | 文件 | 用途 |
 |------|------|
-| `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` | 功能请求记录模板 |

package/skills/{soke-ai-training/SKILL.md → mono/references/modules/soke-ai-training/MODULE.md}

@@ -11,7 +11,7 @@ metadata:
 
 # AI教练知识包与场景管理
 
-**CRITICAL — 开始前 MUST 先读取 [`../soke-shared/SKILL.md`](../soke-shared/SKILL.md)，其中包含认证、配置和权限处理。**
+**CRITICAL — 开始前 MUST 先读取 [`../soke-shared/MODULE.md`](../soke-shared/MODULE.md)，其中包含认证、配置和权限处理。**
 
 ## 使用前提