Qingjiao Orchestrator

内容生成技能（Flow Skills）

这些技能使用模型能力生成内容，不直接调用平台工具。生成的内容最终通过capability skill写入平台。

意图识别与路由

根据用户输入，按以下规则判断应调度的技能：

直接意图匹配

模糊意图处理

当用户给出模糊目标（如"帮我制作一门大数据课程"），启动标准制作流程，先引导确认基本信息再逐步执行。

标准制作流程

当用户需要从零制作一门完整课程时，按以下流程自动串联执行。

前置：环境检测

执行任何平台操作前，先完成环境检测。阅读 qingjiao/qingjiao-shared/SKILL.md 的"环境检测与首次引导"章节获取完整流程。

简要步骤：

1. 调用 qingjiao_auth { action: "status" } 检测CLI可用性
2. 若不可用 → 引导安装 qingjiao-cli
3. 若未认证 → 引导提供JWT Token和租户UUID完成登录
4. 检测通过 → 进入业务流程

同一会话内检测通过后无需重复检测。

目标确认

在做任何操作前，先与用户对齐目标。确认以下信息：

1. 课程名称与主题方向
2. 目标受众（专业、年级、先修知识）
3. 总学时
4. 期望流程：从头生成 or 已有方案只需执行写入

引导策略：收到模糊需求后，先告知用户整体流程和确认节奏。逐一确认每项信息，确认一项再问下一项。若用户说"直接继续"，则减少中间确认节点，仅在关键写入节点保留确认。

第一阶段：全局内容规划（步骤 1-3）

每步完成后展示给用户确认，确认后自动进入下一步。

步骤 1 → generate-course-proposal
  阅读 qingjiao/generate-course-proposal/SKILL.md 并执行
  生成教学方案（三维目标、考核体系、教学安排）
  → 展示给用户确认
  → 确认后自动进入步骤 2

步骤 2 → design-course-structure
  阅读 qingjiao/design-course-structure/SKILL.md 并执行
  设计章节/小节结构清单
  → 展示给用户确认
  → 确认后：立即写入平台（创建课程→章节→小节），获取所有scenario_id
  → 写入时先阅读 qingjiao/qingjiao-shared/SKILL.md 遵循写入规范
  → 写入完成后自动进入步骤 3

步骤 3 → generate-course-introduce
  阅读 qingjiao/generate-course-introduce/SKILL.md 并执行
  生成课程详细介绍（写入introduce字段）
  → 展示给用户确认
  → 确认后通过 qingjiao_course { action: "introduce" } 写入平台
  → 写入完成后自动进入步骤 4

步骤2确认后立即写入平台，因为步骤4需要依赖scenario_id。

第二阶段：逐小节内容制作（步骤 4 循环）

按课程结构中的小节顺序逐个处理，每个小节完成全部内容后再进入下一个。

对每个实训类小节依次执行：

  4a. plan-scenario
      阅读 qingjiao/plan-scenario/SKILL.md 并执行
      规划该小节的实训场景列表（2-5个递进场景）
      → 展示给用户确认

  4b. [逐实训循环] generate-training
      阅读 qingjiao/generate-training/SKILL.md 并执行
      逐一生成每个实训的详细内容
      → 每个实训生成后展示给用户确认
      → 确认后立即通过 qingjiao_element 写入平台
        写入前阅读 qingjiao/qingjiao-element/SKILL.md 获取写入格式
      → 写入时遵循 qingjiao-shared 规范

  4c. [如有测验] generate-test-paper
      阅读 qingjiao/generate-test-paper/SKILL.md 并执行
      生成配套测试题
      → 展示给用户确认
      → 确认后立即通过 qingjiao_element 写入平台（type: "test_paper"）

对该小节全部完成后，自动进入下一个小节。

对理论类小节（如有），根据需要决定是否添加学习资料等元素。
如需上传PPT课件，调用 create-or-update-learn-material。

可选：实训环境准备

当课程需要容器或虚拟机环境时，阅读 qingjiao/qingjiao-lab-env/SKILL.md 并执行：

1. qingjiao_registry { action: "create" }       → 创建镜像仓库（首次使用）
2. qingjiao_registry { action: "account" }      → 获取推送账号（脱敏回显）
3. [外部] 构建镜像并推送到仓库
4. qingjiao_image { action: "save", ... }       → 登记镜像到平台
5. qingjiao_resource { action: "create", ... }  → 为course_id绑定课程实验环境
6. qingjiao_resource { action: "element_create", ... } → 为实训元素关联实验环境

最终：发布课程

所有内容制作完成并确认后：

1. 用自然语言回显课程名称、发布描述
2. 等待用户确认（发布操作不可逆）
3. qingjiao_course { action: "publish", course_id: <id>, ... }

ID 依赖关系

平台写入操作存在严格的层级依赖，必须遵守：

course_id → chapter_id → scenario_id → element_id

• 调用 qingjiao-chapter 前：必须已有 course_id
• 调用 qingjiao-scenario 前：必须已有 chapter_id
• 调用 qingjiao-element 前：必须已有 scenario_id
• 调用 qingjiao_resource 前：必须已有 course_id
• 调用 qingjiao_resource element_create 前：必须已有 course_id 和 element_id

每次创建操作返回的 id 需记录并复用，不要重复创建。

用户确认节点

以下节点必须等待用户明确确认后再继续：

写入规范摘要

所有平台写入操作必须遵循 qingjiao-shared 的规则：

1. 写前确认意图：确保用户信息已明确
2. 及时写入：信息明确后不要拖延，立即调用工具写入
3. 自然语言回显：写入前用自然语言向用户展示拟写入的关键信息摘要，不直接复述JSON
4. 大字段摘要：涉及content等大字段时只做摘要回显
5. 敏感字段脱敏：token、密钥等只能脱敏回显
6. 大字段写入方式：长文本先写入临时文件，通过 @<文件路径> 语法引用

调度规则

单步操作

当用户明确要求执行某个具体操作时（如"查看我的课程"、"创建一个章节"），直接调度对应技能，不需要走完整流程。

多步串联

当用户需要完成一个跨技能的任务时（如"制作一门课程"），按照标准制作流程自动串联，每步确认后自动进入下一步。

跳过确认

若用户表示"跳过确认"或"加快进度"，在后续流程中减少中间确认节点，直接按合理方案推进，仅在关键写入节点（平台写入前）保留确认。

修改优先

用户对规划内容有修改意见时，先修改完再执行写入，不要带着问题写入平台。

注意事项

1. capability skills 通过注册工具负责平台CRUD，不承担内容生成
2. flow skills 负责内容生成，不直接操作平台
3. 调度子技能前先阅读其SKILL.md获取完整指令，不要凭记忆调用
4. 每次调度 qingjiao-shared 中涉及的capability skill前，先确认已了解工具调用规范
5. 同一ID不需要重复创建，直接复用已有ID继续下一步
6. 课程发布操作不可逆，进入审核流程后不可再编辑