SuperAPI AI 工具集

playground

编程与开发

查看项目

更新于 11-12 07:46

技能介绍

用途

Playground 技能用于为某个主题创建交互式 HTML 实验台(playground/explorer)。它适合输入空间较大、偏视觉或结构化的场景,这类内容难以用纯文本表达。

主要能力

一个 playground 是一个自包含的 HTML 文件:一侧是交互控件,另一侧是实时预览,底部是带复制按钮的提示词输出。用户调整控件、可视化探索,然后把生成的提示词复制回 Claude。

内置模板位于 templates/ 目录,按需求选择最接近的一个构建,必要时做适配:

  • design-playground.md:视觉设计决策(组件、布局、间距、颜色、字体)
  • data-explorer.md:数据与查询构建(SQL、API、流水线、正则)
  • concept-map.md:学习与探索(概念图、知识缺口、范围映射)
  • document-critique.md:文档评审(带通过/驳回/评论工作流的建议)
  • diff-review.md:代码评审(git diff、提交、PR,逐行评论)
  • code-map.md:代码库架构(组件关系、数据流、分层图)

使用方式

  1. 根据用户请求识别 playground 类型。
  2. 从 templates/ 加载匹配模板;若主题不完全匹配,取最接近的一个并调整。
  3. 按模板构建 playground。
  4. 写完后运行 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(', ')}.`;
}

适用场景

当用户需要某个主题的交互式 playground、探索器或可视化工具时使用,尤其是输入空间较大、偏视觉或结构化的场合。也可用于设计选型、查询构建、概念梳理、文档评审、代码 diff 评审与代码架构查看等模板对应场景。

限制与注意事项

需避免的常见错误:

  • 提示词输出只是值转储——应写成自然语言指令。
  • 一次控件过多——按关注点分组,把高级项收进可折叠区域。
  • 预览不能即时更新——每次控件变化都必须触发立即重渲染。
  • 没有默认值或预设——加载时空白或不可用。
  • 使用外部依赖——CDN 不可用则 playground 失效。
  • 提示词缺少上下文——必须包含足够信息,使其脱离 playground 也可执行。

关于该技能的收费、平台支持范围及模板之外的其他功能,资料未提供。