SuperAPI AI 工具集

xl1-scaffold

编程与开发

查看项目

更新于 10-16 04:59

技能介绍

用途:仅在开始新的 XL1 项目时使用,用于搭建项目骨架。若在已有仓库中加功能、修 bug 或了解 XL1 概念,应改用下层技能(如 xl1-knowledge、xl1-patterns)。请求模糊或探索性时可先交给 xl1-build 运行规划向导生成 PRD。

主要能力与模板:提供 react(默认,浏览器 dApp)、xl1-service(基于 @xyo-network/xl1-sdk 的 Node + Express HTTP 服务)、node(纯 Node CLI/脚本,较少用)、xl1-monorepo(pnpm 工作区根)、xl1-shared(环境无关 TypeScript 库,编译到 dist/ 供 app 与 service 共享类型、Zod schema、常量)。默认采用 monorepo 流程,仅在明确只读/纯浏览器场景降为单 react 模板。monorepo 中 app 跑 :3000、service 跑 :3001,服务路由在 /api/,Vite 开发代理 /api/ 到 service,根目录 pnpm dev 同时启动两者;不要在 service 添加 CORS。前端请求用相对路径如 fetch('/api/foo')。

必要用法:单模板运行 node "${CLAUDE_SKILL_DIR}/scripts/scaffold/scaffold-xl1-dapp.js" <root> --template=<react|node|xl1-service>。monorepo 按顺序执行:先用 --template=xl1-monorepo --no-install 建根,再依次以 --workspace-member 建 packages/shared、packages/app、packages/service(shared 必须最先,后续包会自动接线 workspace:* 依赖),最后 cd <root> && pnpm install,并运行 pnpm -r run typecheck && pnpm -r run lint && pnpm -r run build;xl1-service 还可跑 pnpm --filter @<scope>/service run smoke。非工作区成员模式下,脚手架会解析依赖图、写入 package.json、tsconfig、eslint、vite 配置与源码,执行安装并跑构建与冒烟测试。

适用场景:需要跨时间多角色协作、链上数据索引、时间截止处理、通知或定时任务时选择 monorepo;若提示中已有 .env 种子短语,则需额外写 Node 验证脚本并通过 GatewayBuilder.buildRunner() 跑通主流程。

限制:资料中未提供具体依赖版本、收费与平台支持等细节;工作区内共享包新导出需重新构建。