OpenMAIC「大师讲授」模式深度解析用 lecture-style 技能设计连续讲授型多智能体课堂【免费下载链接】OpenMAICOpen Multi-Agent Interactive Classroom — Get an immersive, multi-agent learning experience in just one click项目地址: https://gitcode.com/GitHub_Trending/op/OpenMAICOpenMAICOpen Multi-Agent Interactive Classroom是一键构建沉浸式多智能体学习体验的开源项目。在其 agent-runtime 技能体系中lecture-style大师讲授是一套面向「系统讲解型课程」的课堂设计技能一门课由一位讲师的声音从头讲到尾页面服务于论证而非打断论证。本文以 skills/agent-runtime/lecture-style/SKILL.md 为主体结合同目录的结构化约束文件、stage-design基础构建流程、generate_scene/set_roster等运行时工具的源码实现完整拆解该技能的设计形态、页面密度规则、旁白撰写规范、阵容写法、约束检查机制及其与workshop-style/deep-interactive的分工。读完本文你将掌握如何识别一个「大师课」请求、如何规划并逐页生成一场 slide 载体的连续讲授课堂以及风格如何通过brief、persona、materialFacts三个字段真实传入生成器。一、技能定位什么是 lecture-stylelecture-style的中文标题是「大师讲授」其 frontmatter 描述给出了明确的触发条件与边界适用场景lecture、masterclass、对一个学科的系统讲解「大师课」「系统讲解」「讲透」或任何「收获在于理解而非动手」的主题用户直接点名该风格时同样启用。不适用场景动手实操型课程应使用workshop-style以操纵某种机制为核心目标的课程应使用deep-interactive。从源码看技能的可发现性由 lib/server/agent-runtime/skills.ts 承载loadSkills()解析每个技能目录下的SKILL.mdfrontmatteravailableSkillsPromptBlock()把 name/description/location 渲染进系统提示模型在请求匹配时通过 pi 的原生read工具读取 SKILL.md 全文。每个技能目录允许携带一个可选的outline-constraints.json结构化约束文件——它与 frontmatter 刻意分离frontmatter 是「模型可见的契约」约束文件是「检查器的契约」避免每次 schema 调整都改动模型实际读到的正文见skills.ts中listBuiltinSkills的实现注释。lecture-style 不是孤立存在的。stage-design是构建任何 stage 的地基——规划方式、工具调用顺序、阵容书写、旁白再合成时机、收尾条件——它在所有主题技能之下生效主题技能lecture-style、deep-interactive、vocational 等决定 stage 里装什么。SKILL.md 开头也明确强调「stage-designstill governs how the stage is built — outline, roster, one page pergenerate_scene, audio before done. This skill governs what the stage contains and how it sounds.」因此使用 lecture-style 时应先阅读 skills/agent-runtime/stage-design/SKILL.md。二、课堂形态The shapeslide 载体的连续论证lecture-style 对整门课的页面结构有明确的形态约束这是与其它风格最显著的分野第 1 幕必须是slide且要「真正地开场」提出这个主题要回答的问题、为什么它值得花一小时、这堂课将如何展开。它既不是定义页也不是目录页。主体是slide页面以「弧」arc组织。一条弧由 3 到 5 页构成把同一个想法从「断言」推到「后果」先给出主张claim再讲底下的机制mechanism然后用真实案例检验它。弧与弧首尾相接整堂课从不重新开始。检查点checkpoint必须稀少大约每 4 到 5 页一个quiz位置在一条弧收束、下一条弧开启的接缝处测试的是学习者能否应用弧里的思想而不是复述字句。SKILL.md 用一句犀利的判据划清边界「两页里放两个 quiz那不是讲座那是中间夹着幻灯片的测验。」至多一个interactive页面放在全课机制感最强的那一个概念上——那个「光靠讲真的传不过去、学习者必须亲眼看它动起来」的地方。如果一个主题有两个这样的概念放第二个尚可辩护出现第三个说明这个请求根本不是讲座deep-interactive更合适。收尾收在论证上而不是要点罗列这堂课确立了什么、刻意留下了什么没讲、好奇的学习者下一步该往哪走。这一形态不是纯文字约定它被机器可检查地固化在同目录的 skills/agent-runtime/lecture-style/outline-constraints.json 中{ allowedTypes: [slide, quiz, interactive], firstSceneType: slide, typeMix: [ { type: slide, minRatio: 0.65 }, { type: quiz, min: 1, max: 3 }, { type: interactive, max: 2 } ] }即本课只允许slide/quiz/interactive三种页面类型第 1 幕必须是slideslide至少占 65%quiz至少 1 个、至多 3 个interactive至多 2 个。约束文件注释还专门说明旁白长度与口吻——本风格最响的部分——不是结构性内容无法在此检查它们经由keyPoints、阵容 persona 与逐页materialFacts传入。三、约束检查机制从大纲到持久化页面的机器校验约束文件的价值在于它被真实执行。skills.ts提供了两条检查路径checkOutlineAgainstSkill(outlines, constraints)对模型产出的课程大纲做机器检查返回人类可读的违规清单。检查项覆盖场景总数上下限、非法类型、第 1 幕类型、typeMix 的 min/max/minRatio、interactive 页的 widgetType 与 widgetOutline 必填字段、连续两页同 widgetType 等。checkScenesAgainstSkill(scenes, constraints)对实际持久化的页面做同样的检查。generate_scene每次落盘一页后都会调用它违规以 tool-result diagnostic 的形式回传给 agent由 agent 决定是否重新规划。skills.ts中一个值得注意的设计决策检查只返回诊断、不做自动重写。注释写道——「一个计划是一个连贯的整体机械地把某页类型翻来翻去满足比例产出的课程读起来像被 linter 拼出来的」。违规信息回到 agent 手里由它判断如何修复持久化也永远不会被该检查回滚。在 tests/agent-runtime/skills.test.ts 中有一个专门测试组pedagogy style skills用「对比法」验证两个风格约束的互斥性一个 masterclass 形态的页面组合slide为主体、第 5 页一个quiz、第 8 页一个simulationinteractive通过checkOutlineAgainstSkill检查时对 lecture-style 返回[]零违规。同一个 masterclass 组合拿去喂 workshop-style 的约束会被判定违规interactive 至少 3、quiz 至少 2。反之workshop 形态的页面组合slide/interactive 交错喂给 lecture-style会产生「slide 不足 65%」「interactive 超过上限」两类违规。这意味着一个请求若在两种风格下反复重生成产出的课程必须肉眼可辨地不同——这正是「风格是有实质约束、而非口头承诺」的测试锚点。测试还断言两种风格的 SKILL.md 内容都包含materialFacts、brief、set_roster、voiceDesign这些字段名以及「exactly one teacher」确保风格能被正确地传入生成器实际读取的字段。四、页面密度命题式的 keyPoints 与贯穿全课的案例lecture-style 明确声明「密度是特性」一页只说一件事的讲座页是浪费的一页。具体规则每个主体页携带4 到 6 条keyPoints而且它们是命题不是标签——「利率上升先压估值再压盈利」而不是「利率影响」。一页装载「一个主张加让它站住的证据」定义及其边界、机制加一个走通的案例、对比加一条区分两边的判据。每条弧必须命名一个真实案例——一家公司、一项研究、一段历史、一段代码——并让它反复出现。SKILL.md 的批评非常具体「一堂课每页都换一个新鲜但没讲透的例子等于什么都没教。」(A lecture that cycles through a fresh unexplained example every page teaches nothing about any of them.)在generate_scene的参数层keyPoints由工具参数驱动。看 lib/server/agent-runtime/generation-tools.ts 中generate_scene的参数定义与SceneOutline的组装逻辑title、type、brief三个字段为必填brief承载这一页的教学意图与内容纲要。materialFacts是可选字符串数组直接落入SceneOutline.keyPoints。instruction可选仅对已有slide页生效作为editDirective传入并把现有元素/背景作为baselineContent。media可选但上限 8 项每项必须是具体的 HTTP(S) URL 或同源路径占位符与 data URL 会被拒绝。也就是说讲座页的命题式要点、旁白里的真实案例最终都通过brief与materialFacts被写进每页的生成调用。一次generate_scene调用是这一页的持久化检查点durable checkpoint——页面只在调用返回后才会在中断中存活这与stage-design中「页面落盘才算数」的纪律一致。五、旁白即讲座连续、推进、权威的口吻这是风格「被听到」的地方也是 SKILL.md 花最多篇幅的地方每个主体页都有一段连续而绵长的教师独白——一行四到六句话而不是一行caption一页有好几行。学习者应当能闭着眼睛也能跟得上。旁白必须向前推进。每一行接住上一行结尾的想法陈述它、解释机制、再带一个具体案例走完整条机制直到结论不可避免。语域是「一个权威在一屋子人面前出声思考」——完整句子、笃定、不慌不忙偶尔在解决难点前先把「难在哪」点出来。助教极少开口且只在「全场已经在想同一个问题」时替大家问出来然后由讲师长篇作答。每条弧至多一次这样的问答。本风格明令禁止没有实质内容的「大家想一想」式提问、复述幻灯片标题的单行caption、以及打气式表达「太棒了」「让我们开始吧」。SKILL.md 给出的正反例非常直观好「我们先把定义钉住——所谓久期不是债券还剩多少年而是价格对利率的敏感度……接下来看 2022 年的例子同样的加息幅度为什么二十年期的跌幅是五年期的四倍多。」坏「这一页讲久期。久期很重要。下面我们来看例子。」从实现侧看旁白最终以speechaction 落到页面 action 序列里。generate_scene在内容生成后调用generateSceneActionsactionGenerator产出经过filterKnownActions过滤掉 DSL 未知的 action 类型再通过buildCompleteScene组装成完整场景持久化。stage-design还专门提示若旁白文本被patch_stage改写必须对该页调用generate_tts重新合成否则「改过但没重新合成的旁白会作为无声页发货」。六、阵容The roster一位讲师加一位提问助教lecture-style 的阵容哲学是「越少越好」「runtime 只允许恰好一位老师而在本风格里这位老师就是讲师——整门课都是他的声音。拥挤的教室会拆散一场讲座。」用set_roster写阵容一位资深领域权威语气沉稳克制calm, measured delivery外加一位职责单一的助教——在弧的边界处提出那个尖锐的问题。把讲授方式写进 persona 文本把节奏写进voiceDesign.delivery——「calm measured authoritative, unhurried」而非「lively energetic」。对照 lib/server/agent-runtime/roster-tools.ts 的参数定义set_roster的每个 agent 可携带字段说明name展示名使用课堂语言role必须恰好 1 个teacher其余为assistant/studentagent 总数至少 2persona2 到 3 句具体描述用课堂语言写明个性与教学/学习风格不能是角色标签voiceDesignidentity性别年龄角色、texture音高音质、delivery情绪语速三个子字段voiceTTS 绑定格式为providerId::voiceId必须来自list_voices的返回或register_voice的返回禁止自造 idavatar/color/priority可省略自动从默认池与调色板轮转priority 按角色推导teacher10assistant7student 4-6值得注意的实现约束set_roster会对voice绑定做目录校验——绑定必须存在于list_voices报告的声库中排除未服务 provider、无 key provider 与付费展示音色这些不可能真正合成否则直接报错voice-not-in-catalog并列出可用绑定。这是「只绑定模型被展示过的声音」的 fail-closed 纪律。阵容落盘到stage.generatedAgentConfigs并同时写入stage.agentIds之后的页面内容与旁白都按这套阵容生成——所以stage-design强调 roster 必须在生成任何页面前定稿晚了就有一半课程「从没见过自己的阵容」。七、把风格传进生成器只有写进字段的文本才会被看到lecture-style以及所有主题技能面对一个关键的结构性约束没有大纲生成器。课程在对话里规划好之后直接调用create_stage然后逐页调用generate_scene每页带一个显式 brief而页面内容与旁白由互不相见的独立调用生成——各自只能看到「本页的 brief、页面内容与阵容」。因此 SKILL.md 给出了三条必须遵守的传递纪律把弧结构和密度期望写进每页generate_scene的brief把讲授方式写进set_roster的每个 persona把旁白指令放进每页generate_scene.materialFacts——例如「旁白为连续讲述四到六句一段先定义再机制再案例」「本页复用前一页的同一家公司作为案例」。SKILL.md 对此有一句锋利的结论「在提示词里点名这个技能什么用都没有只有你放进那些字段的文本才会被看见。」(Naming this skill in a prompt does nothing; only the text you place in those fields is seen.) 这一点在测试中也有印证skills.test.ts专门断言两个风格技能的内容都包含materialFacts、brief、set_roster、voiceDesign这些「生成器实际读取的字段」。create_stage/generate_scene/list_scenes等工具的实际行为可以在 lib/server/agent-runtime/generation-tools.ts 中核对generate_scene要求 1-based 的整数order、非空title与brief复用 order 会替换该页对pbl类型有专门的类型变更保护改类型会销毁项目因此被阻止interactive 之外的类型传入widgetType/widgetOutline会被拒绝。八、场景命名用学科自己的语言命名步骤lecture-style 的场景标题应当是「讲座自己的步骤」使用学科语言好「久期到底在度量什么」「同样加息为什么长债跌得更狠」「三个反例和它们的共同点」坏「概念介绍」「案例分析」「本课总结」这与workshop-style命令式命名如「把这段循环改成能跑的」和deep-interactive命名学习者做什么或发现什么如「拖动倾角看射程怎么变」形成三种可辨识的命名风格。九、风格边界什么时候它不是讲座lecture-style 明确规定了「拒绝转向」的情形如果用户想要的是练习一项技能、产出自己的东西、或完成一组习题应当用一句话说明并改用workshop-style——「把练习请求包进一场讲座产出的是一门学习者只能观看、无法使用的课。」(Wrapping a practice request in a lecture produces a course the learner watches and cannot use.)更完整的风格光谱均位于 skills/agent-runtime 目录风格核心判据lecture-style收获在于理解一页一节连续论证旁白是完整讲述workshop-style收获在于带走一项技能概念后紧跟动手页旁白是引导性短句、提问多于陈述deep-interactive主题内含机制/变量/过程/结构绝大多数页面是可操纵的 interactive 页slide 只留给开场与收束三种风格共享同一个stage-design构建序列对话中定计划 →create_stage→set_roster→ 逐页generate_scene→list_scenes核对 → 检查每页旁白有音频但在「stage 里装什么、怎么发声」上各自为政。判别一款请求该用哪种风格看的是学习者的预期收获而非主题本身。十、从请求到成品一次 lecture-style 课堂的完整路径综合以上全部内容一个「大师课」请求在 OpenMAIC 中的落地路径可以总结为触发请求匹配 lecture-style 的 description「系统讲解」「大师课」「讲透」等pi 原生read载入 SKILL.mdskills.ts中的skillReadFromTranscript让激活状态成为可恢复的持久记录。规划对话中与用户敲定页面计划每页的 title、type、brief用ask_user确认——没有大纲工具计划就是你的话加用户的签字。创建create_stage建 stage系列课程可同时传folderId拿到stageId。阵容list_voices查询可绑定声库 →set_roster写入「1 位沉稳权威讲师 1 位提问助教」讲授方式在 persona、节奏在voiceDesign.delivery。逐页生成每页一次generate_sceneorder递增brief 携带弧结构与密度期望materialFacts携带旁白指令与复用案例interactive 页最多一个、quiz 每 4-5 页一个。校验每页落盘后checkScenesAgainstSkill对实际页面做约束检查违规以诊断形式回传最后用list_scenes核对全部页面已持久化、按stage-design的要求确认每页旁白 action 都有audioId音频。这条路径的每一步都能在 lib/server/agent-runtime 的skills.ts、generation-tools.ts、roster-tools.ts与 skills/agent-runtime/stage-design/SKILL.md 中找到对应实现与纪律——风格不是提示词里的形容词而是贯穿「规划 → 生成 → 机器校验 → 测试锚定」全链路的可执行约束。【免费下载链接】OpenMAICOpen Multi-Agent Interactive Classroom — Get an immersive, multi-agent learning experience in just one click项目地址: https://gitcode.com/GitHub_Trending/op/OpenMAIC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
OpenMAIC「大师讲授」模式深度解析：用 lecture-style 技能设计连续讲授型多智能体课堂
OpenMAIC「大师讲授」模式深度解析用 lecture-style 技能设计连续讲授型多智能体课堂【免费下载链接】OpenMAICOpen Multi-Agent Interactive Classroom — Get an immersive, multi-agent learning experience in just one click项目地址: https://gitcode.com/GitHub_Trending/op/OpenMAICOpenMAICOpen Multi-Agent Interactive Classroom是一键构建沉浸式多智能体学习体验的开源项目。在其 agent-runtime 技能体系中lecture-style大师讲授是一套面向「系统讲解型课程」的课堂设计技能一门课由一位讲师的声音从头讲到尾页面服务于论证而非打断论证。本文以 skills/agent-runtime/lecture-style/SKILL.md 为主体结合同目录的结构化约束文件、stage-design基础构建流程、generate_scene/set_roster等运行时工具的源码实现完整拆解该技能的设计形态、页面密度规则、旁白撰写规范、阵容写法、约束检查机制及其与workshop-style/deep-interactive的分工。读完本文你将掌握如何识别一个「大师课」请求、如何规划并逐页生成一场 slide 载体的连续讲授课堂以及风格如何通过brief、persona、materialFacts三个字段真实传入生成器。一、技能定位什么是 lecture-stylelecture-style的中文标题是「大师讲授」其 frontmatter 描述给出了明确的触发条件与边界适用场景lecture、masterclass、对一个学科的系统讲解「大师课」「系统讲解」「讲透」或任何「收获在于理解而非动手」的主题用户直接点名该风格时同样启用。不适用场景动手实操型课程应使用workshop-style以操纵某种机制为核心目标的课程应使用deep-interactive。从源码看技能的可发现性由 lib/server/agent-runtime/skills.ts 承载loadSkills()解析每个技能目录下的SKILL.mdfrontmatteravailableSkillsPromptBlock()把 name/description/location 渲染进系统提示模型在请求匹配时通过 pi 的原生read工具读取 SKILL.md 全文。每个技能目录允许携带一个可选的outline-constraints.json结构化约束文件——它与 frontmatter 刻意分离frontmatter 是「模型可见的契约」约束文件是「检查器的契约」避免每次 schema 调整都改动模型实际读到的正文见skills.ts中listBuiltinSkills的实现注释。lecture-style 不是孤立存在的。stage-design是构建任何 stage 的地基——规划方式、工具调用顺序、阵容书写、旁白再合成时机、收尾条件——它在所有主题技能之下生效主题技能lecture-style、deep-interactive、vocational 等决定 stage 里装什么。SKILL.md 开头也明确强调「stage-designstill governs how the stage is built — outline, roster, one page pergenerate_scene, audio before done. This skill governs what the stage contains and how it sounds.」因此使用 lecture-style 时应先阅读 skills/agent-runtime/stage-design/SKILL.md。二、课堂形态The shapeslide 载体的连续论证lecture-style 对整门课的页面结构有明确的形态约束这是与其它风格最显著的分野第 1 幕必须是slide且要「真正地开场」提出这个主题要回答的问题、为什么它值得花一小时、这堂课将如何展开。它既不是定义页也不是目录页。主体是slide页面以「弧」arc组织。一条弧由 3 到 5 页构成把同一个想法从「断言」推到「后果」先给出主张claim再讲底下的机制mechanism然后用真实案例检验它。弧与弧首尾相接整堂课从不重新开始。检查点checkpoint必须稀少大约每 4 到 5 页一个quiz位置在一条弧收束、下一条弧开启的接缝处测试的是学习者能否应用弧里的思想而不是复述字句。SKILL.md 用一句犀利的判据划清边界「两页里放两个 quiz那不是讲座那是中间夹着幻灯片的测验。」至多一个interactive页面放在全课机制感最强的那一个概念上——那个「光靠讲真的传不过去、学习者必须亲眼看它动起来」的地方。如果一个主题有两个这样的概念放第二个尚可辩护出现第三个说明这个请求根本不是讲座deep-interactive更合适。收尾收在论证上而不是要点罗列这堂课确立了什么、刻意留下了什么没讲、好奇的学习者下一步该往哪走。这一形态不是纯文字约定它被机器可检查地固化在同目录的 skills/agent-runtime/lecture-style/outline-constraints.json 中{ allowedTypes: [slide, quiz, interactive], firstSceneType: slide, typeMix: [ { type: slide, minRatio: 0.65 }, { type: quiz, min: 1, max: 3 }, { type: interactive, max: 2 } ] }即本课只允许slide/quiz/interactive三种页面类型第 1 幕必须是slideslide至少占 65%quiz至少 1 个、至多 3 个interactive至多 2 个。约束文件注释还专门说明旁白长度与口吻——本风格最响的部分——不是结构性内容无法在此检查它们经由keyPoints、阵容 persona 与逐页materialFacts传入。三、约束检查机制从大纲到持久化页面的机器校验约束文件的价值在于它被真实执行。skills.ts提供了两条检查路径checkOutlineAgainstSkill(outlines, constraints)对模型产出的课程大纲做机器检查返回人类可读的违规清单。检查项覆盖场景总数上下限、非法类型、第 1 幕类型、typeMix 的 min/max/minRatio、interactive 页的 widgetType 与 widgetOutline 必填字段、连续两页同 widgetType 等。checkScenesAgainstSkill(scenes, constraints)对实际持久化的页面做同样的检查。generate_scene每次落盘一页后都会调用它违规以 tool-result diagnostic 的形式回传给 agent由 agent 决定是否重新规划。skills.ts中一个值得注意的设计决策检查只返回诊断、不做自动重写。注释写道——「一个计划是一个连贯的整体机械地把某页类型翻来翻去满足比例产出的课程读起来像被 linter 拼出来的」。违规信息回到 agent 手里由它判断如何修复持久化也永远不会被该检查回滚。在 tests/agent-runtime/skills.test.ts 中有一个专门测试组pedagogy style skills用「对比法」验证两个风格约束的互斥性一个 masterclass 形态的页面组合slide为主体、第 5 页一个quiz、第 8 页一个simulationinteractive通过checkOutlineAgainstSkill检查时对 lecture-style 返回[]零违规。同一个 masterclass 组合拿去喂 workshop-style 的约束会被判定违规interactive 至少 3、quiz 至少 2。反之workshop 形态的页面组合slide/interactive 交错喂给 lecture-style会产生「slide 不足 65%」「interactive 超过上限」两类违规。这意味着一个请求若在两种风格下反复重生成产出的课程必须肉眼可辨地不同——这正是「风格是有实质约束、而非口头承诺」的测试锚点。测试还断言两种风格的 SKILL.md 内容都包含materialFacts、brief、set_roster、voiceDesign这些字段名以及「exactly one teacher」确保风格能被正确地传入生成器实际读取的字段。四、页面密度命题式的 keyPoints 与贯穿全课的案例lecture-style 明确声明「密度是特性」一页只说一件事的讲座页是浪费的一页。具体规则每个主体页携带4 到 6 条keyPoints而且它们是命题不是标签——「利率上升先压估值再压盈利」而不是「利率影响」。一页装载「一个主张加让它站住的证据」定义及其边界、机制加一个走通的案例、对比加一条区分两边的判据。每条弧必须命名一个真实案例——一家公司、一项研究、一段历史、一段代码——并让它反复出现。SKILL.md 的批评非常具体「一堂课每页都换一个新鲜但没讲透的例子等于什么都没教。」(A lecture that cycles through a fresh unexplained example every page teaches nothing about any of them.)在generate_scene的参数层keyPoints由工具参数驱动。看 lib/server/agent-runtime/generation-tools.ts 中generate_scene的参数定义与SceneOutline的组装逻辑title、type、brief三个字段为必填brief承载这一页的教学意图与内容纲要。materialFacts是可选字符串数组直接落入SceneOutline.keyPoints。instruction可选仅对已有slide页生效作为editDirective传入并把现有元素/背景作为baselineContent。media可选但上限 8 项每项必须是具体的 HTTP(S) URL 或同源路径占位符与 data URL 会被拒绝。也就是说讲座页的命题式要点、旁白里的真实案例最终都通过brief与materialFacts被写进每页的生成调用。一次generate_scene调用是这一页的持久化检查点durable checkpoint——页面只在调用返回后才会在中断中存活这与stage-design中「页面落盘才算数」的纪律一致。五、旁白即讲座连续、推进、权威的口吻这是风格「被听到」的地方也是 SKILL.md 花最多篇幅的地方每个主体页都有一段连续而绵长的教师独白——一行四到六句话而不是一行caption一页有好几行。学习者应当能闭着眼睛也能跟得上。旁白必须向前推进。每一行接住上一行结尾的想法陈述它、解释机制、再带一个具体案例走完整条机制直到结论不可避免。语域是「一个权威在一屋子人面前出声思考」——完整句子、笃定、不慌不忙偶尔在解决难点前先把「难在哪」点出来。助教极少开口且只在「全场已经在想同一个问题」时替大家问出来然后由讲师长篇作答。每条弧至多一次这样的问答。本风格明令禁止没有实质内容的「大家想一想」式提问、复述幻灯片标题的单行caption、以及打气式表达「太棒了」「让我们开始吧」。SKILL.md 给出的正反例非常直观好「我们先把定义钉住——所谓久期不是债券还剩多少年而是价格对利率的敏感度……接下来看 2022 年的例子同样的加息幅度为什么二十年期的跌幅是五年期的四倍多。」坏「这一页讲久期。久期很重要。下面我们来看例子。」从实现侧看旁白最终以speechaction 落到页面 action 序列里。generate_scene在内容生成后调用generateSceneActionsactionGenerator产出经过filterKnownActions过滤掉 DSL 未知的 action 类型再通过buildCompleteScene组装成完整场景持久化。stage-design还专门提示若旁白文本被patch_stage改写必须对该页调用generate_tts重新合成否则「改过但没重新合成的旁白会作为无声页发货」。六、阵容The roster一位讲师加一位提问助教lecture-style 的阵容哲学是「越少越好」「runtime 只允许恰好一位老师而在本风格里这位老师就是讲师——整门课都是他的声音。拥挤的教室会拆散一场讲座。」用set_roster写阵容一位资深领域权威语气沉稳克制calm, measured delivery外加一位职责单一的助教——在弧的边界处提出那个尖锐的问题。把讲授方式写进 persona 文本把节奏写进voiceDesign.delivery——「calm measured authoritative, unhurried」而非「lively energetic」。对照 lib/server/agent-runtime/roster-tools.ts 的参数定义set_roster的每个 agent 可携带字段说明name展示名使用课堂语言role必须恰好 1 个teacher其余为assistant/studentagent 总数至少 2persona2 到 3 句具体描述用课堂语言写明个性与教学/学习风格不能是角色标签voiceDesignidentity性别年龄角色、texture音高音质、delivery情绪语速三个子字段voiceTTS 绑定格式为providerId::voiceId必须来自list_voices的返回或register_voice的返回禁止自造 idavatar/color/priority可省略自动从默认池与调色板轮转priority 按角色推导teacher10assistant7student 4-6值得注意的实现约束set_roster会对voice绑定做目录校验——绑定必须存在于list_voices报告的声库中排除未服务 provider、无 key provider 与付费展示音色这些不可能真正合成否则直接报错voice-not-in-catalog并列出可用绑定。这是「只绑定模型被展示过的声音」的 fail-closed 纪律。阵容落盘到stage.generatedAgentConfigs并同时写入stage.agentIds之后的页面内容与旁白都按这套阵容生成——所以stage-design强调 roster 必须在生成任何页面前定稿晚了就有一半课程「从没见过自己的阵容」。七、把风格传进生成器只有写进字段的文本才会被看到lecture-style以及所有主题技能面对一个关键的结构性约束没有大纲生成器。课程在对话里规划好之后直接调用create_stage然后逐页调用generate_scene每页带一个显式 brief而页面内容与旁白由互不相见的独立调用生成——各自只能看到「本页的 brief、页面内容与阵容」。因此 SKILL.md 给出了三条必须遵守的传递纪律把弧结构和密度期望写进每页generate_scene的brief把讲授方式写进set_roster的每个 persona把旁白指令放进每页generate_scene.materialFacts——例如「旁白为连续讲述四到六句一段先定义再机制再案例」「本页复用前一页的同一家公司作为案例」。SKILL.md 对此有一句锋利的结论「在提示词里点名这个技能什么用都没有只有你放进那些字段的文本才会被看见。」(Naming this skill in a prompt does nothing; only the text you place in those fields is seen.) 这一点在测试中也有印证skills.test.ts专门断言两个风格技能的内容都包含materialFacts、brief、set_roster、voiceDesign这些「生成器实际读取的字段」。create_stage/generate_scene/list_scenes等工具的实际行为可以在 lib/server/agent-runtime/generation-tools.ts 中核对generate_scene要求 1-based 的整数order、非空title与brief复用 order 会替换该页对pbl类型有专门的类型变更保护改类型会销毁项目因此被阻止interactive 之外的类型传入widgetType/widgetOutline会被拒绝。八、场景命名用学科自己的语言命名步骤lecture-style 的场景标题应当是「讲座自己的步骤」使用学科语言好「久期到底在度量什么」「同样加息为什么长债跌得更狠」「三个反例和它们的共同点」坏「概念介绍」「案例分析」「本课总结」这与workshop-style命令式命名如「把这段循环改成能跑的」和deep-interactive命名学习者做什么或发现什么如「拖动倾角看射程怎么变」形成三种可辨识的命名风格。九、风格边界什么时候它不是讲座lecture-style 明确规定了「拒绝转向」的情形如果用户想要的是练习一项技能、产出自己的东西、或完成一组习题应当用一句话说明并改用workshop-style——「把练习请求包进一场讲座产出的是一门学习者只能观看、无法使用的课。」(Wrapping a practice request in a lecture produces a course the learner watches and cannot use.)更完整的风格光谱均位于 skills/agent-runtime 目录风格核心判据lecture-style收获在于理解一页一节连续论证旁白是完整讲述workshop-style收获在于带走一项技能概念后紧跟动手页旁白是引导性短句、提问多于陈述deep-interactive主题内含机制/变量/过程/结构绝大多数页面是可操纵的 interactive 页slide 只留给开场与收束三种风格共享同一个stage-design构建序列对话中定计划 →create_stage→set_roster→ 逐页generate_scene→list_scenes核对 → 检查每页旁白有音频但在「stage 里装什么、怎么发声」上各自为政。判别一款请求该用哪种风格看的是学习者的预期收获而非主题本身。十、从请求到成品一次 lecture-style 课堂的完整路径综合以上全部内容一个「大师课」请求在 OpenMAIC 中的落地路径可以总结为触发请求匹配 lecture-style 的 description「系统讲解」「大师课」「讲透」等pi 原生read载入 SKILL.mdskills.ts中的skillReadFromTranscript让激活状态成为可恢复的持久记录。规划对话中与用户敲定页面计划每页的 title、type、brief用ask_user确认——没有大纲工具计划就是你的话加用户的签字。创建create_stage建 stage系列课程可同时传folderId拿到stageId。阵容list_voices查询可绑定声库 →set_roster写入「1 位沉稳权威讲师 1 位提问助教」讲授方式在 persona、节奏在voiceDesign.delivery。逐页生成每页一次generate_sceneorder递增brief 携带弧结构与密度期望materialFacts携带旁白指令与复用案例interactive 页最多一个、quiz 每 4-5 页一个。校验每页落盘后checkScenesAgainstSkill对实际页面做约束检查违规以诊断形式回传最后用list_scenes核对全部页面已持久化、按stage-design的要求确认每页旁白 action 都有audioId音频。这条路径的每一步都能在 lib/server/agent-runtime 的skills.ts、generation-tools.ts、roster-tools.ts与 skills/agent-runtime/stage-design/SKILL.md 中找到对应实现与纪律——风格不是提示词里的形容词而是贯穿「规划 → 生成 → 机器校验 → 测试锚定」全链路的可执行约束。【免费下载链接】OpenMAICOpen Multi-Agent Interactive Classroom — Get an immersive, multi-agent learning experience in just one click项目地址: https://gitcode.com/GitHub_Trending/op/OpenMAIC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考