SuperAPI AI 工具集

marble-builder

办公与效率

查看项目

更新于 11-03 16:45

技能介绍

用途

Marble Builder 面向为儿童设计学习体验的场景。它要求与用户一起把宽泛请求(如“分数”)确认成可观察的学习目标,再依据本仓库的主题、先修关系和教学研究进行教学设计,最终产出并验证一个可独立运行的 HTML 体验。该技能强调:可用的 HTML 文件只是初始原型,不能作为学习体验良好的充分证据。

主要能力

  • 目标确认:在设计中先取得儿童年龄(若未知)、用户提供或确认的清晰学习目标,并只补充会实质性改变设计的问题;不要求姓名、生日等身份信息,不从年龄推断掌握程度或阅读能力。
  • 教学依据:按 data-and-research.md 定位数据、关联主题研究并理解其局限;选择与目标匹配的小范围内容,参考教学法、活动指引、常见误解、评估与来源;现有活动只作为可调整的提案,不作为有效性的证据。
  • 概念共创:提出包含可观察学习目标、核心问题与丰富插图的开场、中心视觉/互动活动、教学依据与不确定性、学习流程、支持引入与撤除、可独立评估的任务(动作、可观察反应、评分规则及可区分的误解)、预计时长与设备/成人支持假设、可选拓展的紧凑方案,等待用户确认后再完整实现。
  • 构建方式:默认交付一个内嵌 CSS、JavaScript 及所需素材的 HTML 文件,直接打开即可使用,无需账号、构建步骤、服务器或网络;研究与设计配套内容放在儿童界面之外。默认使用本地交互,不追踪、不传输儿童作答。
  • 视觉与交互规范:统一使用 Baloo 2 字体与 Marble 组件基线(小号句式大写标题、突出的说明文字、图标加文字的按钮);涉及视角、光照、深度、遮挡或运动物理的体验使用 Three.js 构建单一连贯的 3D 场景并支持直接操作,采用扁平色、阶梯状明暗与黑色描边的卡通渲染风格;真正属于二维推理的目标(如分数条、句子练习)使用 2D。
  • 开场与教学页:每个体验以富插图的标题页开始,用儿童友好语言把核心问题作为大号主标题,配一个清晰的图标加文字开始按钮,不设导语段落或目标列表;进入后切换为左上角小标题与单条显著指令,指令位置同时用于反馈替换而非追加说明。
  • 术语解释:所有面向儿童的技术术语带虚线下划线并按需显示简短解释(悬停或点击,键盘焦点/激活同样可用),一次只显示一个,可通过关闭、Escape 或点击别处收起;不在按钮或操作控件内添加释义触发器。
  • 反馈与评估:反馈以视觉为先,展示相关后果或关系并指向可能误解,提供有用的重试;把有支持的练习与独立掌握检查分开;证据不足时用“需要更多练习”或“尚未检查”替换当前指令,并说明结果只是本次会话的证据,而非长期诊断。
  • 可选连接 LLM:仅在达成学习目标确实需要开放式推理或文本生成、本地规则或预置内容无法充分提供时考虑运行时 LLM 调用;需说明其学习角色、连接方式、发送的数据、账号使用/成本及离线能力丧失,并获得体验作者的明确批准;不得仅用于对话装饰、通用提示、个性化或浏览器本可完成的判分。
  • 可访问性与交付:提供基本键盘操作、可读对比度、响应式布局与非仅靠颜色的反馈;对必须精确拖拽或依赖声音的交互提供实用替代方案;来源致谢与必要署名放入单独的成人配套材料,素材许可声明保留在 HTML 源码中。

使用方式

该技能以工作流形式推进:先用对话中已有信息建立最小必要背景 → 阅读 data-and-research.md 等资料为设计提供依据,研究记录缺失时准备聚焦的教学简报 → 阅读 interaction-design.md 与 visual-design.md 并从示例索引中选择相关示例检查后提出概念 → 用户确认方向后自主完成常规实现决策 → 按 validation.md 在浏览器中渲染、检查截图并测试交互,从中心交互开始验证再打磨其余部分。若用户已提供获批概念,则校验缺失要点而不重复审批。

适用场景

适合为儿童设计单个、目标明确、可在浏览器中独立运行的学习体验,尤其是需要空间/物理直觉的 3D 互动,或可用 2D 表现为核心的数学、语言类练习。也可在研究中发现可补充 os-taxonomy 主题时建议可选贡献。

限制

必须经历概念确认关卡,不能根据初始请求一次性产出完整体验;默认不引入运行时 LLM,连接模式需额外明确批准;若目标所需的证据浏览器确实无法评估,须提出替代方案或在概念设计阶段明确约定由成人评估,不得用更窄的代理指标声称评估了整个目标。该技能的来源仓库名称、具体实现文件其余内容及价格、平台等信息暂未提供。