用途:仅在用户新建 XL1 项目时使用;对已有仓库加功能、修 bug 或解释 XL1 概念应改用下层技能(如 xl1-knowledge、xl1-patterns)。触发语句类似“Build me a ___ on XL1”“Create a new XL1 dApp”“Scaffold an XL1 service that reads from the datalake”。若当前目录已有依赖 @xyo-network/* 的 package.json,则不激活。
主要能力:提供 react(默认,面向浏览器 dApp)、xl1-service(Node+Express 后端)、node(纯 Node CLI/脚本,较少用)、xl1-monorepo(pnpm 工作区根)、xl1-shared(app 与 service 共享的类型、Zod schema、常量库,编译到 dist/)模板。默认走 monorepo 流程(monorepo + shared + react + service),仅当需求明确只读、纯浏览器(如钱包余额看板)时降为单个 react 模板。
使用方式:单模板执行 node "${CLAUDE_SKILL_DIR}/scripts/scaffold/scaffold-xl1-dapp.js" <root> --template=<react|node|xl1-service>。monorepo 需四次调用:先根节点用 --template=xl1-monorepo --no-install,再依次生成 packages/shared、packages/app、packages/service(各加 --workspace-member,顺序须 shared 在前),最后在根目录执行 pnpm install,并以 pnpm -r run typecheck && pnpm -r run lint && pnpm -r run build 校验,xl1-service 另跑 pnpm --filter @<scope>/service run smoke。
约定与限制:monorepo 固定 app 在 :3000、service 在 :3001,服务路由置于 /api/,Vite 开发代理 /api/,根 pnpm dev 并行启动两者;不要给 service 加 CORS 中间件,前端用相对路径 fetch('/api/foo'),不用 VITE_API_URL。若提示词给出含助记词的 .env,须按 Headless dApp Verification 要求编写并运行基于 GatewayBuilder.build(signer) 的 Node 验证脚本,完成后走 dApp Definition of Done;并用 viewer.finalization.headNumber() 捕获 INDEXER_FLOOR_BLOCK(以及 VITE_INDEXER_FLOOR_BLOCK)写入 .env。其他细节(具体收费、平台支持等)暂未提供。