Playground Builder 是一个面向交互式 HTML 探索页面的构建技能。它产出的成果是一个自包含的 HTML 文件:一侧是交互控件,另一侧是实时预览,底部是基于当前选择生成的自然语言提示词,并附复制按钮。用户调节控件、进行可视化探索,然后复制生成的提示词回到 Antigravity 中继续使用。
用途 当用户希望针对某个主题获得交互式 playground、探索器或可视化工具时使用,尤其适合输入空间较大、偏视觉或结构化的内容,这类内容难以用纯文本表达。
主要能力与模板 该技能会先根据用户请求判断 playground 类型,再从 templates/ 加载匹配模板:
- templates/design-playground.md:视觉设计决策,包括组件、布局、间距、颜色、字体排版。
- templates/data-explorer.md:数据与查询构建,包括 SQL、API、管道、正则表达式。
- templates/concept-map.md:学习与探索,包括概念图、知识缺口、范围映射。
- templates/document-critique.md:文档评审,提供通过、拒绝、评论的工作流建议。
- templates/diff-review.md:代码审阅,针对 git diff、提交、PR 提供逐行评论。
- templates/code-map.md:代码库架构,包括组件关系、数据流、分层图。 若主题不完全匹配任一模板,可选择最接近的模板并做调整。
使用方式 根据用户请求确定 playground 类型,加载对应模板,并按照模板构建页面。写好 HTML 文件后,运行 open <filename>.html,在用户默认浏览器中打开。
核心要求 每个 playground 都必须是单个 HTML 文件,CSS 和 JS 全部内联,无外部依赖。预览需在每次控件变化时即时更新,不设“应用”按钮。提示词输出应使用自然语言而非数值堆砌,只提及非默认选择,并包含足够上下文,使脱离 playground 也能执行;提示词同样实时更新。需提供复制按钮,复制到剪贴板后短暂显示“Copied!”反馈。应具备合理默认值和 3 至 5 个命名预设,首次加载即显示良好效果,预设可将全部控件快速切换到协调的组合。界面采用深色主题,UI 使用系统字体,代码和值使用等宽字体,界面装饰保持精简。
状态管理方式 维护单一状态对象,所有控件写入该对象,所有渲染从该对象读取。示例: const state = { /* all configurable values */ };
function updateAll() { renderPreview(); // update the visual updatePrompt(); // rebuild the prompt text } // Every control calls updateAll() on change
提示词输出方式 提示词只提及非默认值,并在数值之外使用定性语言。示例: function updatePrompt() { const parts = [];
// Only mention non-default values
if (state.borderRadius !== DEFAULTS.borderRadius) {
parts.push(border-radius of ${state.borderRadius}px);
}
// Use qualitative language alongside numbers if (state.shadowBlur > 16) parts.push('a pronounced shadow'); else if (state.shadowBlur > 0) parts.push('a subtle shadow');
prompt.textContent = Update the card to use ${parts.join(', ')}.;
}
适用场景 适合需要用户通过控件进行可视化配置、并即时看到结果的探索任务,例如设计风格选择、查询条件构建、概念范围梳理、文档逐条评审、代码差异逐行评论、代码库结构查看等。
限制与常见错误 应避免:提示词输出只是数值堆砌,而应写成自然指令;一次放置过多控件,应按关注点分组,并将高级项折叠隐藏;预览未即时更新,任何控件变化都必须立即触发重新渲染;缺少默认值或预设,导致初始状态为空或异常;引入外部依赖,CDN 不可用时 playground 将无法使用;提示词缺少上下文,应包含足够信息,使其脱离 playground 仍可执行。