SuperAPI AI 工具集

xl1-build

编程与开发

查看项目

更新于 10-16 04:26

技能介绍

用途

xl1-build 是 XL1 dApp 开发的规划前端,用于把探索性的构建请求细化为具体的、可执行的规格(spec)。它是 xl1-scaffold 之前的规划环节,不与 scaffold 并行执行。本技能的交付物是一段精炼 prompt,而不是已搭建好的项目。

何时激活

当用户的请求处于探索、模糊或信息不足的状态时激活,例如「我想在 XL1 上做点东西」「帮我设计一个 dApp」「我可以用这个做什么」「在 XL1 上给我做个游戏」(未指明玩法形态)「我想在 XL1 上发行一个代币」(未确定铸造上限、转账规则等)或者用户显式调用 /xl1-build。

以下情况不激活:用户已指明 archetype、公平性/时序约束和 patterns(这已是具体规格,应直接交给 xl1-scaffold);用户在询问 XL1 的概念或 API 问题(属于 xl1-knowledge 或 xyo-knowledge);用户正在已有项目中工作(属于 xl1-patterns)。当触发条件模糊时,只问一个问题:「你想先一起规划 dApp 的形态,还是你已经有具体规格了?」

主要能力与工作流程

向导分四个阶段,使用 AskUserQuestion 进行提问,保持对话紧凑。

第一阶段 — 识别 archetype

用一轮 AskUserQuestion 询问 archetype 选项,根据提示挑选最合适的 3–4 个,不展示全部。可选 archetype 与其对应 patterns 包括:隐藏出拳的多方游戏(commit-reveal、chain-data-indexing-service、in-page-datalakes)、预测市场/下注(commit-reveal-prediction-markets)、原子交换/托管/互换(atomic-exchange)、同质化代币(fungible-tokens、inscription-substrate)、铭文/类 NFT/收藏品(inscription-substrate)、索引器/仪表盘/历史浏览器(chain-data-indexing-service、in-page-datalakes)、钱包工具/一次性交互,以及自定义/未列出。若用户措辞已点明 archetype,则直接跳到第二阶段。

第二阶段 — 细化所选 archetype 的细节

每个 archetype 有固定的追问集合,合并为一次 AskUserQuestion 调用(最多 4 个问题),已给出的答案则跳过。例如隐藏出拳游戏会问每轮玩家数、是否有押注、是否允许无钱包浏览历史、未揭示时的截止行为;预测市场会问结果裁定方、押注币种、是否可无钱包浏览;原子交换会问参与方数量、交换内容、授权方;同质化代币会问 ticker 注册方式、铸造策略、是否需要持有者/供应量仪表盘;铭文会问铭刻内容、是否可转让、是否需要画廊 UI;索引器会问索引对象、是否钱包门控、实时或轮询;钱包工具会问触发的链上动作、是否展示链上状态。自定义类型则请用户用 2–3 句话描述流程,再手动映射到 xl1-patterns 中的原语。

第三阶段 — 确认环境

最后一轮 AskUserQuestion,两个问题:网络目标(主网 / sequence / 本地 devnet)和是否需要无头验证(是则提供 .env 种子短语和 Node 验证脚本 / 否,仅浏览器)。无头验证是一个信号,让 xl1-scaffold 接好 GatewayBuilder.buildRunner() 并在报告完成前运行脚本。用户回答「是」时,还会询问哪些账户持有资金,以便分配多方角色。

第四阶段 — 合成精炼 prompt 并交接

按固定格式生成一段 prompt 展示给用户确认,包含 Shape、Network、Patterns、Multi-party、History/browse、Backend、Headless verification、Skills、Version、Notes 等字段。用户确认或修改后,生成项目特定的验收标准(5–10 条可观察的条目,分为正向与负向断言),并把 PRD 写入 cwd 下的 PRD.md。若 PRD.md 已存在,会询问是覆盖还是另存为 PRD-<YYYY-MM-DD-HHMM>.md,不会静默覆盖。PRD 文件包含构建目标、验收标准(第一层通用 DoD、第二层领域 DoD、第三层项目特定标准)、引用的技能、插件版本和备注等。写入后显式交接给 xl1-scaffold。

适用场景

适合需求尚不明确、需要把想法梳理成具体规格的 XL1 dApp 构建场景,尤其是当用户只给出宽泛方向时。它能帮助把探索性请求转化为结构化、可检查的规格。

限制

该向导不负责搭建项目(由 scaffold 完成),不实现功能(scaffold 后遵循 xl1-patterns),不回答概念问题(转交 xyo-knowledge / xl1-knowledge),也不在已有项目上重新运行(如需为已搭建的 dApp 添加内容,入口是 xl1-patterns)。不要向用户提出超出表中所列的追问,不要自由发挥精炼 prompt 的格式,也不要跳过用户确认步骤。具体版本号、分页与更多实现细节以官方资料为准;部分细节暂未提供。