Agent Skills
返回列表
💻

全家桶脚手架

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/vite-flare-starter。

技能介绍

直接克隆 Cloudflare 全栈模板时,很容易留下默认品牌标识、硬编码配置与命名冲突,最终产出的项目更像模板而非独立产品。鉴权密钥、环境变量、资源绑定等环节的配置同样繁琐,稍不注意就会踩坑。

核心能力与工作流程

该技能会将 vite-flare-starter 模板克隆到独立目录,完成从仓库初始化到生产部署的全部配置工作。核心步骤包括:

  • 克隆与清理:克隆模板后移除原 .git 目录并重新 git init,让项目拥有独立仓库。
  • 查找替换:将 vite-flare-starter 替换为项目名,涉及 worker 名、数据库名、R2 桶名、package.json 的 name 字段、HTML 标题等;移除硬编码的 account_id,将 database_id 置为占位符,package.json 版本重置为 0.1.0,所有替换均通过编辑工具逐处完成以避免平台差异。
  • 生成鉴权密钥:使用 openssl rand -hex 32 或 Python secrets.token_hex(32) 生成 BETTER_AUTH_SECRET。
  • 创建环境变量文件:依据项目名推导展示名(如 my-cool-app → My Cool App、ID my_cool_app),写入鉴权与品牌变量到 .dev.vars。
  • 创建 Cloudflare 资源(可选):用 wrangler d1 create 建数据库、wrangler r2 bucket create 建头像与文件桶,提取 database_id 回填 wrangler.jsonc。
  • 安装与迁移:安装依赖并执行本地数据库迁移。
  • 初始提交:提交 Initial commit from vite-flare-starter。

后续手动配置 Google OAuth(如使用)、替换 favicon、更新项目文档与 HTML 元信息,再通过本地开发服务器验证品牌与登录流程,最后设置生产密钥、执行远程迁移并完成部署。

适用边界与注意点

  • 若不需要从零手写纯自定义项目,可考虑更轻量的 cloudflare-worker-builder。
  • 本技能产出的是脚手架项目,具体功能仍需后续开发。
  • 首次部署后需要用实际 Worker URL 更新 BETTER_AUTH_URL,并将生产 URL 加入 Google OAuth 回调。
  • 需修改默认安全指纹(页面标题、UI 应用名、localStorage 键、API token 前缀 vfs_、GitHub 链接、worker 名、数据库名、R2 桶名等),避免被识别为使用模板。

使用场景

  • 接手新需求,需要快速得到一个可部署到 Cloudflare 的 React 全栈应用并保留鉴权与数据库
  • 要为团队搭建带 Google 登录的知识库应用,并完成 OAuth 回调与本地登录验证
  • 已有 Vite 模板但缺少统一品牌,需要重命名 worker、数据库、R2 桶并清理安全指纹
  • 准备把脚手架提交为独立仓库,需要重新 git init、写 .dev.vars 并生成初始提交

适合人员

  • 负责交付全栈产品、需要快速获得可部署 Cloudflare 脚手架的前端或全栈工程师
  • 熟悉 Workers、D1 和 R2,想省去项目初始化和绑定配置步骤的 Cloudflare 开发者
  • 用 AI 辅助从模板生成项目,需要明确流程和安全指纹处理的独立开发者
  • 为团队设计内部工具,需要 Google OAuth、数据库和文件桶都能快速跑通的架构师