SuperAPI AI 工具集

stage-design

设计与创作

查看项目

更新于 10-16 04:33

技能介绍

用途:定义构建单个 stage(一间教室:一份确定的计划、一份名单、一套页面)的基线方法,适用于任何学科,且在所有主题技能(deep-interactive、vocational、deep-research、teacher-style-clone 等)下流程一致。主题技能只能影响页面结构、页面类型与场景命名,不改变本流程;应先读本技能,再读主题技能。已存在持久化页面的 stage 属于编辑(见 pro-editing),不适用本流程。

构建顺序:只在尚无持久化页面时构建新 stage。一、在对话中规划:由你按页面顺序提出页面计划(每页的标题、类型 slide/quiz/interactive/pbl,以及含教学意图与内容大纲的 brief),并在创建任何内容前通过 ask_user 与用户确认;没有用于规划的 outline 工具,计划即你的文字加用户认可。主题技能的结构约束是运行时在每页之后对真实 stage 的检查项,由你决定如何响应。二、用确定的课程标题调用 create_stage;若属于系列,传入系列文件夹的 folderId,之后所有 stage 工具都传入返回的 stageId。三、在生成任何页面之前调用 set_roster:恰一位教师、至少两位 agent,每人均需具体人设(2-3 句性格与教学/学习风格,用 stage 语言)和声音——先调用 list_voices,绑定返回的 providerId::voiceId 对,或 register_voice 为克隆声音返回的确切配对;无可用声音时省略绑定。页面内容与旁白按生成时已有名单撰写。四、按确定顺序对每一页调用 generate_scene,一次一页,传入已确定的标题、类型与 brief(内容来自附件材料时加 materialFacts);pbl 页同样从 brief 生成完整 PBL 项目(projectV2),生成失败会报错且不写入;该调用是页面的持久化检查点。五、调用 list_scenes 核实每页都已持久化。规划步骤不是停止点:轮次在页面真正落地、ask_user 等待用户或按完成检查判定 stage 完成时结束。

generate_scene 失败时:按 stageId + order 记录尝试次数;标题/brief 变更或中间生成其他页面都不重置尝试。prompt-unavailable 或其他确定性失败不要重复同一调用;invalid-model-output 时在不改变既定教学意图的前提下改写 brief 后重试一次;明显的瞬态提供方失败也可重试一次;重试仍失败则本次运行不再对该目标调用 generate_scene,留空该页继续后续页面,并在收尾时指出缺口,不要每失败一页就调用 ask_user,也不要静默从计划中删除该页。用 list_scenes 核对已持久化页面与确定计划;缺页的 stage 可在后续页面建完后收尾,但不算完成,应指出每个缺口及最近一次失败,不得声称完成。

旁白音频跟随文本:用 patch_stage 在 /actions/... JSON Pointer 上写入或改写旁白后,应对该页调用 generate_tts,否则改写而未重新合成的旁白会变成无声页面。

完成前:每个确定页面都必须持久化。每页用 read_stage 在 path:/scenes/<order|id>、detail:"source" 读取,检查 speech 动作的 audioId 字段,缺失则调用 generate_tts;同时检查旁白是否讲述了本 stage 未教授的材料,这属于缺陷。全部页面持久化后,用一两句告知用户。

限制:仅适用于尚无持久化页面的新 stage;不适用于已有页面者(改走 pro-editing)。资料未提供具体定价、可用平台或性能数据。