用途
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:代码库架构(组件关系、数据流、分层图)
使用方式
- 根据用户请求识别 playground 类型。
- 从 templates/ 加载匹配模板;若主题不完全匹配,取最接近的一个并调整。
- 按模板构建 playground。
- 写完后运行 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 也可执行。
关于该技能的收费、平台支持范围及模板之外的其他功能,资料未提供。