SuperAPI AI 工具集

sails-new-app

编程与开发

查看项目

更新于 10-15 21:50

技能介绍

用途:面向新建标准 Gear/Vara Sails 应用的绿地场景,帮助开发者按正确顺序从需求范围推进到获批的 Sails 工作区路径,避免跳过后续实现所依赖的规划产物。

主要能力与流程:若机器尚未安装 rustup、所需 Wasm 目标、cargo-sails 和本地 gear 二进制,先执行 ../sails-dev-env/SKILL.md。新建标准 Sails/Vara 项目时,先用 cargo sails new <project-name> 引导工作区,除非用户明确需要非模板的自定义布局。随后使用 ../../assets/spec-template.md 将功能或应用目标写入 docs/plans/YYYY-MM-DD-<topic>-spec.md,并通过 ../sails-architecture/SKILL.md 处理架构决策。

工作区与构建:保持 cargo sails new <project-name> 生成的标准模板结构不变,包括 app、client、src、tests、顶层 build.rs、Wasm 输出和生成客户端路径;保持标准构建脚本流水线,使用仓库生成的构建路径产出 .idl 和 Rust 客户端产物。专用客户端 crate 优先使用 sails-rs 并启用 features = ["build"] 与 sails_rs::build_client::<Program>(),再考虑手动 sails-idl-gen / sails-client-gen 接线。

验证与前端:进入后续阶段前,先完成 ../sails-gtest/SKILL.md,再执行 ../sails-local-smoke/SKILL.md。需要前端时,用 create-vara-app 从程序的 .idl 脚手架生成:npx create-vara-app <name> --idl path/to/service.idl,然后转到 ../sails-frontend/SKILL.md 进行定制。

限制:坚持标准 Sails 脚手架与生成客户端;保持标准工作区形态及构建生成的 .idl 和 .opt.wasm 产物路径,添加临时生成步骤前先检查 crate 的 build.rs;已有 Sails 路径时不要跳入原始 Gear 原语;不要因仓库是绿地就跳过规划文档;绿地 Sails/Vara 工作始终使用 cargo sails new <project-name>,手工拼装工作区易出错,共享顶层工作区会导致 Cargo 特性统一,使 sails-rs 同时启用 gstd 和 gtest 而破坏构建。