SuperAPI AI 工具集

scaffold

编程与开发

查看项目

更新于 10-15 20:28

技能介绍

用途:在 Cloudflare Workers 上引导创建全新的 Next.js 或 Astro 项目,采用统一的技术栈。仅适用于空目标目录,不能用于已有项目的改造。

可用脚手架:next-cloudflare 采用 Next.js 16(App Router),通过 OpenNext 部署到 Cloudflare Workers,集成 Drizzle + Neon、Better-Auth、shadcn/ui、Vitest + Playwright;astro-cloudflare 采用 Astro 6(以 SSG 为主、islands 架构),部署到 Cloudflare Workers,默认零 JS,使用 Content Collections 与 SEO 规则。两者共享 TypeScript strict、pnpm、Biome、Tailwind CSS 和 .node-version 22.12.0。若用户未指定或含糊,会展示表格并询问。

使用方式:先解析 {scaffold} 与 {project_name} 参数(别名 next-cf、astro-cf),未指定时询问或从 cwd 推导,project_dir 默认为 ..。然后运行 bash "$SKILL_DIR"/scripts/preflight.sh "{project_dir}" "{project_name}",检查 RESULT: 行,仅在 ok=true 时继续。按 references/setup-{scaffold}.md 执行安装,再应用共享覆盖层:bash "$SKILL_DIR"/scripts/overlay_templates.sh "{scaffold}" "{project_name}" "{project_dir}"。覆盖层写入 biome.json、AGENTS.md、CLAUDE.md、wrangler.jsonc 等配置,并合并 package.json;幂等,存在文件时跳过,除非加 --force。最后运行 bash "$SKILL_DIR"/scripts/verify_scaffold.sh "{project_dir}",执行 pnpm biome check --write . 和 pnpm typecheck,失败时展示前 60 行诊断,不标记完成;成功则报告创建的文件与后续步骤。

限制:目标目录必须为空(含点文件),否则硬性停止。使用 Biome 而非 ESLint/Prettier,使用 ES modules 与 pnpm。保留框架生成的 README.md,项目文档与 Git 初始化交给用户。astro-cloudflare 相关修改需参阅 references/astro-cloudflare-notes.md。