用途:当用户要新建 XL1 项目时运行,按提示选择模板并生成项目骨架。若当前目录已有依赖 @xyo-network/* 的 package.json,或用户只是描述已有项目内的功能、bug、概念,则不适用;判断不清时问一句是新建还是增量开发。需求过于模糊时应先交给 xl1-build 做规划向导,再回到本技能。
主要能力:提供 4 类模板——react(默认,浏览器端 dApp)、xl1-service(Node + Express 的 HTTP 服务)、node(纯 Node CLI/脚本)、xl1-monorepo(pnpm 工作区根)、xl1-shared(前后端共享的 TypeScript 库,编译到 dist/)。默认推荐单仓流程(monorepo + shared + react + xl1-service),除非提示明确只读/纯浏览器。需要跨浏览器会话独立运行的逻辑(多角色协调、链数据索引、时间截止、通知或定时任务)时选单仓。
使用方式:单模板用 node "${CLAUDE_SKILL_DIR}/scripts/scaffold/scaffold-xl1-dapp.js" <root> --template=<react|node|xl1-service>;单仓先建根目录并加 --no-install,再按顺序为 shared、app、service 各跑一次并加 --workspace-member,最后在根目录执行 pnpm install。验证用 pnpm -r run typecheck && pnpm -r run lint && pnpm -r run build,xl1-service 另跑 pnpm --filter @<scope>/service run smoke。前后端约定 app 在 :3000、service 在 :3001,service 路由挂在 /api/*,由 Vite 开发代理转发,不要给 service 加 CORS,前端用相对路径请求。
适用场景与限制:单仓比单模板更全,不确定就默认单仓,后续删掉未用部分即可。若存在含助记词的 .env,应另写 Node 验证脚本,通过 GatewayBuilder.build(signer) 端到端跑通 happy path。关于版本号、收费、价格与官方支持范围,资料暂未提供。