SuperAPI AI 工具集

stack

编程与开发

查看项目

更新于 11-03 20:58

技能介绍

用途:该技能面向新建 Web 仓库,提供一套标准化的脚手架流程,同时要求保留现有文件和既有项目决策,避免覆盖原项目内容。

默认技术栈:TanStack Start 前端、Hono 后端运行于 Workers、oRPC 接口层、Drizzle 配合 D1 数据库、Better Auth 认证、evlog 与 Vite+ 附加组件、alchemy 部署相关配置。脚手架依赖 Bun 1.4.2、Git 和包注册表访问;AEP CLI 本身独立于 Node 和 Bun。

使用方式:先确定产品名(小写字母、数字和连字符)与用途,在临时目录中执行 pinned 的 create-better-t-stack 命令生成项目,再将生成文件合并到目标仓库,保留其许可证与已有内容,同时合并忽略规则并保留 bts.jsonc。随后在目标仓库运行 aep init,并在既有规则索引中记录项目特有的 CI、环境与发布选择。

接着读取 aep --skill stack --ref files,按顺序应用其中的 Write、Merge into 和 Append to 块,替换 PROJECT 与产品用途,这些内容提供 Vite+ 工作区检查、任务缓存、Git 钩子、测试、CI、本地环境处理与受保护的部署流程,并需遵循固定的 alchemy 与 Effect overrides。

验证步骤:运行 bun install、bun run format、bun run db:generate,保留 bun.lock 与生成的数据库迁移;读取 aep --skill stack --ref checks,通过 aep config update 配置五项检查;再运行 bun install --frozen-lockfile、aep check、bun run check、bun run test 和 bun run build,重复 check/build 以观察缓存命中;启动 bun run dev,走通落地页、注册、登录与仪表盘后停止进程组;确认普通 deploy/destroy 命令被拒绝,而显式项目 profile 加 stage 通过 --guard-only。

适用场景:新 Web 仓库初始化、需要统一检查与 CI 配置的团队项目、以及希望在本地完成完整验证后再进入授权部署流程的场景。

限制:该流程只做本地验证,部署需要单独的授权范围;本地运行使用项目本地状态与占位供应商凭据,部署守卫要求显式 stage 与项目 profile;即使生成器已固定版本,注册表模板仍可能变化,因此应保留生成的锁文件并在更新固定版本前重跑冒烟测试。