@sokeai/cli 1.0.79 → 1.0.80

package/skills/mono/references/modules/soke-course/MODULE.md

@@ -1,402 +1,160 @@
 ---
 name: soke-course
-version: 5.0.0
+version: 6.49.0
 description: >
-  线上课创建与发布的端到端编排技能，课程发布主管。
-  负责识别用户意图、选择执行流程、校验前置条件、调度 3 个并列技能完成全链路操作。
-  当用户想创建课程、上传课件、配置设置、发布课程、指派学员时触发。
+  授客AI课程主流程编排模块：负责课程创建、分类、模板、设置、发布、查询与维护，并编排同级模块完成素材、课件、小测验和指派操作。
 author: Soke Team
-tags: [课程管理, 流程编排, 发布管理]
+tags: [soke, course, orchestration, publish]
 ---
 
-# 课程发布主管
+# 课程主流程编排
 
-> **CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../../../references/installation.md`](../../../references/installation.md)，其中包含认证、配置、权限处理。**
+本模块与 `soke-material`、`soke-lesson`、`soke-assign`、`soke-exam`、`soke-photo-gallery` 是并列模块，不包含它们的 SOP，也不直接实现它们的业务操作。
 
-## 交互规范（必须遵守）
+## 共享前置
 
-**任何需要用户从固定选项中做选择的场景，必须调用 `ask_user_question` 工具弹窗，禁止纯文本罗列让用户打字。**
+开始前先做最小就绪探测（`soke-cli --version` + `soke-cli config show`），失败才按需读 `../../shared/README.md` 对应项。本模块只保留课程编排业务规则；通用环境、认证、命令、对象、交互、写入验证和输出脱敏不在此重复定义。
 
-适用场景：
-- 选择课程分类（列出所有分类，最后一项为"🆕 新建分类"）
-- 歧义消解（不确定用户想做什么时）
-- 确认是否继续（"还要加课件吗？"/"调顺序吗？"/"确认发布？"）
-- 选择发布对象（部门/用户列表）
-- 中断恢复（从已有课程列表中选择继续哪个）
-- 任何其他有 2-4 个固定选项的决策点
+## 职责
 
-弹窗标准格式：
-```
-ask_user_question
-  question: "选择课程分类"
-  header: "分类"
-  options:
-    - label: "📁 技术研发"  description: "一级分类"
-    - label: "📁 企业管理"  description: "一级分类"
-    - label: "🆕 新建分类"  description: "前往管理后台新建分类"
-```
+本模块负责课程对象及课程主流程编排（创建、课件、设置、指派、发布、查询、维护），不负责素材上传、课件创建、小测验实现或指派实现。
 
-## 使用前提
+## 交互规范（硬规则）
 
-1. 已安装 `soke-cli`
-2. 已登录授权 — 首次执行时自动检查并引导登录
+### 模式判定
 
-**登录状态检查与自动登录（必须执行）：**
+- **创建课程时第一步先定模式**：create 意图（创建/新建/做课/开课/上传课程）下，除已明确给出 `course-id`（→ 当前课程操作）、本地目录（→ 批量流程）、或单个文件/课程标题（→ 单课程流程）外，**第一步必须先用原生二选一询问「单课程上传」/「多课程批量上传」，禁止默认进单课程**。
+- 目录扫描默认**不跟随符号链接、忽略隐藏文件、扩展名大小写不敏感**；空目录、无支持课件、无权限或同名冲突必须先提示，不直接执行。
+- 确认模式前不得执行任何写入类 CLI。
 
-```bash
-# 第一步：检查登录状态
-soke-cli config show
-```
+### 编码方案（全局约定）
 
-若返回包含 `user_token` → ✅ 已登录，继续。
+| 编码 | 含义 | 选项 |
+|---|---|---|
+| A | 课件来源 | A1 本地上传 / A2 素材库选择 |
+| B | 课程分类 | B1..Bn 一级，10 个/页，「下一页」翻页、「搜索 XX」搜索 |
+| C | 课程模板 | C1..C7 全列，编码放模板名称前 |
+| D | 小测验 | D1 加 / D2 不加 |
+| E | 发布 | E1 发布 / E2 不发布 |
+| F | 学习类型 | F1 必修 / F2 选修 |
+| G | 指派 | G1 指派 / G2 不指派 |
+| H | 出题方式 | H1 选择试卷 / H2 导入试卷 |
 
-若返回无 `user_token` 或报错 → ⚠️ 未登录，立即执行：
+- A1 → 同句或下句贴本地路径；A2 → 展示素材编号列表（20 个/页、「下一页」翻页、「搜索 XX」搜索），回复编号选定。
+- 标题在输入框自由输入，**禁止建议标题**；提示用固定话术「请输入你要上传的课程标题」，禁止内部状态叙述。
+- 默认流程顺序：**先上传课件 → 再问小测验 → 最后指派+发布条件弹窗（G2 不出现 F 问）**。
+- 指派弹窗选项顺序固定为「1. 指派（推荐） 2. 不指派」；发布弹窗选项顺序固定为「1. 发布 2. 不发布」，仅用户明确选择「1. 发布」才执行发布，**禁止代发布**。
+- 排序/设置默认不问（告知「随时说'调顺序/改设置'」）。
 
-```bash
-# 第二步：自动打开浏览器完成 OAuth 授权
-# soke-cli auth login 会自动调用系统默认浏览器打开授权页面
-soke-cli auth login
-```
+### 展示规范
 
-`soke-cli auth login` 执行后会自动打开浏览器到授客AI开放平台授权页，用户在浏览器中完成登录授权即可。授权成功后 CLI 终端会显示 `✅ 已登录`，Token 自动保存至 `~/.soke-cli/config.json`。
+- 展示中文化；**全部输出用 markdown 格式**：选择列表用表格、提示语加粗；**回复指引行一律放表格下方**。
 
-> 如果浏览器没有自动打开，终端会输出授权链接，手动复制到浏览器打开即可完成授权。
+### 弹窗例外
 
-**任何课程操作之前，必须先通过上述两步确认登录状态。未登录时禁止跳过，必须完成登录后再继续。**
+- 使用**原生弹窗**的项：模式选择、批量上传确认、加小测验、出题方式、指派、发布确认、指派部门选择和发布警告。
+- 已有试卷选择**不使用弹窗**，改为当前对话中用 Markdown 表格展示前 20 份试卷，表格下方附固定提示：「回复"搜索 XX"可模糊匹配；"下一页"翻页（当前仅 1 页）。」
+- 已有试卷列表仅在当前对话展示，不生成独立文件、远程页面或远程课程界面，也不同步到远程平台。
+- 试卷挂载、小测验导入或挂载成功后，必须立即弹出指派与发布条件选择，不得只输出状态后结束。
+- 选择部门指派后，先拉取并在原生弹窗罗列可选部门再让用户选择，不能只要求用户输入部门名称。
+- 批量上传确认必须在目录扫描并展示计划表后弹出，用户确认后才能执行创建与上传。
 
-## 一、触发描述
+## 意图路由（Gate 0）
 
-### 触发词
+| 意图 | 路由 |
+| --- | --- |
+| create（创建/新建/做课/开课） | Phase 1 全流程 |
+| add_lesson（加课件/传视频/排序） | Phase 2（需 course-id） |
+| settings（学分/封面/倍速/人脸/提醒） | Phase 3 |
+| assign（指派/必修/选修） | Phase 4（发布前） |
+| publish（发布/上线/定时发布） | Phase 4（指派后最后一步，仅明确 E1 执行） |
+| query（进度/完成率/谁学了/作业提交） | Phase 5 |
+| maintain（关闭/删除/复制） | Phase 5 维护 |
+| category（分类查询） | read subs/category |
 
-| 意图 | 触发词 |
-|------|--------|
-| 创建课程 | 创建/新建/做课/开课/生成课程 |
-| 课件管理 | 添加课件/加视频/加音频/加文档/课件排序/调顺序 |
-| 课程设置 | 设置学分/积分/讲师/封面/标签/修改分类/简介 |
-| 高级设置 | 倍速/人脸/提醒/学习模式/解锁/评价/证书/签名/钉钉群 |
-| 收费设置 | 收费/价格/试看/免费/付费 |
-| 发布 | 发布/上线/定时发布/审批 |
-| 指派 | 指派/安排学习/分配学员/必修/选修 |
-| 查询 | 学习进度/完成率/谁学了/谁完成 |
-| 维护 | 关闭/删除/下架/复制/克隆 |
-| 分类管理 | 分类/课程分类/添加分类/新建分类 |
+上下文规则：
 
-### 上下文触发
-- 对话已有 course-id → 在当前课程上操作，不创建新课程
-- 用户上传文件 + 提"课件"/"课程" → 课件子流程
+- 有 course-id → 当前课程操作，不新建；
+- 学习统计未指定课程 → 先列出已发布线上课前 20 个并在表格下方提示「回复「搜索 XX」可模糊匹配；"下一页"翻页（当前仅 1 页）。」，用户选定后再查统计；
+- 有文件附件 → 倾向课件；
+- 歧义 → 弹窗列可能操作；
+- 显式调用本技能且意图不明或与课程无关 → 默认走创建/上传主流程（**先弹模式二选一「单课程上传/多课程批量上传」→ 单课程再提示输入标题并收集 A/B/C**），不展开无关话题；
+- 含明确他意图（查询/发布/指派/设置/维护）→ 对应 Phase。
 
-### 不触发（交给独立 skill）
-- 纯考试/题库/试卷
-- 学习地图
-- 纯素材浏览（不提课程）
-- 单查学员档案（无课程上下文）
-
-## 二、输入要求
-
-### 创建课程
-  必填: 课程标题 + 课程分类
-  可选: 描述/学分/讲师/标签/封面
-
-### 添加课件
-  必填: 课件内容（文件路径或文本）
-  从上下文获取: course-id
-
-### 发布
-  从上下文获取: course-id
-  前置: Gate Check 全部通过
-
-### 指派
-  必填: 部门名或用户名 + course-id
-
-## 三、执行流程
-
-### 3.1 意图路由
-
-```
-用户消息 → 关键词 → 意图 → 路由
-
-create       → 3.2 全流程创建
-add_lesson   → 3.3 课件子流程
-settings     → 3.4 设置子流程（→ read references/subs/settings/SOP.md）
-publish      → 3.5 发布子流程（→ read references/subs/publish/SOP.md）
-assign       → 3.6 指派子流程
-query        → 3.7 查询子流程（→ read references/subs/query/SOP.md）
-maintain     → 3.8 维护子流程
-category     → read references/subs/category/SOP.md
-```
-
-歧义消解: 上下文有 course-id → 当前课程操作 | 有文件附件 → 倾向课件 | 不确定 → `ask_user_question` 弹窗列出可能的操作让用户点选（如"创建课程"/"添加课件"/"修改设置"）
-
-### 3.2 全流程创建（主链路）
-
-> 完整 SOP 见 references/sop-full-workflow.md
-
-#### Phase 1: 创建课程骨架
-
-Step 1.1 权限检查（自动登录）
-  exec: soke-cli config show
-  → 有 user_token → ✅ 跳过登录
-  → 无 user_token → exec: soke-cli auth login（自动打开浏览器）
-    等待用户在浏览器中完成授权
-    再次 exec: soke-cli config show 确认 user_token 已写入
-  登录完成 → 继续下一步
-
-Step 1.2 获取分类
-  → read references/subs/category/SOP.md 执行
-  执行: soke course +list-categories 获取分类树
-  策略:
-    1. 用户已指定分类名 → 精确/模糊匹配到唯一结果 → 直接使用
-    2. 匹配到多个结果 → `ask_user_question` 弹窗让用户选一个，最后加一项"🆕 新建分类"
-    3. 用户未指定 → `ask_user_question` 弹窗列出所有一级分类，最后加一项"🆕 新建分类"
-    4. 用户说"随便" → 取第一个一级分类
-  → 用户选"🆕 新建分类" → 告知："CLI 暂不支持新建分类，请前往管理后台 → 课程管理 → 分类设置 → 新增分类" → 新建完成后说"分类建好了"再继续
-  提取: category-id → 存上下文
-
-Step 1.3 创建课程
-  自身: course +create --title "xxx" --category-id "xxx"
-  提取: course-id → 存上下文
-
-Step 1.4 选择模板（创建课程后立即触发）
-  → read references/subs/template/SOP.md 执行
-  弹窗: `ask_user_question` 列出 7 个模板（含"7. 不选择模板"）
-  用户选 1-6 → 输出该模板的配置清单（标注后台路径） → 确认后继续
-  用户选 7 → 不输出配置，直接进入路由弹窗
-  详见: references/subs/template/SOP.md
-
-Gate 1→2: ✅ 有 course-id
-
-Phase 1 完成后 → `ask_user_question` 弹窗: "下一步？" → ["添加课件"/"先做设置"/"直接发布"]
-  选"添加课件" → 进入 Phase 2
-  选"先做设置" → 跳到 Phase 3
-  选"直接发布" → 跳到 Phase 4（需通过 Gate Check）
-
-#### Phase 2: 构建课件
-
-Step 2.1 选择素材来源
-  → `ask_user_question` 弹窗: "从哪儿添加课件素材？" → ["📁 本地上传"/"📚 素材库选择"]
-  选"本地上传" → 进入 Step 2.2
-  选"素材库选择" → 进入 Step 2.2b
-
-Step 2.2 本地上传
-  可上传: 视频(.mp4/.avi/.mov/.mkv/.webm)、音频(.mp3/.wav/.ogg/.flac/.aac)、文档(.pdf/.ppt/.pptx/.doc/.docx/.xls/.xlsx)
-  ⚠️ 不支持 CLI: 图片/文章/外链/小测验/作业 → 告知后台路径
-  → 用户提供本地文件路径
-  → 调度 soke-material: file +upload（自动根据扩展名判断类型）
-  提取: media-id + 全字段信息 → 存 media_ids[]
-  → 进入 Step 2.3
+案例库见 [`intent-cases.md`](./intent-cases.md)。
 
-Step 2.2b 素材库选择
-  → 调度 soke-material
-  exec: soke file list-files（分页拉取全量素材列表）
-  展示: 文件名 / 类型 / 大小 / 日期（分页或截取前 20 条）
-  告知用户: "输入关键词搜索素材（文件名模糊匹配），或输入序号选择"
-  用户输入关键词 → 在素材列表中模糊匹配 → 弹窗列匹配项
-  用户选序号 → 确认该素材 → 提取全字段信息 → 存 media_ids[]
-  无目标素材 → 弹窗: "素材库中没找到，要不要切换到本地上传？" → ["切本地上传"/"重新搜索"]
-  选"切本地上传" → 回到 Step 2.2
-  → 进入 Step 2.3
+## 输入
 
-Step 2.3 创建课件
-  → 调度 soke-lesson
-  参数全部来自 Step 2.2 或 Step 2.2b 的返回
-  提取: lesson-id
-  存: lesson_ids[]
+- 课程名称、分类和课程设置
+- 用户明确的创建、配置、发布或查询动作
+- 跨模块操作所需的真实课程、素材、课件、试卷、用户/部门 ID
 
-Step 2.4 循环
-  → `ask_user_question` 弹窗: "还要加课件吗？" → ["继续加课件"/"不了，进入下一步"]
+## 主流程（5 Phase，进入各阶段才加载对应 SOP）
 
-Step 2.5 排序（可选）
-  → `ask_user_question` 弹窗: "需要调整课件顺序吗？" → ["调整顺序"/"保持现状"]
-  选"调整" → 调度 soke-lesson 排序
+### Phase 1 创建骨架 → read `subs/phase1-create/SOP.md`
 
-Gate 2→3: ✅ 课件 ≥ 1
+模式路由 → 就绪探测 → 首轮收集（标题 + A/B/C 编码，固定格式）→ 查重 → `course +create` 提取 course-id → `+advanced` 模板写入并展示「模板相关设置」表。
 
-#### Phase 3: 课程设置
+**Gate 1→2：course-id 非空。**
 
-  → read references/subs/settings/SOP.md 执行
-    基础: title/credit/description/image（course +update）
+### Phase 2 构建课件 → read `subs/phase2-lesson/SOP.md`
 
-  → read references/subs/template/SOP.md Step 3 执行
-    将当前所有设置项以表格形式展示（仅「设置项」+「当前值」两列）
-    告知用户: "想修改哪项？直接告诉我就行。"
-  用户指令处理:
-    - 标题/学分/描述/封面 → exec: course +update（✅ CLI 支持） → 刷新表格
-    - 学习模式/倍速/人脸/提醒/评价/拖动/评论/文档防挂机/交流群二维码 → exec: course +advanced（✅ CLI 支持；交流群二维码本地图片用 --image-file，命令内部只上传 OSS，不进入图片库） → 刷新表格
-    - 其他设置 → "已记录: {项} → {新值}（需在后台操作: {路径}）" → 刷新表格
-    - "可以了"/"继续" → 退出 Phase 3
-  循环直到用户确认
+上传课件（按扩展名判型、逐项不弹窗）→ 加小测验（弹窗，read `subs/exam/SOP.md`）→ 排序按需。
 
-Gate 3→4: 无硬阻塞
+**Gate 2→3：课件 ≥ 1。**
 
-#### Phase 4: 发布
+### Phase 3 课程设置 → read `subs/settings/SOP.md`
 
-  → read references/subs/publish/SOP.md 执行
-    Gate Check: 标题/分类/课件数量/转码状态
-    直接发布 → course +publish --course-id <uuid>
-    定时发布 → course +publish --course-id <uuid> --publish-time "<北京时间>"
-    审批/批量 → ⚠️ CLI 不支持
-
-Gate 4→5: ✅ status=1
-
-#### Phase 5: 指派学员
-
-  → 调度 soke-assign
-
-  Step 5.1 拉取部门列表
-    exec: soke assign +list-departments
-    提取: 全量部门名称+ID → 存内存
-
-  Step 5.2 用户输入关键词搜索
-    告知用户: "请输入要指派的部门名称（支持模糊搜索）"
-    用户输入关键词 → 在部门列表中模糊匹配（不区分大小写，支持部分匹配）
-    匹配结果:
-      - 唯一匹配 → 直接确认使用
-      - 多个匹配 → `ask_user_question` 弹窗列出匹配的部门让用户选
-      - 无匹配 → 建议换个关键词，或 `ask_user_question` 弹窗列所有部门
-
-  Step 5.3 确认指派方式
-    → `ask_user_question` 弹窗: "必修还是选修？" → ["必修"/"选修"]
+课件完成后默认展示一次「基础+高级」设置摘要；收费 read `subs/charge/SOP.md`；封面新图走 photo 链。
 
-  Step 5.4 执行指派
-    exec: soke assign +create --module course --module-id <courseId> --compulsory 1|0 --user-ids "<用部门 ID 查到的人员>"
+**Gate 3→4：无硬阻塞。**
 
-#### Phase 6: 运营维护
+### Phase 4 指派 + 发布 → read `subs/assign/SOP.md` + `subs/publish/SOP.md` + `sop-publish-check.md`
 
-  → read references/subs/query/SOP.md 执行（进度/记录/人脸）
-  → read references/subs/publish/SOP.md 执行（关闭/删除；删除仅允许 status=0/2）
-  → read references/subs/copy/SOP.md 执行（复制，⚠️）
-
-### 3.3 课件子流程
-
-前提: 上下文有 course-id
-流程: = Phase 2（判断类型→上传→创建→循环→排序）
-
-### 3.4 设置子流程
-
-前提: 上下文有 course-id
-流程: read references/subs/settings/SOP.md + references/subs/charge/SOP.md 执行
+弹窗1「指派？」→ G1 指派（部门/人员 + F 学习类型，G2 不出现 F）→ 弹窗2「发布？」→ 仅明确 E1 才执行 `course +publish`，禁止代发布。
 
-### 3.5 发布子流程
-
-前提: course-id + status=0
-流程: read references/subs/publish/SOP.md 执行 → Gate Check → 发布 → 询问指派
-
-### 3.6 指派子流程
-
-前提: course-id + status=1
-流程: 调度 soke-assign → 拉全量部门 → 用户输入关键词搜索 → 确认 → 指派
-
-### 3.7 查询子流程
-
-前提: course-id
-流程: read references/subs/query/SOP.md 执行 → 进度/记录/人脸
+### Phase 5 运营维护 → read `subs/query/SOP.md` + `subs/copy/SOP.md`
 
-### 3.8 维护子流程
+查询进度/记录/人脸 + clock 作业；关闭 `course +update --action close`（⚠️ 先确认无学习地图关联）；删除/复制/审批/批量 → 后台话术。
 
-流程: read references/subs/publish/SOP.md（关闭/删除，删除前必须校验 status=0 未发布或 status=2 已关闭）/ references/subs/copy/SOP.md（复制）/ references/subs/category/SOP.md（分类）
+## 批量生成课程流程 → read `subs/batch/SOP.md`
 
-### SOP 执行 5 步法
+Step 1.0 选「批量生成课程」进入。B0 模式 → B1 首轮收集（B + C + 目录路径，一次出）→ B2 目录扫描（只访问二级）→ B3 计划确认（必须弹窗）→ B4 逐课执行（固定无小测验）→ B5 指派（可选，未发布也可指派）→ B6 发布确认（指派完成后单独弹窗）→ B7 汇总可重试。
 
-1. READ `references/subs/<name>/SOP.md` → 理解输入输出
-2. BUILD 从上下文提取参数
-3. EXEC 按 SOP 流程调用 CLI
-4. PARSE 按 SOP 输出标准解析
-5. STORE 关键值写入上下文
+## 课程分类（创建课程必做）
 
-上下文变量: course_id / category_id / lesson_ids[] / media_ids[] / course_status / current_phase
+创建课程前必须先展示真实课程分类，禁止占位符、预设列表或空表。规则见 [`subs/category/SOP.md`](./subs/category/SOP.md)。
 
-## 四、输出标准
+## 课程模板（创建课程后立即）
 
-### 每步即时输出
-```
-✅ <做了什么>
-📋 <关键数据>
-⏭️ <下一步建议>
-```
-
-### 阶段状态报告
-```
-📋 课程: <标题> (id: <uuid>)
-   Phase 1 ✅ 已创建
-   Phase 2 🔄 课件 3 个
-     ├─ ✅ 第1课: 环境搭建 (video, 转码完成)
-     ├─ ✅ 第2课: Pandas (video, 转码中)
-     └─ ✅ 第3课: 数据清洗.pdf (document)
-   Phase 3 ⏸️  设置
-   Phase 4 ⏸️  发布（阻塞: 第2课转码中）
-   Phase 5 ⏸️  指派
-   下一步: 等转码完成后发布
-```
+创建后立即展示模板表（C1-C7，编码放名称前）。规则见 [`subs/template/SOP.md`](./subs/template/SOP.md)。
 
-### Gate Check 矩阵
+## 业务特例
 
-| # | 检查项 | 获取方式 | 严重度 | 不通过时 |
-|---|--------|---------|--------|---------|
-| 1 | 标题非空 | +get-course.title | 🔴阻塞 | 请设置标题 |
-| 2 | 分类已选 | +get-course.category_id | 🔴阻塞 | 请选择分类 |
-| 3 | 课件≥1 | +lesson-list count | 🔴阻塞 | 至少1个课件 |
-| 4 | 无转码失败 | +lesson-list.transcode_status | 🔴阻塞 | 课件[X]转码失败 |
-| 5 | 无转码中 | +lesson-list.transcode_status | 🟡警告 | 课件[X]转码中，确认发布？ |
-| 6 | 付费方式 | 需确认 | 🟡警告 | — |
-
-### 最终交付
-```
-📦 课程已发布: <标题>
-🔗 ID: <uuid> | 📊 课件: 5 个 | 👥 已指派: 研发部(32人)
-⏭️ 查看进度: 说"看看学习进度"
-```
-
-## 五、注意事项
-
-### 硬规则
-1. 不编造参数 — UUID 来自真实返回
-2. 不跳过 Gate — 发布前逐项校验
-3. 不静默失败 — 失败: 查排错文档 → 中文告知 → 修复建议 → 保存进度 → 提供选项
-4. 类型必须匹配 — 课件与素材类型一致
-5. 一个 course-id 贯穿全部
-
-### 架构分工
-
-**外部并列技能**（独立 skill，通过 skill 调度）:
-- 上传文件到素材库 → soke-material
-- 基于素材创建课件 → soke-lesson
-- 将课程指派给学员 → soke-assign
-
-**内嵌 SOP**（references/subs/ 下，按需 read 执行）:
-- 管理课程分类 → references/subs/category/SOP.md
-- 配置课程设置 → references/subs/settings/SOP.md
-- 设置收费 → references/subs/charge/SOP.md
-- 发布校验和发布 → references/subs/publish/SOP.md
-- 复制课程 → references/subs/copy/SOP.md
-- 查询学习数据 → references/subs/query/SOP.md
-- AI生成课程 → references/subs/ai/SOP.md
-- 课程模板（7套预置配置） → references/subs/template/SOP.md
-
-### 已知 CLI 缺失
-
-统一话术: "XXX 功能暂不支持 CLI 操作，请在后台手动设置。"
-
-| 类别 | 缺失 |
-|------|------|
-| 课件类型 | image/article/link/quiz/homework |
-| 分类 | 新增分类 |
-| 课程设置 | point/lector_id/tags/简介插图 |
-| 高级设置 | 证书/签名 |
-| 收费 | 价格/试看 |
-| 发布 | 审批/批量 |
-| 维护 | 复制 |
-
-### 中断恢复
-用户"继续"/"接着做": 检查 course-id → 有:查状态+课件→报告→继续 | 无:列课程→选→恢复
-
-## 六、交付前自查
-
-- [ ] 每步有明确调度目标
-- [ ] 关键返回值已存入上下文
-- [ ] 每步完成有下一步建议
-- [ ] 发布前过完整 Gate Check
-- [ ] CLI 不支持功能已告知替代路径
-- [ ] 失败有修复建议
-- [ ] 所有固定选项的决策点均使用 `ask_user_question` 弹窗（禁止纯文本罗列让用户打字）
-- [ ] 分类选择弹窗最后一项始终为"🆕 新建分类"
-- [ ] 状态报告完整
+- 发布、定时发布、关闭和批量操作必须执行课程专属校验与确认。
+- 跨模块调用只能传递 CLI 返回的真实 ID。
+- 详细字段、阶段闸门和课程专属规则以本模块 `subs/` 下的专项 SOP 为准。
+
+**失败降级**：若任一被编排子模块返回失败或状态未达预期，整体编排视为未完成，应停下并说明阻塞点（如素材未上传、课件创建失败、课程未发布），不得跨模块强行推进或假装成功。跨模块只传递 CLI 返回的真实 ID；子模块失败时不得用占位 ID 继续。
+
+## 输出
+
+- 返回课程创建、配置、发布或查询的业务摘要。
+- 仅在后续流程确实需要时传递课程真实 ID。
+- 输出边界遵循共享层 `output-policy.md` 和 `write-verify.md`。
+
+**完成判定**：本模块为编排层，任何"完成"都必须以被编排子模块（soke-material / soke-lesson / soke-exam / soke-assign 等）的真实返回与回读为准——例如课程发布完成当且仅当发布校验通过且课程状态为已发布。编排层不得仅凭自身流程走到末尾就向用户宣称"完成"。
+
+## 并列模块调用
+
+- 上传或选择素材：调用 `../soke-material/MODULE.md`
+- 创建、查询、排序课件：调用 `../soke-lesson/MODULE.md`
+- 指派课程、查询部门与用户：调用 `../soke-assign/MODULE.md`
+- 小测验、试卷、题库：调用 `../soke-exam/MODULE.md`
+- 图片库、封面图：调用 `../soke-photo-gallery/MODULE.md`
+
+调用时只传递 CLI 返回的真实 `course-id`、`media-id`、`lesson-id`、`paper-id`、用户/部门 ID；不得在本模块复制、改写或内嵌上述模块的执行细节。
+
+## 执行入口
+
+本模块详细业务规则、阶段闸门、确认弹窗、批量流程和发布校验以 `subs/` 下的专项 SOP 为准：创建骨架 `subs/phase1-create/SOP.md`、课件构建 `subs/phase2-lesson/SOP.md`、分类 `subs/category/SOP.md`、模板 `subs/template/SOP.md`、设置 `subs/settings/SOP.md`、发布 `subs/publish/SOP.md`、查询 `subs/query/SOP.md`、批量 `subs/batch/SOP.md`、指派 `subs/assign/SOP.md`、小测验 `subs/exam/SOP.md`、图片 `subs/photo/SOP.md`、收费 `subs/charge/SOP.md`、维护 `subs/copy/SOP.md`。意图案例见 [`intent-cases.md`](./intent-cases.md)，发布 Gate Check 见 [`sop-publish-check.md`](./sop-publish-check.md)。需要参数时读取 [`cli-facts.md`](./cli-facts.md)。