mcpField
I
interactive-component-creator

interactive-component-creator

github.com/qodex-ai设计与 UI47131 次安装42 周前更新
代码仓库

关于 interactive-component-creator

interactive-component-creator 是用于制作 Claude 对话前端 artifact 的 Skill。它可初始化 React 和 TypeScript 项目，并将成品打包为单个 HTML 文件。

主要功能

  1. 01初始化 React 和 TypeScript 项目
  2. 02使用预装的 shadcn/ui 组件
  3. 03将资源打包到单个 HTML 文件
  4. 04在对话中展示 artifact
  5. 05可选测试 artifact

适用场景

  1. 01为 Claude 对话制作前端 artifact
  2. 02使用 React 构建交互界面
  3. 03将项目成果打包为可分享的 HTML

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/qodex-ai/ai-agent-skills --skill interactive-component-creator

安装后在 Claude Code 中输入/interactive-component-creator确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

LICENSE.txt
scripts/
bundle-artifact.sh
init-artifact.sh

详细介绍

Web Artifacts Builder

要构建功能强大的前端 claude.ai artifact，请按以下步骤操作：

  1. 使用 scripts/init-artifact.sh 初始化前端仓库
  2. 通过编辑生成的代码开发你的 artifact
  3. 使用 scripts/bundle-artifact.sh 将所有代码打包为单个 HTML 文件
  4. 向用户展示 artifact
  5. （可选）测试 artifact

技术栈：React 18 + TypeScript + Vite + Parcel（打包） + Tailwind CSS + shadcn/ui

设计与风格指南

非常重要：为避免所谓的“AI slop”（AI 粗制滥造的风格），请避免过度使用居中布局、紫色渐变、统一的圆角以及 Inter 字体。

快速开始

第 1 步：初始化项目

运行初始化脚本以创建新的 React 项目：

bash scripts/init-artifact.sh <project-name>
cd <project-name>

这将创建一个配置完整的项目，包含：

  • ✅ React + TypeScript（通过 Vite）
  • ✅ Tailwind CSS 3.4.1，并配有 shadcn/ui 主题系统
  • ✅ 已配置路径别名（@/）
  • ✅ 预装 40 多个 shadcn/ui 组件
  • ✅ 包含所有 Radix UI 依赖
  • ✅ 已通过 .parcelrc 配置 Parcel 打包
  • ✅ 兼容 Node 18+（自动检测并锁定 Vite 版本）
第 2 步：开发你的 Artifact

如需构建 artifact，请编辑生成的文件。具体指导请参阅下方的常见开发任务。

第 3 步：打包为单个 HTML 文件

要将 React 应用打包为单个 HTML artifact：

bash scripts/bundle-artifact.sh

这将生成 bundle.html，这是一个自包含的 artifact，所有 JavaScript、CSS 和依赖均已内联。该文件可直接在 Claude 对话中作为 artifact 分享。

要求：项目根目录下必须有 index.html。

脚本执行的操作：

  • 安装打包依赖（parcel、@parcel/config-default、parcel-resolver-tspaths、html-inline）
  • 创建带路径别名支持的 .parcelrc 配置
  • 使用 Parcel 构建（不生成 source map）
  • 使用 html-inline 将所有资源内联到单个 HTML 中
第 4 步：向用户分享 Artifact

最后，在对话中将打包好的 HTML 文件分享给用户，以便其以 artifact 形式查看。

第 5 步：测试/可视化 Artifact（可选）

注意：这是完全可选的步骤。仅在必要或用户要求时执行。

如需测试或可视化 artifact，可使用可用工具（包括其他 Skills 或 Playwright、Puppeteer 等内置工具）。一般而言，应避免预先测试 artifact，因为这会增加请求与成品呈现之间的延迟。如有需要或出现问题，可在展示 artifact 之后再进行测试。

参考资料

评论

支持 Markdown